|
Codes retour système des objets activables |
Codes retour |
Statistiques |
|
| Outre les codes retour système, vous pouvez également utiliser des codes retour définis eux-mêmes dans votre traitement. Le nom du statut correspondant est libre, par ex. USER_100 avec le code retour Utilisateur 100. |
Ces statuts définis par l'Utilisateur sont utilisés dans les Workflows et les Schedules. Vous pouvez les définir comme statut final attendu dans l'onglet Résultat (Schedule) et "Postconditions" (Workflow). Sélectionnez également les statuts dans l'onglet "Dépendances" (Workflow) afin de réagir à des codes retour spéciaux de la Tâche précédente.
Les codes retour Utilisateur sont enregistrés avec leur description dans la table UC_ZUTYP. Faites les modifications ou les ajouts directement dans la table de la base de données. Le code retour, doit être inférieur à 1000, et commencer par un ou plusieurs 0. Insérez une chaîne de caractères alphanumériques pour désigner le statut. Les codes retour Utilisateur peuvent être sélectionnés dans tous les Clients.
Exemples :
|
Statut |
Code retour Utilisateur |
Signification |
|---|---|---|
|
USER_100 |
0100 |
Un code retour Utilisateur unique (100) est attribué au statut USER_100. |
|
USER_200_300 |
0200-0300 |
Une plage de codes retour Utilisateur (200 à 300) est attribuée au statut USER_200_300. |
|
USER_301_401_501 |
0301,0401,0501 |
Une liste de codes retour Utilisateur (301, 401 et 501) est attribuée au statut USER_301_401_501. |
Les codes retour Utilisateur peuvent être définis par l'instruction de script :EXIT. Si vous avez activé l'option Générer à l'Exécution dans l'onglet Attributs, vous pouvez réagir au code retour défini par l'Utilisateur au sein d'un Workflow.
Pour réagir à des conditions rencontrant déjà un Job généré dans le système cible, les codes retour Utilisateur sont définis et évalués d'une manière spéciale. Dans les queues (trailer) des Jobs, l'exécution de l'Agent Job dépend de la fin normale ou non du Job. Lors d'une interruption, l'Agent Job reprend le code retour défini dans le Job.
Vous pouvez définir un code retour particulier dans un Job. Le Job sera interrompu de façon anormale avec ce code retour Utilisateur. Utilisez pour cela la syntaxe suivante :
SET RETCODE=nnn
GOTO RETCODE
Au lieu d'indiquer une valeur fixe comme code retour, vous pouvez également utiliser un numéro d'erreur DOS "Errorlevel". Vous dépendez alors des caractéristiques du système d'exploitation. Utilisez la syntaxe suivante :
SET RETCODE=%ERRORLEVEL%
GOTO RETCODE
Dans UNIX, vous pouvez terminer un Job anormalement à tout moment à l'aide de l'instruction UNIX EXIT nnn.
L'Agent Job BS2000 peut déterminer le code retour à l'aide des Variables de Job ou d'une commande de fichier. Dans les queues de BS2000, deux marques de saut sont définies au niveau desquelles le traitement correspondant est réalisé.
Si vous voulez utiliser des Variables de Job, vous devez leur attribuer le nom de liaison *RETCODE. Utilisez la syntaxe suivante dans le Job :
/DCLJV #RETCODE,LINK=*RETCODE
/SETJV #RETCODE,'421'
/SKIP .RETJV
Si le code retour est déterminé par une commande fichier, il vous faut attribuer un fichier avec le nom de lien RETCODE. La chaîne de caractère "RETCODE" sera recherchée dans le nom de fichier. Ensuite, le code retour Utilisateur doit apparaître dessus. Utilisez la syntaxe suivante dans le Job :
/FILE #RETCODE421,LINK=RETCODE
/SKIP .RETTFT
Rubriques connexes :
Codes retour système des objets activables
Instruction de script :EXIT