RESTART_UC_OBJECT

La fonction de script RESTART_UC_OBJECT vous permet de répéter l'exécution d'une tâche. Cette fonction reprend une tâche déjà exécutée. Vous pouvez également spécifier des points de reprise et définir des indicateurs pour donner des instructions d'exécution de la tâche.

Remarque : Cette instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.

Important : Si vous utilisez cette fonction de script dans la page Post-traitement, une tâche peut se répéter et engendrer une boucle infinie.

Syntaxe

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

Paramètres

• RESTART_UC_OBJECT
  Répète l'exécution d'une tâche

• Object Name
  Nom de la tâche à répéter

• Reference RUN#
  RunID de l'exécution à répéter
  Format : Littéral de script, nombre, variable de script ou fonction de script
  Utilisez le mot-clé LAST pour répéter la dernière exécution de l'objet.
  Remarque : Étant donné qu'il est impossible de reprendre une tâche déjà reprise, le RunID doit donc faire référence à une exécution initiale et non à une reprise.

• Restart Point
  (Optionnel) Point de reprise de l'exécution dans le script
  Format : nom AE, littéral de script, nombre ou variable de script
  Remarque : Vous ne pouvez spécifier ce paramètre que si vous avez défini des points de reprise dans le script. Pour plus d'informations, voir :RESTART. Si vous ne spécifiez pas de point de reprise, c'est tout le script qui est utilisé.

• Flags
  (Optionnel) Instructions d'exécution séparées par une virgule
  Les indicateurs correspondent aux options de test lors d'une reprise de tâche manuelle. Pour plus d'informations, voir Redémarrer des tâches.
  Format : Littéral de script ou variable de script
  Remarques :

  • Vous pouvez inclure plusieurs indicateurs.
  • Si vous nommez les indicateurs sans utiliser de variables de script, écrivez le terme entier entre apostrophes.
  Valeurs autorisées :
  • GEN_JCL
    Affiche le JCL généré dans le rapport d'activation
  • ORIGINAL_SCRIPT
    Affiche le script d'origine dans le rapport d'activation
  • VAR_MOD
    Affiche la modification des variables dans le rapport d'activation
  • ATT_MOD
    Affiche la modification des attributs dans le rapport d'activation
  • ATT_DIALOG
    Active la fenêtre de dialogue des attributs
  • MAN_RELEASE
    Attend la libération manuelle de la perspective Surveillance des processus
  • KEEP_STARTTYPE
    Conserve le type de démarrage d'origine
  • ONLY_ABENDED
    Reprend uniquement les tâches enfants interrompues

• Queue
  Spécifie un objet Queue à utiliser lors de la reprise de la tâche
  Si l'objet Queue n'est pas spécifié, la tâche est exécutée dans la queue définie dans l'objet.

Codes retour

Cette fonction de script a les codes retour suivants :

• 0
  Reprise réussie
• 7014
  Le RunID de référence n'existe pas
• 7015
  Reprise d'une exécution déjà reprise impossible
• 20346
  Le point de reprise n'existe pas
• 20380
  Traitement du script terminé avec une instruction :EXIT dans l'exécution reprise
• 20385
  Cet objet se trouve dans un objet Schedule
• 20628
  L'objet n'existe pas

Conseil : Utilisez l'instruction de script :ON_ERROR pour définir l'action à entreprendre en cas d'erreur. Pour plus d'informations, voir Traitement des erreurs dans les scripts.

Exemple

L'exemple suivant illustre la reprise de la dernière exécution d'un job (JOBS.SYSTEM.CHECK). La fonction de script inclut les paramètres de sortie du JCL généré et des variables modifiées dans le rapport d'activation. Le dernier paramètre demande au job d'attendre dans la perspective Surveillance des processus jusqu'à ce que vous l'activiez manuellement.

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

Voir aussi :