Rubrique précédente: ExempleRubrique suivante: Exemple


modfiyJob—Modification d'un job

Cette commande permet de modifier un job dans le conteneur de jobs spécifié. Vous devez desceller le conteneur de jobs.

Les paramètres sont associés aux options des jobs. Si un paramètre n'est pas codé, l'option qui lui est associée demeure inchangée. Pour éviter qu'une erreur se produise, codez le paramètre "stagingServer" avec des tâches d'installation.

Cette commande a le format suivant :

jobcontainer action=modification_job
name=nom_conteneur_jobs
jobName=nom_job [newJobName=nouveau_nom_job]
[deliveryTime="AAAA-MM-JJ hh:mm"] 
[atTime="AAAA-MM-JJ hh:mm"]
[after={exacttime|boottime}] 
[calendarname=calendrier_livraison]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]] 
[prompt=jours.heures] 
[offline[={y|n}]] 
[runAtShutdown[={y|n}]] 
[preventLogon[={y|n}]] 
[globalTime[={y|n}]] 
[nocalendar[={y|n}]]
[resolveQuery[={y|n}]] 
[stagingServer[={y|n}]] 
[parameters=paramètres_utilisateur]
[jobTimeout=j.h]
[reinstall[={y|n}]]
[userJobMessage]
après

Heure de début de la procédure sur le système cible.

Les valeurs suivantes sont autorisées :

exacttime

La procédure démarre immédiatement après avoir atteint la valeur atTime.

boottime

Le démarrage de la procédure est repoussé jusqu'à la première transmission de redémarrage après atTime.

allowCancel

Si allowCancel ou allowCancel =y est codé, l'utilisateur est invité à annuler l'exécution du job.
Si allowCancel =n est codé, l'utilisateur est refusé.

Ce paramètre doit être codé uniquement si promptUser est déjà activé ou s'il sera activé avec cet appel, sinon ce paramètre est ignoré. Aucun avertissement n'est donné.

atTime

Spécifie le Spécifie la date et l'heure à laquelle l'action doit démarrer.

La date est au format ISO AAAA-MM-JJ hh:mm.

calendarname

Spécifie le nom du calendrier contrôlant l'heure d'exécution de l'évaluation.

deliverytime

Spécifie le heure de démarrage de la livraison à partir du gestionnaire de domaines.
La date est au format ISO AAAA-MM-JJ hh:mm.

execTimedOut

Si execTimedOut ou execTimedOut=y est codé, l'exécution du job est automatiquement lancée à l'expiration de l'invite utilisateur.
Si execTimedOut=n, le job n'est pas démarré automatiquement.

Ce paramètre doit être codé uniquement si promptUser est déjà activé ou s'il sera activé avec cet appel, sinon ce paramètre est ignoré. Aucun avertissement n'est donné.

globalTime

Si globalTime ou globalTime=y est défini, les spécifications relatives à l'heure se basent sur l'heure du gestionnaire d'entreprise.

Si globalTime=n est utilisé, elles sont basées sur l'heure du gestionnaire de domaines.

jobName

Spécifie le nom du job à modifier.

jobTimeout

Spécifie le jobTimeout spécifie le délai d'expiration pour un job au format “d.h”, d représentant le nombre de jours et h le nombre d'heures. La plage de paramètres est configurable sur le site du gestionnaire. Lorsque la valeur spécifiée dépasse la limite supérieure configurée, la limite supérieure est prise en considération pour la valeur, lorsque cette dernière est inférieure au seuil spécifié, c'est le seul qui est pris en compte pour cette valeur. Aucun avertissement n'est donné.
jobTimeout ne doit pas être codé avec le paramètre d'expiration du délai, sinon une erreur est renvoyée. Si aucun paramètre n'est codé, la valeur par défaut est 7.0.

nom

Spécifie le nom du conteneur de jobs auquel le job à modifier appartient.

newJobName

Spécifie le nouveau nom de job.

noCalendar]

Si noCalendar apparaît dans le script, un éventuel calendrier situé sur l'ordinateur cible est ignoré pour l'exécution de ce job.

