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

BW_ACTIVATE_CHAIN

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

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

NOFOUND=

Traitement exécuté si la 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"
Par 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=

Traitement adopté 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" ABEND
Par 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 job qui est sensé contenir ce traitement se poursuit dans un parent (un Workflow, par exemple).

PROCESSLOGS=

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

Valeurs autorisées : "YES", "NO" ou "ERROR"
Par 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.

RESTART=

Nombre de tentatives de reprise d'une chaîne de processus interrompue.
Format : Entier
Valeur par défaut : 0

JOBLOGS=

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

Valeurs autorisées : "YES", "NO" ou "ERROR"
Par 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 d'un message (texte de diagnostic).
Format : littéral de script

Valeurs autorisées : "YES", "NO" ou "ERROR"
Par 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.

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 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
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" = Aucune nouvelle planification de la chaîne de processus. Le démarrage de la chaîne de processus est accéléré.

SYNCHRONOUS=

Exécuter 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 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.
"NO" = Ne pas appliquer l'exécution synchrone.

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

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.

Exemples

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

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