Manuel des Scripts Automation Engine > Organisation fonctionnelle > Activation d'objets > RESTART_UC_OBJECT

RESTART_UC_OBJECT

Fonction de script : Répète l'exécution d'une tâche.

Syntaxe

RESTART_UC_OBJECT (Object Name, Reference RunID, [Restart Point], [Flags], [Queue])

Syntaxe	Description / format
Nom d'objet	Nom de l'objet. Format : littéral de script, variable de script ou fonction de script
RunID de référence	RunID auquel la reprise fait référence ou mot-clé LAST pour indiquer la dernière exécution de la tâche. Format : littéral de script, nombre, variable de script ou fonction de script Vous ne pouvez pas reprendre une tâche qui a déjà été reprise car les traces deviendraient très complexes. Le RunID doit donc faire référence à une exécution initiale. Si vous indiquez le mot-clé LAST, la dernière exécution initiale est utilisée.
Point de reprise	Emplacement du script à partir duquel le traitement doit être répété. Format : nom AE, littéral de script, nombre, variable de script Ce paramètre ne peut être utilisé que si vous avez défini des points de reprise à l'aide de :RESTART dans le script de la tâche qui doit être répétée. Si vous ne le remplissez pas, l'ensemble du script est exécuté.
Indicateurs	Instructions pour l'exécution de la tâche. Format : littéral de script ou variable de script Valeurs autorisées : "GEN_JCL" = Sortie du JCL dans le rapport d'activation. "ORIGINAL_SCRIPT" = Sortie du script d'origine dans le rapport d'activation. "VAR_MOD" = Sortie de la modification de Variables dans le rapport d'activation. "ATT_MOD" = Sortie de la modification d'Attributs dans le rapport d'activation. "ATT_DIALOG" = Activation de la fenêtre de dialogue des attributs. "MAN_RELEASE" = Attente de la libération manuelle. "KEEP_STARTTYPE" = Conservation du type de démarrage. "ONLY_ABENDED" : répétition uniquement des tâches subordonnées interrompues. Plusieurs indicateurs peuvent être entrés, séparés par des virgules. L'expression complète doit être écrite entre guillemets si ces indicateurs sont nommés et que vous n'utilisez pas de variable de script. Les valeurs autorisées correspondent aux options qui sont disponibles dans le dialogue "Exécuter..." en cas de reprise manuelle.
Queue	Indication d'un objet queue donné qui doit être utilisée pour le redémarrage de la tâche. Si aucune queue n'est indiquée, la tâche est activée automatiquement dans la queue du client (CLIENT_QUEUE).

Code retour
"0" : reprise réussie de la tâche. "20628" - L'objet n'existe pas. "7014" - La référence RunID n'existe pas. "20346" - Le point de reprise n'existe pas. "20380" : l'élément de script :EXIT a terminé le traitement du script lors de l'exécution reprise. "20385" - L'objet est un schedule. "7015" - La reprise d'une exécution de reprise n'est pas autorisée.

Commentaires

Cette fonction de script peut être utilisée pour redémarrer les tâches qui ont déjà été exécutées.

Une tâche peut se répéter si la fonction de script est appelée dans un post-traitement. Cela peut créer une boucle.

Notez que le choix de l'une des quatre options de test comme indicateurs ("GEN_JCL", "ORIGINAL_SCRIPT", "VAR_MOD" ou "ATT_MOD") entraîne l'interruption du job avec :STOP. Ceci est dû au fait que la valeur par défaut ''N'' (=No) est utilisée comme réponse à la question ''Voulez-vous démarrer ce job ?''.

Pour réussir l'exécution d'une reprise avec une ou les quatre options de test définies comme indicateurs, veuillez utiliser l'interface utilisateur tel que décrit dans la section ''Exécuter avec options''.

Le RunID de la tâche, dont l'exécution doit être répétée, est transmis à la fonction de script au moyen du paramètre RunID de référence. Vous pouvez également utiliser le mot-clé LAST pour redémarrer la dernière exécution d'une tâche.

Vous pouvez éventuellement désigner un point de reprise à prendre en compte en cas de nouvelle exécution de la tâche. La tâche débute, mais le traitement du script commence uniquement à l'emplacement du point de reprise. Egalement facultatifs, les indicateurs influencent l'exécution de la tâche.

L'instruction de script :ON_ERROR permet de définir la réaction en cas d'erreur. Elles peuvent être analysées à l'aide des fonctions de script pour le traitement des erreurs. Le traitement du script se poursuit mais vous pouvez l'interrompre si nécessaire.

Cet élément de script permet d'écrire les transactions ouvertes dans la base de données AE.

Exemples

Dans l'exemple, la dernière exécution d'un Job doit être répétée. Le JCL généré et les modifications apportées aux variables sont affichés dans le protocole d'activation. Le job attend dans la fenêtre des activités d'être libéré manuellement.

:SET &RET# = RESTART_UC_OBJECT ("JOBS.SYSTEM.CHECK",LAST,,"GEN_JCL,VAR_MOD,MAN_RELEASE")

Rubriques connexes :

Elément de script	Description
:GENERATE	Contrôle le traitement des lignes de script pendant l'exécution du script.
:ON_ERROR	Détermine la réaction à certaines erreurs ou messages d'éléments de script.
:RESTART	Définit des points de reprise dans un objet activable.
SYS_ACT_RESTART	Récupère si une tâche a été activée en mode reprise.
SYS_ACT_RESTART_ME_NR	Renvoie le numéro d'exécution (RunID) d'un objet activé en mode de reprise.
SYS_LAST_RESTART_POINT	Fournit le nom du point de reprise précédent dans le script.
SYS_LAST_RESTART_TEXT	Indique le texte du point de reprise précédent dans le script.
SYS_RESTART_POINT	Indique le point de reprise utilisé pour l'exécution de l'objet.

Eléments de script - Activation d'objets

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle