Démarre une chaîne de processus, surveille l'exécution et enregistre ses protocoles dans le rapport d'activation.
Transaction : RSA1
Version SAP BW : à partir de 3.0B avec patch SAPKW30B11
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 exécuté si la chaîne de processus n'est pas trouvée. NORMAL = Le script continue, et le job AE se termine normalement. |
ERROR= |
Traitement adopté si une chaîne de processus se termine de façon anormale. 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. "YES" = Les protocoles des différents processus sont joints au protocole de la chaîne de processus. |
RESTART= |
Nombre de tentatives de reprise d'une chaîne de processus interrompue. |
JOBLOGS= |
Sortie des protocoles du Job d'arrière-plan du processus. "YES" = Les protocoles du Job d'arrière-plan du processus 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 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.
|
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 présenter l'état terminé pendant un court instant avant de se poursuivre. L'agent signale la process chain terminée si il a récupéré son statut exactement à cet instant. Le paramètre STATUSRETRY= empêche 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é. Le 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écuter 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 exécutée en mode Dialogue au lieu du mode d'arrière-plan, ce qui entraîne le traitement en série des processus enfants. |
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. |
Le script démarre une Process Chain. Les conditions de démarrage sont tout d'abord déterminées. 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.
Une fois la chaîne de processus démarrée, 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.
Si une chaîne de processus est interrompue, le paramètre RESTART= détermine le nombre de tentatives visant à la continuer.
Cet exemple active une chaîne de traitement qui a été précédemment interrogée par l'utilisateur. Les valeurs pour les paramètres de l'élément de script applicable 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='<#'