SYS_ACT_PARENT_NR

Fonction de script : Renvoie le numéro d'exécution (RunID) de la tâche supérieure.

Syntaxe

SYS_ACT_PARENT_NR ([Activation type])

Syntaxe	Description / format
Activation type	Valeurs autorisées : ACT : activateur PRC : processeur (valeur par défaut)

Codes retour
RunID de la tâche supérieure. ID de session en cas d'activation manuelle (uniquement pour le type d'activation ACT) " " : Il n'existe pas de tâche supérieure (uniquement pour le type d'activation PRC).

Cette fonction de script fournit le numéro d'exécution (RunID) de la tâche supérieure (parent). Dans le cas d'une activation manuelle, il s'agit de la Dernière session* de l'utilisateur.

Si le type d'activation n'est pas indiqué, cette fonction de script fournit le processeur.

Pour récupérer le nom d'un groupe, l'option "Générer à l'exécution" (onglet Attributs) doit être activé dans la tâche qui utilise la fonction de script. Sinon, le nom ne peut être récupéré que pour les jobs en post-traitement.

Exemples

Le premier exemple vérifie si la tâche est exécutée dans un groupe, un Workflow ou un Schedule. Dans ce cas, le numéro d'exécution (RunID) de la tâche est écrit dans le rapport d'activation. S'il n'y a pas de tâche supérieure, cela est indiqué par une ligne dans le rapport d'activation.

:SET &NR# = SYS_ACT_PARENT_NR()
:IF &NR#  = " "
:   PRINT "No parent"
:ELSE
:   PRINT "RunID of parent is &NR#."
:ENDIF

Le deuxième exemple détermine l'activateur de la tâche. Si elle a été activée par une tâche, son numéro d'exécution (RunID) est affiché dans le rapport d'activation. Dans le cas d'une activation manuelle, le rapport d'activation contient le RunID de la session utilisateur correspondante.

:SET &NR# = SYS_ACT_PARENT_NR(ACT)
:PRINT "RunID of parent is &NR#."

Voir aussi :