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

R3_ACTIVATE_SESSIONS

Traitement des sessions batch input.

Transaction : SM35

Interface : AE

Syntaxe

R3_ACTIVATE_SESSION[S]

NAME=...
[,STATUS=...]
[,NOFOUND=...]
[
,ERROR=...]
[
,ERRORLEVEL=...]
[
,SELECT=...]
[
,JOBNAME=...]
[,ORDER_BY=...] 

Syntaxe

Description / format

NAME=

Sélection des sessions d'après leur nom (par exemple, "xxx*")
Format : littéral de script  

STATUS=

Sélection des sessions d'après leur statut.
Format : littéral de script  

Valeurs autorisées : "" (valeur par défaut) et "E"

"" : session qui doit être traitée
"E" : session incorrecte.

NOFOUND=

Action si aucune session n'a été séléctionnée.
Format : littéral de script  

Valeurs autorisées : "NORMAL" (valeur par défaut), "ABEND".

"NORMAL" : l'exécution du script continue, le job AE se termine normalement.
"ABEND" : l'exécution du script s'arrête, le job AE se termine anormalement.

ERROR=

Action si une des sessions sélectionnées se termine de façon anormale.
Format : littéral de script  

Valeurs autorisées : "ABEND" (valeur par défaut), "IGNORE".

"ABEND" : l'exécution du script s'interrompt, le job AE se termine anormalement.
"IGNORE" : l'exécution du script continue, le job AE se termine normalement.

Voir :  ERROR/ERRORLEVEL dans R3_ACTIVATE_SESSIONS

ERRORLEVEL=

Définit le nombre de transactions incorrectes en pourcentage (%) .
Format : littéral de script  

Valeur par défaut : "101"

Le job se termine de façon anormale si ce pourcentage a été dépassé.

SELECT=

Sélection unique ou permanente
Format : littéral de script  

Valeurs autorisées : "ONCE" (valeur par défaut) et "EVERY"

"ONCE" : le nombre de sessions sélectionnées est récupéré une seule fois.
"EVERY" : le nombre de sessions sélectionnées est récupéré à chaque fois qu'une session est libérée. Cette technique permet de parallèliser les sessions libérées.

JOBN[AME]=

Chaque session est traitée avec un job SAP.
Format : littéral de script  

Valeurs autorisées : "ATTRIBUTE" (valeur par défaut) et "SESSION"

"ATTRIBUTE" : contenu de la zone de texte "Nom du job" des Attributs de l'hôte. Un nom de job standard est créé si le texte est vide.
"SESSION" : nom de la session qui doit être traitée.

ORDER[_BY]=

Critère qui peut être utilisé pour trier la sélection de sessions. Tous les noms des champs de la table SAP APQI peuvent être utilisés. Par exemple :  ORDER_BY=GROUPID

Ce paramètre est pris en charge dans SAP version 4.6 et supérieure.

R3_ACTIVATE_SESSION[S]  

[QID=...]
[,NOFOUND=...]
[
,ERROR=...]
[
,ERRORLEVEL=...]
[,JOBNAME=...]  

Syntaxe

Description / format

QID=

ID de queue identifiant clairement la session batch input.
Format : littéral de script  

Ce paramètre permet de démarrer une session batch input précise.

NOFOUND=

Action si aucune session n'a été séléctionnée.
Format : littéral de script  

Valeurs autorisées : "NORMAL" (valeur par défaut), "ABEND".

"NORMAL" : l'exécution du script continue, le job AE se termine normalement.
"ABEND" : l'exécution du script s'arrête, le job AE se termine anormalement.

ERROR=

Action si une des sessions sélectionnées se termine de façon anormale.
Format : littéral de script  

Valeurs autorisées : "ABEND" (valeur par défaut), "IGNORE".

"ABEND" : l'exécution du script s'interrompt, le job AE se termine anormalement.
"IGNORE" : l'exécution du script continue, le job AE se termine normalement.

Voir :  ERROR/ERRORLEVEL dans R3_ACTIVATE_SESSIONS

ERRORLEVEL=

Définit le nombre de transactions incorrectes en pourcentage (%).
Format : littéral de script  

Valeur par défaut : "101"

Le job se termine de façon anormale si cette limite a été dépassée.

JOBN[AME]=

Chaque session est traitée avec un job SAP.
Format : littéral de script  

Valeurs autorisées : "ATTRIBUTE" (valeur par défaut) et "SESSION"

"ATTRIBUTE" : contenu de la zone de texte "Nom du job" des Attributs de l'hôte. Un nom de job standard est créé si le texte est vide.
"SESSION" : nom de la session à traiter.

Description

Les sessions batch input qui doivent être démarrées peuvent être récupérées à l'aide d'une sélection. Utilisez le paramètre QID= pour démarrer une session batch input unique. Les résultats de la sélection de R3_GET_SESSIONS qui sont stockés dans le rapport d'activation ou dans un fichier servent pour localiser la session individuelle par son ID de file d'attente.

Le paramètre ORDER_BY permet de définir l'ordre de traitement des sessions batch input. La sélection est triée selon le critère spécifié dans ce paramètre.

Exemples

Exécuter toutes les sessions dont le nom est "Fl*". Le job se termine de façon anormale s'il contient des transactions incorrectes.

R3_ACTIVATE_SESSIONS NAME='FI*',STATUS=,NOFOUND=NORMAL,ERROR=ABEND,ERRORLEVEL=0

Dans le second exemple, la session batch input dont l'ID de queue a été indiqué en tant que paramètre est démarrée.

R3_ACTIVATE_SESSION QID='20020318171302022315'

 

Rubriques connexes :