Continue une chaîne de processus interrompue.
Transaction : RSA1
Version SAP BW : à partir de 3.0B avec patch SAPKW30B11
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 |
LOGID= |
ID du log (25caractères) |
NOFOUND= |
Comportement adopté si la chaîne de processus est introuvable. NORMAL = le script continue, et le job AE se termine normalement. |
ERROR= |
Comportement adopté si la chaîne de processus se termine anormalement. ABEND = le Script s'interrompt, le Job AE se termine anormalement. |
PROCESSLOGS= |
Sortie des protocoles des différents processus d'une chaîne de processus. Valeurs autorisées : YES (valeur par défaut), NO ou ERROR "YES" = Les protocoles des différents processus sont joints au protocole de la chaîne de processus. |
JOBLOGS= |
Sortie des protocoles du Job d'arrière-plan du processus. Valeurs autorisées : YES (valeur par défaut), NO ou ERROR "YES" = Les protocoles du Job d'arrière-plan du processus sont affichés. |
LONGTEXT= |
Sortie du texte long (texte de diagnostic) d'un message de protocole. Valeurs autorisées : YES, NO ou ERROR (valeur par défaut) "ERROR" = Le texte long du message de protocole est uniquement affiché en cas d'erreur. |
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.
|
GET_SPOOL= |
Demander la liste de spool du job démarré
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 : "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 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. |
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.
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'