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

R3_IMPORT_JOBS

Importe les Jobs de SAP dans le système AE.

Interface : L'Automation Engine et Standard

Syntaxe

R3_IMPORT_JOBS

[SINGLE_JOBS=...]
[,WORKFLOWS=...]
[,JOB_NAME=...]
[,LOGIN_NAME=...]
[,WORKFLOW_NAME=...]
[,EXTENSION=...]
[,LOGINS=...]
[,HOST=...]
[,QUEUE=...]
[,DEPENDENCY_STATE=...]
[,DEPENDENCY_ELSE_ACTION=...]
[,DEPENDENCY_ELSE_ALARM=...]
[,EXT_COMMAND=...]
[,EXT_PROGRAM=...]
[,LOGIN_FOLDER=...]
[,JOB_FOLDER=...]
[,WORKFLOW_FOLDER=...]
[,OVERRIDE=...]
[,JOB_TEMPLATE=...]
[,WORKFLOW_TEMPLATE=...]

Dans les valeurs de certains paramètres, il est possible de saisir des caractères de remplacement spécifiques commençant et se terminant par le caractère % (par exemple : %SID%). Sur la valeur par défaut des paramètres, vous pouvez voir si des caractères de remplacement peuvent être utilisés et si oui, lesquels. Vous trouverez une liste expliquant les caractères de remplacement en dessous de la table de syntaxe.

Elément de syntaxe

Description/format

SINGLE_JOBS= 

Comportement permettant de savoir si un objet Job doit être créé pour chaque Step de Job.
Format : Littéral de script ou Nom AE 

Valeurs autorisées : "YES" (valeur par défaut) ou "NO"
"YES" - Créer un objet Job propre à chaque fonction R3_*.
"NO" - Les objets Job créés peuvent également contenir plusieurs fonctions R3_*.

WORKFLOWS= 

Créer des Workflows pour les Jobs importés
Format : Littéral de script ou Nom AE

Valeurs autorisées : "" (valeur par défaut), "1" ou "2"
"" - Ne pas créer d'objet Workflow
"1" - Créer des Workflows pour tous les Jobs importés
"2" - Seuls des Workflows sont créés pour les Jobs qui possèdent plusieurs Steps.

JOB_NAME= 

Schéma d'attribution de nom pour les objets Job créés
Format : Littéral de script ou Nom AE

Valeur par défaut :
JOBS.%SID%.%CLIENT%@%JOBNAME%
LOGINS=

Créer des objets Login

Valeurs autorisées : "" (valeur par défaut), "1" ou "2"
"" - Ne pas générer d'objet Login.
"1" - Créer des objets Login. Le nom de l'Agent est saisi dans l'objet.
"2" - Créer des objets Login. Le caractère "*" est saisi dans l'objet à la place du nom de l'Agent.

LOGIN_NAME= 

Schéma d'attribution de nom pour les objets Login importés
Format : Littéral de script ou Nom AE

Valeur par défaut :
LOGIN.%SID%.%CLIENT%@%USER% 

WORKFLOW_NAME=

Schéma d'attribution de nom pour les objets Workflow créés
Format : Littéral de script ou Nom AE

Valeur par défaut :
JOBP.%SID%.%CLIENT%@%JOBNAME%

EXTENSION=

Extension pour le nom d'objet des Jobs créés par Step.
Format : Littéral de script ou Nom AE

Ce paramètre est uniquement important si SINGLE_JOBS est défini sur la valeur YES.

Valeur par défaut :
%STEP%

HOST=

Attribut de l'Agent du Job créé
Format : Littéral de script ou Nom AE

Valeur par défaut :
%SID%

QUEUE=

Attribut de la Queue du Job créé
Format : Littéral de script ou Nom AE

Valeur par défaut :
CLIENT_QUEUE

DEPENDENCY_STATE=

Statut attendu devant être saisi dans le Workflow, dans les propriétés du Job (dépendances)
Format : Littéral de script ou Nom AE

Uniquement important si des Workflows sont créés.

Valeur par défaut :
ANY_OK

DEPENDENCY_ELSE_ACTION=

Instruction Sinon pour les dépendances du Job dans le Workflow (propriétés des tâches)
Format : Littéral de script ou Nom AE

