Rubrique précédente: ExempleRubrique suivante: resume—Reprise d'une distribution interrompue


renewjob—Renouvellement d'un job

La commande renewjob renouvelle un job échoué et n'est valide que lorsqu'elle est émise à partir du gestionnaire de domaines.

Cette commande a le format suivant :

renewjob  
item=nom_élément  
version=nom_version 
procedure=nom_procédure 
installedwith=nom_procédure_installation 
task={install | activate | configure | uninstall}
[deliverytime="aaaa-mm-jj hh:mm" ]
[calendarname=calendrier_exclusion_livraisons]
[attime="aaaa-mm-jj hh:mm"]
[timeout=heures]
[runAtShutdown[={y|n}]]
[userJobMessage]
[userMessage]

ou

renewjob 
cname=[nom]
[item=nom_élément  
version=nom_version 
procedure=nom_procédure ]
[deliverytime="aaaa-mm-jj hh:mm" ]
[attime="aaaa-mm-jj hh:mm"]
[calendarname=calendrier_exclusion_livraisons]
[timeout=heures]
[runAtShutdown[={y|n}]]
[userJobMessage]
[userMessage]
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 qui précise les périodes d'exclusion pour les livraisons.

cname

Spécifie le nom unique facultatif de conteneur de job contenant les jobs à renouveler.

Si cnam apparaît dans le scriptes, les paramètres item, version et procedure sont facultatifs :

Si ces derniers apparaissent, seuls les job du conteneur, identifiés par ces paramètres, son renouvelés.

S'ils n'apparaissent pas dans le script, tous les jobs du conteneur spécifié pouvant être renouvelés le seront.

Si cname n'apparaît pas dans le script, le job à renouveler est le premier job renouvelable détecté comme répondant aux spécifications des paramètres item, version, installedWith, procedure et task.

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.

installedWith

Spécifie le nom de la procédure d'installation.

Le job à renouveler a été installé avec cette procédure.

Si cname apparaît dans le script, le paramètre ne sera pas pris en compte.

élément

Spécifie le nom de l'élément. Le job à renouveler est lié à cet élément.

procédure

Spécifie le nom d'une procédure. Le job à renouveler est lié à cette procédure.

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.

tâche

Spécifie le type de tâche que la procédure d'élément doit effectuer..

La procédure à récupérer est liée à une procédure de ce type de tâche.

install

Un procédure d'installation.

configurer

Un procédure de configuration.

activer

Un procédure d'activation.

désinstallation

Un procédure de désinstallation.

Si cname apparaît dans le script, le paramètre ne sera pas pris en compte.

temporisation

Spécifie le timeout spécifie le délai d'expiration pour un job au format “h”, h représentant 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é.
timeout ne doit pas être codé avec le paramètre d'expiration du délai du job (JobTimeout), sinon une erreur est renvoyée. Si aucun paramètre n'est codé, la valeur par défaut est 168.

version

Spécifie le version de l'élément dont l'enregistrement est annulé.

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 : Le premier job dont l'état est Erreur dans la liste de jobs, qui correspond aux paramètres item, version, procedure et installedWith sera sélectionné pour l'opération de renouvellement, qui utilise la procédure spécifiée par le paramètre de procédure.

Remarque : Dans la variante cname de la commande, les blocs de paramètre item, version et procedure sont facultatifs. S'ils n'apparaissent pas dans le script, tous les jobs du conteneur pouvant être renouvelés le seront.