hors ligne

Si offline ou offline=y est codé, la connexion entre l'ordinateur cible et le serveur est désactivée pendant l'exécution du job et rétablie ensuite.
En revanche, si offline =n est codé, la connexion n'est pas libérée.

paramètres

Spécifie le paramètres utilisateur de la procédure.
Plusieurs paramètres utilisateur doivent être séparés par un espace au sein de guillemets doubles.
Si une chaîne vide est codée, aucun paramètre par défaut n'est utilisé.

postaction

Spécifie les actions nécessaires qui doivent être entreprises une fois la procédure spécifiée terminée. Les valeurs suivantes sont autorisées :

none

N'effectue aucune action ultérieure.

reboot

Redémarre le système une fois la procédure terminée.

logoff

Déconnecte l'utilisateur une fois la procédure terminée.

rebootAtEnd

Redémarre le système une fois tous les jobs de ce conteneur terminés.

logoffAtEnd

Déconnecte l'utilisateur une fois tous les jobs de ce conteneur terminés.

shutdownAtEnd

Arrête l'ordinateur cible une fois les jobs achevés.

preaction

Spécifie que des actions nécessaires doivent être entreprises avant le début de la procédure spécifiée. Les valeurs suivantes sont autorisées :

none

N'effectue aucune action antérieure.

reboot

Redémarre le système avant le début de la procédure.

logoff

Déconnecte l'utilisateur avant le début de la procédure.

preventLogon

Si PreventLogon ou PreventLogon=y apparaît dans le script, la connexion utilisateur est refusée pendant toute l'exécution du job. Si un utilisateur est déjà connecté, l'exécution du job est suspendue jusqu'à la déconnexion de l'utilisateur.
En revanche, si preventLogon =n est codé, la connexion de l'utilisateur n'est pas rejetée.

prompt=d.h

Spécifie le délai pendant lequel l'utilisateur est invité à lancer le job.

Le format de la période est j.h, j désignant le jour et h les heures.

La plage des valeurs valides de ce paramètre est comprise entre trois heures et sept jours (de 0,3 à 7). Si la valeur spécifiée se situe au-dessous de la valeur minimale, la valeur est remplacée par la valeur minimale. Si la valeur spécifiée excède la valeur maximale, la valeur est remplacée par la valeur maximale. Aucun avertissement n'est donné.

Ce paramètre doit être codé uniquement si promptUser est déjà activé ou s'il sera activé avec cet appel, sinon ce paramètre est ignoré. Aucun avertissement n'est donné.

promptUser

Si promptUser ou promptUser=y apparaît dans le script, l'utilisateur est invité à exécuter le job.

En revanche, si promptUser=n est spécifié, aucune invite n'apparaît.

réinstaller

L'option reinstall est facultative et ne possède pas de valeur par défaut.

S'ils ne sont pas codés, les paramètres reinstall des jobs sollicités ne sont pas modifiés, sinon ils sont modifiés en fonction du codage

Remarque : Cette option s'applique uniquement à l'installation de jobs. Dans tout autre cas, elle est ignorée.

resolveQuery

Evalue un groupe de requête susceptible d'être associé avant la génération du job.

runAtShutdown

Si runAtShutdown ou runAtShutdown=y est codé, l'exécution du job commence à l'arrêt uniquement.
Si runAtShutdown=n est codé, le job démarre à n'importe quelle autre heure également.
Si le paramètre n'apparaît pas dans le script, la valeur utilisée par défaut est la valeur de l'option du job de procédure associé.
Ce paramètre est destiné aux cibles Unix uniquement.

stagingServer

Livre également le produit associé aux bibliothèques de transfert des serveurs de modularité des ordinateurs cibles.

Ce paramètre s'applique uniquement aux procédures auxquelles est associé le type de tâche Installe.

Ce paramètre doit uniquement être codé avec les procédures auxquelles est associé le type de tâche install. Sinon, une erreur sera signalée.

userJobMessage

Permet de modifier le message d'administration personnalisé pour un job d'un conteneur de jobs.