Uniquement important si des Workflows sont créés.

Valeurs autorisées : "" (valeur par défaut), "ABORT", "BLOCK", "BLOCK_ABORT" ou "SKIP"
"" - Valeur du modèle de Workflow
"ABORT" - Interrompre la tâche et le Workflow
"BLOCK" - Le Workflow se bloque à la tâche correspondante
"BLOCK_ABORT" - Le Workflow se bloque à la tâche et envoie un signal d'interruption à un Workflow parent (si existant)
"SKIP" - Ignorer la tâche

DEPENDENCY_ELSE_ALARM=

Nom d'un objet devant être exécuté si les dépendances du Job ne sont pas remplies dans le Workflow (propriétés des tâches)
Format : Littéral de script ou Nom AE

Uniquement important si des Workflows sont créés.

EXT_COMMAND=

Inclure les Steps de commande externes
Format : Littéral de script ou Nom AE

Valeurs autorisées : "YES" (inclure) ou "NO" (ne pas inclure, valeur par défaut)

EXT_PROGRAM=

Inclure les Steps de programme externes
Format : Littéral de script ou Nom AE

Valeurs autorisées : "YES" (inclure) ou "NO" (ne pas inclure, valeur par défaut)

LOGIN_FOLDER=

Chemin du dossier dans le client AE dans lequel les objets Login créés sont enregistrés
Format : Littéral de script ou Nom AE

Valeur par défaut :
<Défaut>

JOB_FOLDER=

Chemin du dossier dans le client AE dans lequel les objets Job créés sont enregistrés
Format : Littéral de script ou Nom AE

Valeur par défaut :
<Défaut>

WORKFLOW_FOLDER=

Chemin du dossier dans le client AE dans lequel les objets Workflow créés sont enregistrés
Format : Littéral de script ou Nom AE

Valeur par défaut :
<Défaut>

OVERRIDE=

Réécrire les objets existants
Format : Littéral de script ou Nom AE

Valeurs autorisées :"YES" (valeur par défaut) ou "NO"
"YES" - Réécrire les objets
"NO" - Les objets portant le même nom ne sont pas remplacés.

JOB_TEMPLATE=

Nom d'un objet Job SAP devant être utilisé comme base pour la création du Job.
Format : Littéral de script ou Nom AE

Valeur par défaut : "JOBS.SAP"

WORKFLOW_TEMPLATE=

Nom d'un objet Workflow (Workflow standard) devant être utilisé comme base pour la création du Workflow.
Format : Littéral de script ou Nom AE

Valeur par défaut : "JOBP"

Caractère de remplacement des valeurs de paramètre :

La casse des caractères dans l'écriture des paramètres n'est pas importante.

Description

L'élément de script permet d'appliquer des Jobs du SAP dans le système AE sous forme d'objets Job. Le système SAP et le client SAP auquel l'Agent SAP est connecté et sur lequel l'élément de script R3_IMPORT_JOBS est exécuté sont utilisés.

Une sélection des Jobs à importer est requise avec l'élément de script R3_GET_JOBS avant la fonction R3_IMPORT_JOBS. Tous les Jobs SAP qui ont été sélectionnés avec R3_GET_JOBS sont chargés dans le système AE comme objets Job. Une interruption se produit si aucune sélection n'est exécutée avant l'appel de R3_IMPORT_JOBS.

Par ailleurs, il est possible de créer des objets Workflow et Login pour les Jobs. Ce paramètre est contrôlable avec les paramètres LOGIN* et WORKFLOW* (voir ci-dessus).

Les Jobs sont ajoutés aux Workflows créés et les dépendances dans les propriétés du Workflow sont ensuite définies (paramètre DEPENDENCY*=). Les Workflows peuvent être créés soit pour tous les Jobs, soit pour les Jobs avec plusieurs Steps.

Exemple

Dans l'exemple suivant, tous les Jobs dont le nom commence par "TEST" sont sélectionnés dans SAP et appliqués dans le système AE.

R3_GET_JOBS NAME="TEST*",USER="MEIER"
R3_IMPORT_JOBS JOB_NAME='JOBS.UC4.%JOBNAME%.%STEP%'

 

Rubriques connexes :

Généralités sur le JCL SAP