BW_ACTIVATE_CHAIN
Démarre une chaîne de processus, surveille l'exécution et enregistre les logs dans le rapport d'activation.
Transaction : RSA1
Version SAP BW : À partir de 3.0B avec patch SAPKW30B11
Syntaxe
BW_ACTIVATE_CHAIN
ID=...
[,NOFOUND=...]
[,ERROR=...]
[,PROCESSLOGS=...]
[,RESTART=...]
[,JOBLOGS=...]
[,LONGTEXT=...]
[,REPLICATE=...]
[,STATUSRETRY=...]
[,SCHEDULE=...]
[,SYNCHRONOUS=...]
[,GET_SPOOL=...]
[,COLLECTLOGS=...]
Syntaxe |
Description / format |
---|---|
ID= |
Désignation technique de la chaîne de processus. |
NOFOUND= |
Traitement si une chaîne de processus n'est pas trouvée. NORMAL : le script continue et le job AE se termine normalement. |
ERROR= |
Traitement si une chaîne de processus se termine de façon anormale ABEND : le script est interrompu, et le job AE se termine anormalement. |
PROCESSLOGS= |
Sortie des journaux des différents traitements d'une chaîne de processus. "YES" : les journaux des différents processus sont joints au journal de la chaîne de processus |
RESTART= |
Nombre de tentatives pour continuer une chaîne de processus interrompue |
JOBLOGS= |
Sortie du log du job d'arrière-plan. "YES" : les logs du job d'arrière-plan sont affichés. |
LONGTEXT= |
Sortie du texte long d'un message (texte de diagnostic). Valeurs autorisées : "YES", "NO" ou "ERROR"
"ERROR" : le texte long du message de log n'est affiché qu'en cas d'erreur. |
REPLICATE= |
Traitement des processus enfants 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 (inclut les processus ignorés). Ils sont affichés dans la perspective Surveillance des processus. Les enregistrements statistiques et les rapports sont aussi générés dans le système AE.
|
STATUSRETRY= |
Nombre de répétitions de la vérification du statut Valeur par défaut : 0 En raison d'un comportement lié à SAP, les chaînes de processus peuvent afficher un statut terminé pendant un court instant avant de se poursuivre. L'agent signale la chaîne de processus comme terminée s'il a récupéré son statut exactement à cet instant. Utilisez le paramètre STATUSRETRY= pour empêcher que la fin de la chaîne de processus ne soit reconnue trop tôt. Il définit la fréquence à laquelle le statut est vérifié. Automation Engine ne sera informé de la fin du processus qu'après x répétitions. |
SCHEDULE= |
Nouvelle planification des chaînes de processus Valeurs autorisées : "YES" (valeur par défaut) ou "NO" "YES" : la chaîne de processus est nouvellement planifiée. |
SYNCHRONOUS= |
Exécute la chaîne de processus de manière synchrone. Valeurs autorisées : "YES" et "NO" (valeur par défaut) "YES" : exécution synchrone. La chaîne de processus est donc exécutée en mode dialogue au lieu du mode d'arrière-plan, et les processus enfants sont terminés en série. |
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= |
Écrit les rapports des processus enfants de la chaîne de processus activée dans le rapport du 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 job et peuvent donc être ignorées. Valeurs autorisées : "YES" (valeur par défaut) ou "NO" "YES" : les logs des processus enfants sont écrits dans le rapport du job. Notez que les rapports des processus enfants ne sont pas disponibles si vous spécifiez NO pour les paramètres REPLICATE et COLLECTLOGS. |
Cet élément de script lance une chaîne de processus. En premier, déterminez les conditions de démarrage. Si la chaîne de processus ne démarre pas immédiatement, mais seulement après le premier événement ou à une heure déterminée, ces conditions de démarrage sont journalisées.
Dès que la chaîne de processus démarre, elle est surveillée jusqu'à sa fin. Le journal de la chaîne de processus est toujours enregistré dans le rapport d'activation. Les journaux des processus ou les journaux des jobs d'arrière-plan sont aussi affichés, selon la configuration des paramètres PROCESSLOGS= et JOBLOGS=.
Le paramètre RESTART= peut être utilisé pour définir le nombre de tentatives visant à continuer la chaîne de processus si elle a été interrompue.
Vérification du statut
Automation Engine suppose que le statut technique soumis à l'appel du contrôle de statut des fonctions est un "statut final". Le référentiel d'interface donne la description suivante :
Le paramètre TECHSTATUS est le statut technique de la requête. Il contient toujours l'une des valeurs suivantes :
- G : vert (requête traitée avec succès)
- Y : jaune (requête en cours de traitement)
- R : rouge (requête incorrecte ou interrompue)
Évidemment, ces statuts ne sont pas des "statuts définitifs". Un statut peut devenir "rouge" pendant un bref laps de temps, puis "jaune" ou "vert" au bout d'un moment. AE en tient compte. Pour les vérifications de statut, il est possible d'activer une temporisation, permettant de vérifier n fois si, par exemple, le statut "rouge" se maintient ou non. Le fichier INI de l'agent SAP contient les paramètres maxruntime= and repeat_check= [SAP_BW]) prévus à cet effet.
Une autre fonction permet de vérifier les statuts des chaînes de processus. Elle propose les valeurs suivantes :
- "R" : interruption
- "G" : fin normale
- "F" : fin normale
- "A" : poursuite de la vérification
- "X" : interruption
- "P" : poursuite de la vérification
- "S" : interruption (mais uniquement après redémarrage de la chaîne de processus)
- "Q" : poursuite de la vérification
- "Y" : poursuite de la vérification
- " " : poursuite de la vérification
AE convertit ensuite ces statuts en codes retour :
Code retour |
Statut |
Statut SAP |
---|---|---|
0 |
ENDED_OK |
G ou F |
4 |
ENDED_NOT_OK |
R |
8 |
ENDED_NOT_OK |
X |
12 |
ENDED_NOT_OK |
S |
Exemples
Cet exemple active une chaîne de processus qui a été précédemment interrogée par l'utilisateur. Les valeurs pour les paramètres de l'élément de script résultent également de cette requête. Ces valeurs sont transmises à l'élément de script sous la forme de variables de script.
:BEGINREAD
: READ &CHAIN#,"ZTEST,ZSBB1,ZSBB2",'Process chain','ZTEST',M
: READ &ERROR#,"IGNORE,ABEND",'ERROR=','ABEND'
: READ &NOFOUND#,"NORMAL,ABEND",'NOFOUND=','NORMAL'
: READ <#,"YES,NO,ERROR",'LONGTEXT=','YES'
:ENDREAD
BW_ACTIVATE_CHAIN ID='&CHAIN#',ERROR='&ERROR#',NOFOUND='&NOFOUND#',LONGTEXT='<#'