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

R3_GET_JOB_SPOOL

Lit la liste de spool d'un step de type "programme ABAP".

Transaction : SM37

Interface : AE et Standard

Syntaxe

R3_GET_JOB_SPOOL

FILE=...
[,NAME=...]
[,JOBCOUNT=...]
[,STEP=...]
[,NOFOUND=...]
[,MAXLINES=...]
[,SPOOLNR=...]
[,FORMAT=...]
[,PAGES=...]
[,FILTER=...]
[,RAW=...]

Syntaxe Description / format
FILE=

Nom du fichier dans lequel le résultat (liste de spool du step) doit être écrit.
Format de la valeur : littéral de script 

Par ailleurs, ce fichier est enregistré comme résultat de Job dans le Job AE.

NAME=

Nom du Job SAP qui contient le step
Format de la valeur : littéral de script

Si vous n'indiquez pas de nom du job, le dernier job SAP traité via le job AE incluant cet élément de script est automatiquement utilisé.

JOBCOUNT=

Numéro du Job SAP qui contient le step
Format de la valeur : littéral de script

Si le numéro du Job n'est pas indiqué, la dernière valeur du Job qui s'est déroulée via le Job AE est automatiquement utilisée.

Lors de l'utilisation des paramètres NAME et JOBCOUNT, notez que le spool ne peut pas être récupéré si le job correspondant a été supprimé dans le système SAP (paramètre "Supprimer le job dans CCMS après exécution" dans le job AE).

STEP=

Numéro de l'étape dans le Job SAP.
Format de la valeur : Entier

Valeur par défaut : 1

NOFOUND=

Comportement si la liste de spool n'est pas trouvée
Format de la valeur : littéral de script

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

NORMAL = Le Job AE se poursuit.
ABEND = Le Job AE se termine anormalement.

MAXLINES=

Nombre maximal de lignes écrites dans le fichier
Format de la valeur : Entier

Valeur par défaut : 9999

Ce paramètre n'est pas pris en compte lors de l'utilisation de FORMAT = "PDF" ou "BIN".

SPOOLNR=

Numéro de la requête de spool
Format de la valeur : littéral de script

Si NAME, JOBCOUNT ou SPOOLNR ne sont pas définis, le système utilise systématiquement le dernier job SAP qui a été traité via le job AE.

FORMAT=

Format de sortie
Format de la valeur : littéral de script

Valeurs autorisées : "TXT" (valeur par défaut), "RAW" (au lieu de paramètre RAW), "PDF", "BIN" et "HTM"

Si les paramètres "BIN" et "PDF" sont utilisés, la liste de spool n'est pas convertie et est transférée au format binaire.

PAGES=

Pages
Format de la valeur : littéral de script

Syntaxe du paramètre : PAGES=Page[;Page[;...]]

Vous devez séparer les pages et les plages de pages indiquées par le signe ";".

Exemples :

  • page 7 : PAGES="7"
  • pages 5 à 7 : PAGES="5,7"
  • page 2 et pages 5 à 7 : PAGES="2;5,7"

Pour indiquer la dernière page, vous pouvez utiliser le symbole $ :

  • pages 1 à 3 et dernière page : PAGES="1,3;$"
  • toutes les pages : PAGES="1,$"
  • la première et la dernière page : PAGES="1;$"
  • les deux dernières pages : PAGES="$-1,$"

Les paramètres FORMAT (sauf PDF), SPOOLNR et PAGES sont aussi disponibles pour l'interface XBP 3.0 (à partir de la version 1.1).

FILTER=

Paramètre de Filtre
Format de la valeur : littéral de script

Chaîne de caractères utilisée pour effectuer la sélection. Il n'est pas possible de saisir des caractères génériques.

RAW=

Ce paramètre fournit la liste de spool au format brut.
Format de la valeur : littéral de script

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

"YES" : la liste de spool est fournie au format brut, c'est-à-dire avec tous les caractères d'édition.
"NO" : la liste spool n'est pas au format brut.

Il est recommandé d'utiliser FORMAT=RAW au lieu de ce paramètre.

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.

Commentaires

Le script peut être utilisé avec les combinaisons de paramètres suivantes :

Le paramètre FILTER nécessite l'interface AE et le paramètre RAW nécessite l'interface par défaut.

La liste de spool ne peut être transférée que si vous n'avez pas coché la case "Supprimer le Job après exécution dans CCMS" dans l'ongletAttributs de l'hôte. Cette limitation n'est pas valable si le paramètre SPOOLNR a été spécifié ou si l'interface standard XBP 3.0 (à partir de la version 1.1) est utilisée sans les paramètres NAME, JOBCOUNT et SPOOLNR.

Veuillez tenir compte de la remarque suivante lors de l'utilisation de l'interface par défaut avec une version inférieure à XBP 3.0 V1.1 :
interface standard : c'est toujours l'intégralité de la liste de spool qui est transférée à l'agent SAP.
La fonction standard de l'interface XBP ne permet pas à l'utilisateur d'accéder à des parties de la liste de spool. Notez que les longues listes de spool peuvent réduire les performances de l'agent SAP. Le paramètre MAXLINES= est seulement pris en compte quand toute la liste de spool a été transférée.

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 l'exemple, un rapport est activé au préalable. Ensuite, la liste de spool du step est récupérée sans indiquer le nom du job ou le numéro du job en paramètres. Le dernier job qui a été démarré par l'agent est utilisé automatiquement.

R3_ACTIVATE_REPORT REPORT='RSPO0041',VAR='STANDARD',COVERPAGE=YES
R3_GET_JOB_SPOOL FILE='c:\temp\spoollist.txt',NOFOUND=ABEND,MAXLINES=20

 

Rubriques connexes :