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

R3_GET_JOBS

Sélectionne des Jobs SAP et affiche le résultat dans le rapport d'activation ou dans un fichier.

Transaction : SM37

Interface : L'Automation Engine et Standard

Syntaxe

R3_GET_JOB[S]

NAME=...
[,JOBCOUNT=...]
[,GROUP=...]
[,USER=...]
[,START_D[ATE]=...]
[,START_T[IME]=...]
[,END_D[ATE]=...]
[,END_TIME=...]
[,NO_DATE=...]
[,WITH_PRED=...]
[,EVENT_ID=...]
[,EVENT_PARM=...]
[,PRELIM=...]
[,SCHEDUL=...]
[,READY=...]
[,RUNNING=...]
[,FINISHED=...]
[,ABORTED=...]
[,NOFOUND=...]
[,FILE=...]

Elément de syntaxe

Description/format

NAME=

Sélection d'un ou de plusieurs Jobs d'après leur nom.
Format : Littéral de Script ou Nom AE 

Utilisé conjointement avec le numéro du Job, ce paramètre permet d'identifier un Job SAP de manière univoque. Pour sélectionner plusieurs Jobs, vous pouvez utiliser le caractère générique "*" (par exemple, "xxx*").

Paramètres

Critères de sélection supplémentaires, sous la forme d'un mot-clé auquel est attribuée une valeur.

Si vous ne précisez pas de valeur pour un paramètre, une valeur par défaut lui est affectée. Les formats indiqués s'appliquent à la valeur attribuée au mot-clé.

JOBCOUNT=

Numéro du Job SAP
Format: Littéral de Script

Utilisé conjointement avec le nom, ce paramètre permet d'identifier un Job SAP de manière univoque.

GROUP=

Sélection des Jobs en fonction de leurs Groupes (par exemple, "xxx*")
Format : Littéral de Script ou Nom AE

Valeur par défaut : "*" 

USER=

Sélection des Jobs en fonction de leurs Utilisateurs (par exemple, "xxx*")
Format : Littéral de Script ou Nom AE

Valeur par défaut : "*" 

START_D[ATE]=

Date de début planifiée pour l'exécution du Job.
Format : Littéral de Script ou Nom AE

Format de date : AAAAMMJJ
Valeur par défaut : "20010101"

START_T[IME]=

Heure de début planifiée pour l'exécution du Job.
Format : Littéral de Script ou Nom AE

Format d'heure : HHMMSS
Valeur par défaut : "000000"

END_D[ATE]=

Date de fin planifiée pour l'exécution du Job.
Format : Littéral de Script ou Nom AE

Format de date : AAAAMMJJ
Valeur par défaut : date actuelle

END_TIME= 

Heure de fin planifiée pour l'exécution du Job.
Format : Littéral de Script ou Nom AE

Format d'heure : HHMMSS
Valeur par défaut : "235959"

NO_DATE= 

Jobs sans condition de démarrage.
Format : Littéral de Script ou Nom AE
Valeurs autorisées : "" (valeur par défaut) ou "X"

WITH_PRED= 

Jobs avec une condition de démarrage "avec prédécesseur"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

EVENT_ID= 

Jobs liés à un Evènement : Nom de l'évènement
Format : Littéral de Script ou Nom AE

EVENT_PARM= 

Jobs liés à un Evènement : Paramètre de l'Evènement
Format : Littéral de Script ou Nom AE

PRELIM= 

Jobs présentant le statut "Planifié"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

SCHEDUL= 

Jobs présentant le statut "Déclenché"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

READY= 

Jobs présentant le statut "Prêt"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

RUNNING= 

Jobs présentant le statut "Actif"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

FINISHED= 

Jobs présentant le statut "Terminé"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

ABORTED=

Jobs présentant le statut "Interrompu"
Format : Littéral de Script ou Nom AE

Valeurs autorisées : "" (valeur par défaut) ou "X"

NOFOUND=

Comportement adopté si les critères de sélection des Jobs ne donnent aucun résultat.
Format : Littéral de Script ou Nom AE

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

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

FILE=

Nom du fichier dans lequel le résultat (Jobs SAP trouvés) doit être enregistré
Format : Littéral de Script

Le résultat de la sélection n'est pas affiché dans le rapport d'activation si ce paramètre est utilisé.

Description

L'élément de script permet de sélectionner des Jobs d'arrière-plan dans SAP. Les critères de sélection sont transmis en tant que paramètres. Les paramètres correspondent aux champs de la structure BAPIXMJSEL du dictionnaire SAP. Pour obtenir des informations plus précises sur chaque champ, utilisez le dictionnaire ou le navigateur de l'interface BAPI.

Le résultat de la sélection est écrit dans le rapport d'activation ou dans un fichier. Chaque Job SAP trouvé 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 33 premiers caractères correspondent au nom du Job SAP, les 9 suivants à son numéro.

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 en outre en début de ligne.

Vous pouvez analyser le résultat de la sélection à l'aide de fonctions script. Utilisez la fonction PREP_PROCESS_REPORT dans l'onglet "Post Traitement" pour analyser le rapport 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.

Veuillez noter 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, tous les Jobs SAP planifiés dont le nom commence par "LANC" sont sélectionnés.

R3_GET_JOBS NAME="FREIG*",PRELIM="X"

Le résultat est affiché dans le rapport d'activation et pourrait se présenter comme les lignes ci-dessous :

20000922/134303.567 - U2004943 ;LIBERATION;13450801
20000922/134303.567 - U2004943 ;LIBERATION;13455501
20000922/134303.567 - U2004943 ;LIBERATION;16221501
20000922/134303.567 - U2004943 ;LIBERATION;16225101
20000922/134303.567 - U2004943 ;LIBERATION;16234801

Le second exemple sélectionne tous les Jobs SAP nommés "EU_REORG" et présentant le statut "Terminé". Le résultat de la sélection est enregistré dans un fichier.

R3_GET_JOBS NAME='EU_REORG',FINISHED='X',FILE='Jobs.txt'

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

COL=LENGTH,LENGTH_TAB='33=JOBNAME,9=JOBCOUNT'
EU_REORG                         01404301
EU_REORG                         01405401

 

Rubriques connexes :