Manuel des Scripts Automation Engine > JCL AE pour les applications > SAP > BW_RESTART_CHAIN

BW_RESTART_CHAIN

Continue une chaîne de processus interrompue.

Transaction : RSA1

Version SAP BW : à partir de 3.0B avec patch SAPKW30B11

Syntaxe

BW_RESTART_CHAIN

ID=...
,LOGID=
...
[,NOFOUND=...]
[,ERROR=...]
[,PROCESSLOGS=...]
[,JOBLOGS=...]
[,LONGTEXT=...]
[,REPLICATE=...] 
[,GET_SPOOL=...
[,COLLECTLOGS=...]

Syntaxe

Description / format

ID=

Désignation technique de la chaîne de processus
Format de la valeur : littéral de script

LOGID=

ID du log (25caractères)
Format de la valeur : littéral de script

NOFOUND=

Comportement adopté si la chaîne de processus est introuvable.
Format de la valeur : littéral de script

Valeurs autorisées : "NORMAL" (valeur par défaut) ou "ABEND"
Défaut : NORMAL

NORMAL = le script continue, et le job AE se termine normalement.
ABEND = le script est interrompu, et le job AE se termine anormalement.

ERROR=

Comportement adopté si la chaîne de processus se termine anormalement.
Format de la valeur : littéral de script

Valeurs autorisées : "ABEND" (valeur par défaut), "IGNORE" ou "SUSPEND"
Défaut : "ABEND"

ABEND = le Script s'interrompt, le Job AE se termine anormalement.
IGNORE = le Script continue, le Job AE se termine normalement.
SUSPEND = le Job demeure actif jusqu'au prochain redémarrage de la chaîne de processus/son processus enfant s'est exécuté avec succès ou le Job a été annulé manuellement.
Ce paramètre sert à exécuter une reprise de chaîne de processus ou de ses processus enfants sans mettre fin au Job. Ainsi, le traitement dans un parent (un Workflow par exemple) se poursuit.

PROCESSLOGS=

Sortie des protocoles des différents processus d'une chaîne de processus.
Format de la valeur : littéral de script

Valeurs autorisées : YES (valeur par défaut), NO ou ERROR
Défaut : YES

"YES" = Les protocoles des différents processus sont joints au protocole de la chaîne de processus.
"NO" = Seul le protocole de la chaîne de processus est affiché.
"ERROR" = Les protocoles des différents processus sont uniquement affichés en cas d'erreur.

JOBLOGS=

Sortie des protocoles du Job d'arrière-plan du processus.
Format de la valeur : littéral de script

Valeurs autorisées : YES (valeur par défaut), NO ou ERROR
Défaut : YES

"YES" = Les protocoles du Job d'arrière-plan du processus sont affichés.
"NON" = Les protocoles du Job d'arrière-plan du processus ne sont pas affichés.
"ERROR" = Les protocoles du Job d'arrière-plan du processus sont uniquement affichés en cas d'erreur.

LONGTEXT=

Sortie du texte long (texte de diagnostic) d'un message de protocole.
Format de la valeur : littéral de script

Valeurs autorisées : YES, NO ou ERROR (valeur par défaut)
Défaut : ERROR

"ERROR" = Le texte long du message de protocole est uniquement affiché en cas d'erreur.
"YES" = Le texte long du message de protocole est affiché.
"NO" = Le texte long du message de protocole n'est pas affiché.

REPLICATE=

Traitement des processus enfant d'une chaîne de processus

Format de la valeur : littéral de script

Valeurs autorisées : "ALL", "YES" ou "NO" (valeur par défaut)

ALL = réplique tous les processus enfants d'un Job sur le système AE (cela inclut les processus sautés). Ils sont affichés dans la fenêtre des activités de l'interface utilisateur. Les rapports statistiques et les rapports sont aussi générés dans le système AE.
YES = les enfants d'un Job sont répliqués dans le système AE. Ils sont affichés dans la fenêtre des activités de l'interface utilisateur. Les rapports statistiques et les rapports sont aussi générés dans le système AE.
NO – Il n'y a aucune réplication dans le système AE.

GET_SPOOL=

Demander la liste de spool du job démarré
Format de la valeur : littéral de script

Valeurs autorisées : "YES" et "NO" (valeur par défaut)

"YES" : la liste de spool est demandée. Elle est enregistrée en tant que fichier texte défini dans le fichier INI de l'agent SAP avec le paramètre Download_dir= (section [GLOBAL]). Le nom de ce fichier se compose de la manière suivante :
<Numéro de job SAP>_<numéro de step>_<numéro de spool>.txt
Par ailleurs, ce fichier est enregistré comme résultat de Job dans le Job AE.

"NO" : la liste de spool n'est pas demandée

COLLECTLOGS=

Rédiger des rapports des processus enfants de la chaîne de processus activée dans le rapport de Job

Les rapports des processus enfants répliqués sont disponibles par défaut dans le rapport du job ET de la tâche du processus enfant. Ces informations sont ainsi redondantes dans le rapport de Job et peuvent donc être ignorées.

Valeurs autorisées : "YES" (valeur par défaut) ou "NO" 

"YES" - Rédiger le protocole des processus enfants dans le rapport de Job
"NO" - Ne pas enregistrer le protocole des processus enfants de la chaîne de processus dans le rapport de Job

Veuillez noter que les rapports des processus enfants ne sont pas disponibles lorsque les paramètres REPLICATE et COLLECTLOGS sont tous les deux définis sur NO.

Description

Cet élément de script continue une Process Chain interrompue. Le paramètre LOGID= permet d'identifier de façon univoque une exécution donnée de cette chaîne de processus. L'ID de log peut être déterminée en utilisant PREP_PROCESS_REPORT depuis un rapport de Job AE.

Une fois la chaîne de processus poursuivie, elle est surveillée jusqu'à sa fin. Dans tous les cas, le protocole de la chaîne de processus est enregistré dans le rapport d'activation. Selon la configuration des paramètres PROCESSLOGS= et JOBLOGS=, les protocoles des processus ou les protocoles des Jobs d'arrière-plan sont également affichés.

Exemples

Dans l'exemple, le script détermine si la chaîne de processus "ZSBB1" a été interrompue lors du post-traitement d'un job au moyen du numéro d'erreur. Dans ce cas, l'ID de log à 25 caractères est enregistré dans une variable.

:SET &HND# = PREP_PROCESS_REPORT(,,PLOG,'*U2004111*','COL=DELIMITER',"DELIMITER=@'@")
:
SET &LOGID# = ''

:
PROCESS &HND#
:   
SET &LOGID# = GET_PROCESS_LINE(&HND#,4)
:
ENDPROCESS

:
IF &LOGID# <> ''
:   
PUT_VAR VARA.CHAINS,'ZSBB1',&LOGID#
:
ENDIF

Un autre Job lit l'ID du log à partir de la variable et redémarre la chaîne de processus pour poursuivre le traitement.

:SET &LOGID# = GET_VAR(VARA.CHAINS,ZSBB1)
BW_RESTART_CHAIN ID='ZSBB1',LOGID='&LOGID#',ERROR='ABEND',NOFOUND='NORMAL'