Rubrique précédente: ExempleRubrique suivante: Exemple


renewJob—Renouvellement d'un job

Cette commande renouvelle un job ayant échoué dans le conteneur de jobs spécifié. Les options du job renouvelé sont modifiées en fonction des paramètres et des valeurs codées. Les options appartenant aux paramètres non utilisés demeurent identiques.

Cette action a le format suivant :

jobcontainer action=renewJob 
name=nom_conteneur_jobs
jobName=nom_job
[newName=nouveau_nom_conteneur] 
[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}]] 
[parameters=paramètres_utilisateur]
[jobTimeout=j.h]
[userJobMessage]
[userMessage]
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.

Si ce paramètre n'apparaît pas dans le script, la date et l'heure courantes sont utilisées.

calendarname

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

deliveryname

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.

Si ce paramètre n'apparaît pas dans le script, la date et l'heure courantes sont utilisées.

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 à renouveler

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 dont un job ayant échoué est renouvelé.

newJobName

Spécifie le nouveau nom de job. Si ce paramètre n'apparaît pas dans le script, le nom du job à renouveler est utilisé.

newName

Spécifie le nouveau nom du conteneur de jobs qui contiendra le job renouvelé. Si ce paramètre n'apparaît pas dans le script, un nom de conteneur par défaut sous la forme

<nom job> [<horodateur>] 

est généré.

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.

Si le paramètre n'est pas codé, la valeur utilisée par défaut est la valeur de l'option de job de procédure associée.

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.

Si le paramètre n'est pas codé, la valeur utilisée par défaut est la valeur de l'option de job de procédure associée.

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.

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é.

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.

userJobMessage

Spécifie le message d'administration personnalisé pour un job renouvelé dans un conteneur de jobs.

userMessage

Spécifie le message d'administration personnalisé pour un conteneur de jobs.

Remarque : Vous pouvez uniquement renouveler individuellement les jobs d'un conteneur de type noLinkage. Pour tout autre type de conteneur de jobs, seul le renouvellement du conteneur est possible.