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

Syntaxe

Description / format

ID=

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

NOFOUND=

Traitement si une chaîne de processus n'est pas trouvée.
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 s'interrompt et le job AE se termine anormalement.

ERROR=

Traitement si une chaîne de processus se termine de façon anormale
Format : littéral de script

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

ABEND : le script est interrompu, et le job AE se termine anormalement.
IGNORE : le script continue, et le job AE se termine normalement.
SUSPEND : le job demeure actif jusqu'au prochain redémarrage réussi de la chaîne de processus / de ses processus enfants ou l'interruption manuelle du job.
Vous pouvez utiliser ce paramètre pour reprendre des chaînes de processus ou leurs processus enfants. L'avantage est que le job ne s'arrête pas, ce qui signifie que le traitement se poursuit dans un parent (un Workflow, par exemple).

PROCESSLOGS=

Sortie des journaux des différents traitements d'une chaîne de processus.
Format : littéral de script

Valeurs autorisées : "YES", "NO" ou "ERROR"
Défaut : YES

"YES" : les journaux des différents processus sont joints au journal de la chaîne de processus
"NO" : seul le journal de la chaîne de processus s'affiche
"ERROR" : les logs des différents processus sont uniquement affichés en cas d'erreur.

RESTART=

Nombre de tentatives pour continuer une chaîne de processus interrompue
Format : Entier
Valeur par défaut : 0

JOBLOGS=

Sortie du log du job d'arrière-plan.
Format : littéral de script

Valeurs autorisées : "YES", "NO" ou "ERROR"
Défaut : YES

"YES" : les logs du job d'arrière-plan sont affichés.
"NO" : les logs du job d'arrière-plan ne sont pas affichés.
"ERROR" : les logs du job d'arrière-plan ne sont affichés qu'en cas d'erreur.

LONGTEXT=

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

Valeurs autorisées : "YES", "NO" ou "ERROR"
Défaut : ERROR

"ERROR" : le texte long du message de log n'est affiché qu'en cas d'erreur.
"YES" : le texte long du message de log est affiché.
"NO" : le texte long du message de log n'est pas affiché.

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.
YES : les enfants d'un job sont répliqués dans le système AE. 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.
NO : il n'y a aucune réplication dans le système AE.

STATUSRETRY=

Nombre de répétitions de la vérification du statut
Format de la valeur : Nombre

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
Format de la valeur : littéral de script

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

"YES" : la chaîne de processus est nouvellement planifiée.
"NO" : pas de nouvelle planification. C'est une façon d'accélérer le démarrage de la chaîne de processus.

SYNCHRONOUS=

Exécute la chaîne de processus de manière synchrone.
Format de la valeur : littéral de script

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.
"NO" : l'exécution synchrone n'est pas utilisée.

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
Ce fichier est aussi enregistré comme sortie du job dans le job AE.

"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.
"NO" : les journaux des processus enfants de la chaîne de processus ne sont pas pris en compte 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 :

É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 :

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 &LT#,"YES,NO,ERROR",'LONGTEXT=','YES'
:
ENDREAD

BW_ACTIVATE_CHAIN ID='&CHAIN#',ERROR='&ERROR#',NOFOUND='&NOFOUND#',LONGTEXT='&LT#'