Sélectionne des dossiers batch input et affiche le résultat dans le rapport d'activation ou dans un fichier.
Transaction : SM35
Interface : AE
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 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) |
CREDATE_TO= |
Sélection de sessions batch input d'après leur date de création (date de fin de la sélection) |
STATUS= |
Sélection de sessions batch input d'après leur statut Valeurs autorisées : " " (valeur par défaut), "R", "F" et "E" " " – Sessions batch input qui doivent encore être traitées. |
FILE= |
Nom du fichier dans lequel le résultat de la sélection (sessions batch input trouvées) doit être écrit. 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. Valeurs autorisées : "NORMAL" (valeur par défaut), et "ABEND" "NORMAL" – Le Script continue, le Job AE se termine normalement.
|
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= |
|
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 la fonction 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
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=).
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 :