:ATTACH_SYNC

Utilisez l'instruction de script :ATTACH_SYNC pour relier un objet Sync à une tâche déjà activée. Cette instruction de script affecte l'objet Sync temporairement, uniquement pour l'exécution actuelle.

Important ! :ATTACH_SYNC n'affecte pas les objets Script. Les objets Script sont complets après leur génération et le processus de synchronisation a lieu ultérieurement.

Affecter un objet Sync à la tâche actuelle

Pour affecter l'objet Synchronisation à la tâche actuelle, supprimez le RunID des paramètres ou spécifiez le RunID de la tâche actuelle.

Pour plus d'informations :

• Générer à l'activation ou à l’exécution
• Sync (SYNC)
• Page Sync

Affecter un objet Sync à une autre tâche

Spécifiez le RunID en tant que paramètre de :ATTACH_SYNC pour affecter l'objet Sync à une tâche différente de celle contenant le script.

Important ! N'affectez un objet Sync à une autre tâche déjà activée que si son statut est l'un des suivants :

• La tâche n'a pas encore démarré (code retour système < 1540)
• La tâche est en condition d'attente (code retour système entre 1600 et 1700)

En présence de n'importe quel autre statut, le système envoie une erreur d'exécution et le script est interrompu.

Affecter un objet Sync à un successeur direct du workflow

Pour affecter l'objet Sync à la tâche suivante du workflow et influencer la poursuite du traitement, utilisez le paramètre NEXT_OBJECT.

Remarques :

• Lorsque vous utilisez :ATTACH_SYNC pour affecter un objet Sync à un successeur, il ne doit pas y en avoir plusieurs.
• L'option Générer à l'exécution doit être activée dans la tâche contenant l'instruction de script.
• La tâche doit être déjà activée et avoir son propre RunID.

Syntaxe

:ATTACH_SYNC [Object type,] [RunID], Sync object, [Start action], [Abend action], [End action], Other, [NEXT_OBJECT]

Paramètres

• :ATTACH_SYNC
  Joint un objet Sync à une tâche activée

• Object type
  (Optionnel) Désignation abrégée du type d'objet exécutable Sync auquel l'objet Synchronisation sera joint
  Remarque : L'objet peut être identifié par le seul RunID.

• RunID
  (Optionnel) RunID de la tâche auquel l'objet Synchronisation sera joint
  Format : littéral de script, variable de script ou nombre
  Remarques :

  • Sans RunID, l'objet Sync est joint à l'objet actuel.
  • Ecrivez la virgule, même si vous ne spécifiez pas de RunID.

• Sync object
  Nom de l'objet Sync avec lequel synchroniser la tâche
  Format : littéral de script ou variable de script

• Start action
  (Optionnel) Action à entreprendre au démarrage de la tâche
  Format : littéral de script ou variable de script

• Abend action
  (Optionnel) Action à entreprendre lorsque la tâche se termine anormalement
  Format : littéral de script ou variable de script

• End action
  (Optionnel) Action à entreprendre lorsque la tâche se termine
  Format : littéral de script ou variable de script

• Other
  Action à entreprendre si l'action de début ne peut pas être traitée
  Format : littéral de script ou variable de script
  Valeurs autorisées :

  • A
    Fin anormale (interrompre)
  • W
    Attendre
  • S
    Ignorer

• NEXT_OBJECT
  (Optionnel) Affecte un objet Sync au successeur direct du workflow
  Format : littéral de script ou variable de script

Remarque : Les actions Start, End et Abend sont définies dans l'objet Sync. Pour plus d'informations, voir Sync (SYNC).

Exemples

Le script suivant ajoute un objet Sync (SYSTEM_0001_EXCLUSIVE_SYNC) à un job nommé ARCHIVE01. Si l'action de démarrage ne peut pas être exécutée, le job se termine anormalement.

:SET &RUNNR# = GET_UC_OBJECT_NR(ARCHIVE01)
:ATTACH_SYNC &RUNNR#,"SYSTEM_0001_EXCLUSIVE_SYNC","USE","RELEASE","RELEASE","A"

Dans l'exemple suivant, l'objet Sync est affecté à la tâche juste après dans le workflow.

:ATTACH_SYNC ,"SYSTEM_0001_EXCLUSIVE.SYNC","USE","RELEASE","RELEASE","A","NEXT_OBJECT"

Voir aussi :