|
:ADD_COMMENT |
Lecture ou modification d'objets |
:DELETE_VAR |
|
| Instruction de script : Attribue un objet Sync à une Tâche. |
:ATTACH_SYNC [type d'objet,] [RunID], Objet Sync, [action du début], [action sur interruption], [action de fin], Sinon, [NEXT_OBJECT]
|
Elément de syntaxe |
Description/format |
|---|---|
|
Type d'objet |
Description courte d'un objet activable |
|
RunID |
Numéro courant (RunID) de l'objet. |
|
Objet Sync |
Nom d'un objet Sync avec lequel la Tâche doit être synchronisée. |
|
Action de début |
Action qui doit être exécutée au début de la Tâche. |
|
Action sur interruption |
Action qui doit être exécutée à l'interruption de la Tâche. |
|
Action de fin |
Action qui doit être exécutée à la fin de la Tâche. |
|
Sinon |
Traitement des Tâches, lorsque soit l'action de début, l'action d'interruption ou la Tâche de fin doivent être exécutées. Format : Littéral de script ou Variable de script Valeurs autorisées : "A", "W" ou "S" "A" - Interrompre (Abend) |
|
NEXT_OBJECT |
L'objet Sync doit être attribué au successeur direct dans un Workflow. Format : Littéral de script ou Variable de script |
L'instruction de script permet d'ajouter un objet Sync à une Tâche déjà activée. L'attribution est temporaire, c'est-à-dire uniquement pour la durée de son exécution. Type d'objet est un paramètre facultatif, car le type d'objet peut être attribué de manière univoque par le numéro courant (RunID).
L'instruction de script peut également être utilisée afin par exemple d'attribuer un Sync à une des Tâches suivantes dans le Workflow et d'influencer ainsi le traitement suivant. Pour la Tâche, dont le script contient l'instruction de script, l'option doit être définie sur Générer à l'Exécution. La Tâche suivante, qui doit être attribuée par un Sync, doit déjà être activée et posséder ainsi un RunID. Elle ne doit donc pas avoir été définie sur Générer à l'Exécution. Le paramètre NEXT_OBJECT permet d'attribuer un Sync au successeur direct d'une Tâche dans un Workflow. Cependant, la limitation prévoit qu'il n'est possible qu'un seul successeur existe.
L'instruction de script permet également d'attribuer un Sync à chaque Tâche. Les conditions Sync pourraient ainsi par exemple être composées de manière variable. Le paramètre RunID ne doit pas être donné ici. Il faut cependant définir une virgule pour ces paramètres qui ne sont pas utilisés. L'option Générer à l'Exécution ne doit pas être activée dans ce cas. La vérification des objets Sync est déjà terminée lors de l'exécution du script.
Le script n'a aucun effet sur les objets script. Ces objets sont déjà terminés avec la génération, la synchronisation s'effectue cependant après.
Si un Sync est attribué à une autre Tâche déjà activée, cela n'est généralement possible que pour des statuts spécifiques. La Tâche doit, soit ne pas encore être démarrée (code retour système < 1540), soit elle se trouve en statut d'attente (code retour système entre 1600 et 1700). Si la Tâche a un statut différent, une erreur de durée d'exécution se produit et le script s'interrompt.
Dans le premier exemple, l'objet Sync "SYSTEM_0001_EXCLUSIVE_SYNC" est ajouté au Job "ARCHIV01". Si les actions correspondantes ne peuvent pas être effectuées, le Job est interrompu.
:SET &RUNID# = GET_UC_OBJECT_NR(ARCHIV01)
:ATTACH_SYNC &RUNID#,"SYSTEM_0001_EXCLUSIVE_SYNC","USE","RELEASE","RELEASE","A"
Dans le deuxième exemple, l'objet Sync de la Tâche suivante est affecté au Workflow.
:ATTACH_SYNC ,"SYSTEM_0001_EXCLUSIVE.SYNC","USE","RELEASE","RELEASE","A","NEXT_OBJECT"
Rubriques connexes :
| Elément de script | Description |
|---|---|
| SET_SYNC | Exécute l'action définie d'un objet Sync. |
| GET_SYNC | Demande le statut ou la valeur actuelle d'un objet Sync. |
Elément de script - Lecture ou modification d'objets
Sync
Codes retour système des objets activables
Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle