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

BW_SET_CONSTRAINT

Définit un critère de reprise automatique des processus enfants d'une chaîne de processus.

Syntaxe

BW_SET_CONSTRAINT

[TYPE=...]
[,NAME=
...]
,FIELD=... 
[,OPERATOR=...]
,VALUE=...
,ACTION=...
[,COUNT=...]
[,DELAY=...]

Elément de syntaxe

Description/format

TYPE=

Type de processus enfant
Format de la valeur : Littéral de script

Le caractère générique * peut également être utilisé (caractère de remplacement pour un nombre de caractères au choix).

Exemple : ABAP

NAME=

Nom du processus enfant
Format de la valeur : Littéral de script

Les caractères génériques * et ? (caractères de remplacement pour un nombre de caractères au choix) sont également disponibles.

FIELD=

position devant être recherchée après la valeur (paramètre VALUE)
Format de la valeur : littéral de script

Valeurs autorisées : "STATUS", "JOBLOG" ou "PROCESSLOG"

"STATUS" = Statut du processus enfant
"JOBLOG" = protocole de Job. Protocole du Job Background
"PROCESSLOG" = protocole de processus. Protocole du processus enfant

Veuillez noter que le protocole de processus et le protocole de Job peuvent être recherchés uniquement lorsqu'ils ont été activés pour la chaîne de processus activement ou redémarrée (script BW_ACTIVATE_CHAIN / BW_RESTART_CHAIN, paramètre JOBLOGS / PROCESSLOGS).

OPERATOR=

Opérateur de la condition
Format de la valeur : littéral de script

Valeurs autorisées : "EQ" (valeur par défaut), "NE", "CP" ou "NP"

"EQ" = correspond (uniquement pour FIELD=STATUS)
"NE" = ne correspond pas (uniquement pour FIELD=STATUS)
"CP" = contient un modèle
"NP" = ne contient pas de modèle

VALUE=

Valeur à rechercher
Format de la valeur : Littéral de script

En cas de vérification du statut du processus enfant (FIELD=STATUS), les valeurs suivantes sont possibles (correspondent à la définition du domaine RSPC_STATE dans le système SAP) :

"X" = Interrompu
"R" = Terminé avec erreurs
"G" = Terminé avec succès
"F" = Terminé
"A" = Actif
"P" = Planifié
"S" = Ignoré au redémarrage
"Q" = Validé
"Y" = Prêt
"" = Indéfini

ACTION=

Action a exécuter pour le processus enfant remplissant la condition.
Format de la valeur : Littéral de script

Valeurs autorisées : "RESTART" ou "ABEND"

"RESTART" = Exécuter une reprise du processus enfant correspondant
"ABEND" = Interrompre le processus enfant correspondant

COUNT=

Nombre de reprises devant être exécutées pour le processus enfant concerné
(pertinent uniquement avec ACTION=RESTART)
Format de la valeur : nombre
Valeur par défaut : 1

DELAY=

Temps d'attente en minutes entre plusieurs reprises
(pertinent uniquement avec ACTION=RESTART)
Format de la valeur : nombre
Valeur par défaut : 1

Description

Ce script permet d'exécuter une reprise automatique des processus enfant des chaînes de processus.

Cette fonction permet de définir un critère composé de la condition à vérifier (par exemple : vérification d'un statut donné) et de l'action à exécuter (par exemple : interrompre la tâche). L'action définie est exécutée pour tous les processus enfant concernés par cette condition.

Exemple

L'exemple suivant présente la définition d'un critère de reprise, alors que le nom des processus enfant interrompus de type "ABAP" commence toujours par "RSM" et et qu'ils sont redémarrés automatiquement jusqu'à 3 fois à des intervalles de 5 minutes.

BW_SET_CONSTRAINT NAME="RSM*",VALUE="X",OPERATOR="EQ",ACTION="RESTART",TYPE="ABAP",DELAY="5",COUNT="3"

La définition suivante entraîne l'interruption de tous les processus enfant ABAP dont le nom commence par "RSM", lorsque le protocole du Job Background contient le terme "error".

BW_SET_CONSTRAINT NAME="RSM*",VALUE="error",OPERATOR="CP",ACTION="ABEND",TYPE="ABAP",DELAY="5",COUNT="3",SOURCE="JOBLOG"