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

R3_GET_SESSIONS

Sélectionne des dossiers batch input et affiche le résultat dans le rapport d'activation ou dans un fichier.

Transaction : SM35

Interface : AE

Syntaxe

R3_GET_SESSIONS

NAME=...
CREDATE_FROM=...
CREDATE_TO=...
STATUS=...
[,FILE=...]
[,NOFOUND=...]
[,ORDER_BY=...]

Syntaxe

Description / format

NAME=

Sélection de sessions batch input d'après leur nom
Format : littéral de script

Vous pouvez utiliser les caractères génériques "*" et "?". "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère. 

CREDATE_FROM= 

Sélection de sessions batch input d'après leur date de création (date de début de la sélection)
Format : Littéral de script
Format de date : AAAAMMJJ 

CREDATE_TO= 

Sélection de sessions batch input d'après leur date de création (date de fin de la sélection)
Format : littéral de script
Format de date : AAAAMMJJ 

STATUS=

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

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

" " – Sessions batch input qui doivent encore être traitées.
"R" – Sessions batch input qui sont en cours de traitement (Running).
"F" – Sessions batch input dont le traitement est terminé (Finished).
"E" – Sessions batch input pour lesquelles des erreurs sont survenues au cours du traitement (Error).

FILE=

Nom du fichier dans lequel le résultat de la sélection (sessions batch input trouvées) doit être écrit.
Format : littéral de script

Ce paramètre peut être utilisé pour écrire le résultat sur un fichier indiqué (et non sur un protocole d'activation). Chaque session batch input trouvée correspond à une ligne. Les 13 premières positions contiennent les noms des sessions et les 21 positions supplémentaires l'ID de la queue.

NOFOUND=

Comportement adopté si aucune session batch input n'est trouvée.
Format de la valeur : littéral de script

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

"NORMAL" – Le Script continue, le Job AE se termine normalement.
"ABEND" – Le Script s'interrompt, le Job AE se termine anormalement.

ORDER_BY=

Critère de tri de la sélection de sessions. Tous les noms de champ de la table SAP APQI peuvent être indiqués. Par exemple :  ORDER_BY=GROUPID

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

Codage pour le fichier en sortie créé (paramètre FILE=).

Exemple : UTF-8

Valeur par défaut : ISO-8859-1

Si un codage non pris en charge ou un codage non valide est indiqué, cela entraîne l'interruption du Job avec un message d'erreur correspondant.

Dans les formes SAP, un assistant de saisie qui répertorie tous les codages pris en charge est disponible pour ce champ.

Description

Le résultat de la sélection est écrit dans le rapport d'activation ou dans un fichier. Chaque session batch input trouvée correspond à une ligne. Les lignes ne sont pas présentées de la même manière dans le rapport d'activation et dans le fichier. 

Le fichier utilise des colonnes. La première ligne du fichier contient des informations sur la largeur et le contenu de ces colonnes. Chaque ligne est divisée en fonction de ce paramétrage. Les 13 premiers caractères correspondent au nom de la session batch input, les 21 suivants contiennent l'ID de la queue. les derniers treize caractères indiquent l'utilisateur qui a créé la session batch input.

Le paramètre ORDER_BY permet de trier les sessions batch input en fonction d'un critère donné.

Dans le rapport d'activation, les informations de chaque ligne sont séparées par un point-virgule. Un horodatage et un numéro de message AE figurent aussi en début de ligne.

Vous pouvez analyser le résultat de la sélection à l'aide de fonctions de script. Utilisez lafonction PREP_PROCESS_REPORT dans l'onglet Post-traitement pour analyser le protocole d'activation. La fonction PREP_PROCESS_FILE est quant à elle employée si le résultat de la sélection a été enregistré dans un fichier.

Avec la version 2.63E de Automation Engine, le créateur des sessions batch input est indiqué à la fin des lignes du protocole d'activation ou du fichier. Cela peut parfois poser un problème dans les scripts AE existants si la séquence de données créée avec PREP_PROCESS_* n'est pas divisée en colonnes. C'est par exemple le cas si l'intégralité de la ligne est traitée à l'aide de fonctions de chaînes de caractères.

Notez que les fichiers générés sont enregistrés par défaut sur l'ordinateur sur lequel l'agent est installé (par ex. R3_GET_JOB_SPOOL; FILE=).

Exemples

Dans le premier exemple, sont sélectionnées toutes les sessions batch input nommées "NI" qui restent à traiter à ce jour.

:SET &TODAY# = SYS_DATE(YYYYMMDD)
R3_GET_SESSIONS NAME='NI',CREDATE_FROM='&TODAY#',CREDATE_TO='&TODAY#',STATUS=" "

Exemples de lignes dans le rapport d'activation :

20020313/135601.000 - U2004943 ;AE_TEST;20020312NI;NI

Le second exemple sélectionne toutes les sessions batch input créées entre le 01.01.2000 et le 01.01.2002 dont le traitement a fait l'objet d'erreurs. Le résultat de la sélection est enregistré dans un fichier.

R3_GET_SESSIONS NAME='*',CREDATE_FROM='20000101',CREDATE_TO='20020101',STATUS='E',FILE='sessions.txt'

Exemples de lignes susceptibles de figurer en début de fichier :

COL=LENGTH,LENGTH_TAB='13=GROUPID,21=QID,13=CREATOR'
AE_TEST     20020314095728031322 NI           
AE_TEST     20020314095823023148 NI           
AE_TEST     20020314100932031323 NI

 

Rubriques connexes :

Généralités sur le JCL SAP