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

R3_ACTIVATE_JOBS

Exécute des Jobs déjà planifiés dans SAP sous le contrôle de l'Automation Engine. Les Jobs à démarrer sont déterminés par le biais d'une sélection.

Transaction : SM37

Interface : UC4 et Standard

Interface

[UC4] [Valeur par défaut]

Syntaxe

R3_ACTIVATE_JOB[S]

NAME=...
[,JOBCOUNT=...]
[,GROUP=...]
[,USER=...]
[,NOFOUND=...]
[,ERROR=...]
[,SELECT=...]
[,START=...]
[,NEW_NAME=...]
[,START_D[ATE]=...]
[,START_T[IME]=...]
[,END_D[ATE]=...]
[,END_T[IME]=...]
[,TARGET_S[ERVER]=...]
[,BEG_LOGLINES=...]
[,END_LOGLINES=...]
[,GET_SPOOL=...]

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 

Le nom et le numéro permettent d'identifier chaque 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

Le nom et le numéro permettent d'identifier chaque 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 : "*"

NOFOUND=

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

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.

ERROR=

Comportement adopté si un Job parmi ceux sélectionnés se termine de façon anormale
Format: Littéral de script

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

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

SELECT=

Sélection unique ou permanente
Format : Littéral de script

Valeurs autorisées : "ONCE" (valeur par défaut) et "EVERY"

"ONCE" = Le nombre de correspondances (= nombre de Jobs à lancer) est déterminé une seule fois.
"EVERY" - Le nombre de correspondances est déterminé à chaque libération de Job. Cette technique permet la mise en parallèle des Jobs lancés.

START=

Le système doit-il démarrer l'original ou une copie du Job
Format : Littéral de script

Valeurs autorisées : "ORIGINAL" (Valeur par défaut) et "DUPLICATE"

NEW_NAME=

Nom du Job démarré en tant que copie
Format : Littéral de script

Ce paramètre n'est analysé que si START=DUPLICATE a été indiqué. Si l'original du Job doit être démarré, le paramètre est ignoré.

START_D[ATE]=

Date de début de la sélection des Jobs planifiés.
Format : Littéral de script

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

Si ce paramètre est utilisé sans le paramètre END_DATE, tous les Jobs planifiés à partir de la date de début indiquée sont sélectionnés et démarrés.

START_T[IME]=

Heure de début de la sélection des Jobs planifiés.
Format : Littéral de script

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

Si ce paramètre est utilisé sans le paramètre END_TIME, tous les Jobs planifiés à partir de l'heure de début indiquée sont sélectionnés et démarrés. L'heure de fin est 23:59.

END_D[ATE]=

Date de fin de la sélection des Jobs planifiés.
Format : Littéral de script

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

Pour sélectionner tous les Jobs planifiés pour un jour donné, indiquez pour ce paramètre la même date que pour START_DATE=.

END_T[IME]=

Date de fin de la sélection des Jobs planifiés.
Format : Littéral de script

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

Pour sélectionner tous les Jobs planifiés pour un jour donné, indiquez pour ce paramètre la même date que pour START_DATE=.

TARGET_S[ERVER]= Système cible que doit utiliser le Job SAP lancé
Format : Littéral de script

Valeurs autorisées : "KEEP" (valeur par défaut) et "ATTRIBUTE"

"KEEP" - Le système cible saisi dans l'original du Job est gardé.
"ATTRIBUTE" - Le système cible issu des attributs de l'hôte est utilisé.

BEG_LOGLINES= Définit le nombre de lignes qui doivent être reprises depuis le début du log du Job SAP dans le rapport de Job.
END_LOGLINES=

Nombre de lignes à la fin du log du Job SAP qui sont écrites dans le rapport de Job.

Si le paramètre END_LOGLINES ou BEG_LOGLINES est indiqué, l'intégralité du rapport de Job est utilisée par défaut. Si seul un paramètre est affiché, alors seules les lignes du début ou de la fin du rapport de Job sont lues.
Si "0" est la valeur indiquée pour les deux paramètres, aucun log de Job n'est indiqué.

Seules des valeurs numériques sont autorisées pour les deux paramètres.

GET_SPOOL=

Demander la liste Spool du Job démarré
Format de la valeur : Littéral de script

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

"YES" = Demander la liste Spool. Celle-ci est enregistrée en tant que fichier texte dans le répertoire que vous définissez dans le fichier INI de l'Agent SAP avec le paramètre Download_dir= (section [GLOBAL]). Le nom de ce fichier se compose de la manière suivante :
<SAP-Job-Count>_<Numéro d'étape>_<Numéro de Spool>.txt
Ce fichier est en plus enregistré comme résultat de Job dans le Job.

"NO" = La liste Spool n'est pas demandée

Exemple

Libérer tous les Jobs prévus de l'Utilisateur SAP "NI".

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='NI'

Dans le second exemple, tous les Jobs planifiés entre le 01.07.2001 à 00:00:00 et le 02.07.2001 à 23:59:59 sont sélectionnés et démarrés.

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20010701',END_DATE='20010702'

Dans le second exemple, tous les Jobs planifiés entre le 01.07.2001 à 12:30:00 et le 02.07.2001 à 12:30:00 sont sélectionnés et démarrés.

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20010701', START_TIME='123000',END_DATE='20010702',END_TIME='123000'


Interface par défaut

[UC4] [Valeur par défaut]

Syntaxe

R3_ACTIVATE_JOB[S]

NAME=...
[,JOBCOUNT=...]
[,NOFOUND=...]
[,ERROR=...]
[,SELECT=...]
[,START=...]
[,NEW_NAME=...]
[,START_D[ATE]=...]
[,START_T[IME]=...]
[,END_D[ATE]=...]
[,END_T[IME]=...]
[,TARGET_S[ERVER]=...]
[,MON[ITOR]=...]
[,WAIT=...]
[,ABORTED=...]
[,REPL[ICATE]=...]
[,BEG_LOGLINES=...]
[,END_LOGLINES=...]
[,GET_SPOOL=...]

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 

Le nom et le numéro permettent d'identifier chaque 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

Le nom et le numéro permettent d'identifier chaque Job SAP de manière univoque.

NOFOUND=

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

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.

ERROR=

Comportement adopté si un Job parmi ceux sélectionnés se termine de façon anormale
Format: Littéral de script

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

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

SELECT=

Sélection unique ou permanente
Format : Littéral de script

Valeurs autorisées : "ONCE" (valeur par défaut) et "EVERY"

"ONCE" = Le nombre de correspondances (= nombre de Jobs à lancer) est déterminé une seule fois.
"EVERY" - Le nombre de correspondances est déterminé à chaque libération de Job. Cette technique permet la mise en parallèle des Jobs lancés.

START=

Le système doit-il démarrer l'original ou une copie du Job
Format : Littéral de script

Valeurs autorisées : "ORIGINAL" (Valeur par défaut) et "DUPLICATE"

NEW_NAME=

Nom du Job démarré en tant que copie
Format : Littéral de script

Ce paramètre n'est analysé que si START=DUPLICATE a été indiqué. Si l'original du Job doit être démarré, le paramètre est ignoré.

START_D[ATE]=

Date de début de la sélection des Jobs planifiés.
Format : Littéral de script

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

Si ce paramètre est utilisé sans le paramètre END_DATE, tous les Jobs planifiés à partir de la date de début indiquée sont sélectionnés et démarrés.

START_T[IME]=

Heure de début de la sélection des Jobs planifiés.
Format : Littéral de script

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

Si ce paramètre est utilisé sans le paramètre END_TIME, tous les Jobs planifiés à partir de l'heure de début indiquée sont sélectionnés et démarrés. L'heure de fin est 23:59.

END_D[ATE]=

Date de fin de la sélection des Jobs planifiés.
Format : Littéral de script

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

Pour sélectionner tous les Jobs planifiés pour un jour donné, indiquez pour ce paramètre la même date que pour START_DATE=.

END_T[IME]=

Date de fin de la sélection des Jobs planifiés.
Format : Littéral de script

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

Pour sélectionner tous les Jobs planifiés pour un jour donné, indiquez pour ce paramètre la même date que pour START_DATE=.

TARGET_S[ERVER]= Système cible que doit utiliser le Job SAP lancé
Format : Littéral de script

Valeurs autorisées : "KEEP" (valeur par défaut) et "ATTRIBUTE"

"KEEP" - Le système cible saisi dans l'original du Job est gardé.
"ATTRIBUTE" - Le système cible issu des attributs de l'hôte est utilisé.

MON[ITOR]=

Suivi du statut dans le protocole d'activation
Format : Littéral de script

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

WAIT=

Attente de la fin du processus enfant d'un Job SAP
Format de la valeur : Littéral de script ou Nom AE

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

"YES" = Le système attend la fin de tous les processus enfant. Les processus enfant seront inclus dans le protocole d'activation.
"NO" = Le système n'attend pas la fin de tous les processus enfant.

ABORTED=

Attente de la fin anormale du processus enfant d'un Job SAP
Format de la valeur : Littéral de script ou Nom AE

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

"YES" = Le Job SAP (parent) est interrompu. Le script est interrompu et le Job se termine de façon anormale.  
"NO" = Le Job SAP (parent) n'est pas interrompu. Le script se poursuit et le Job se termine normalement.

REPL[ICATE]=

Traitement des processus enfant d'un Job
Format de la valeur : Littéral de script

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

"YES" = Les processus enfant d'un Job sont répliqués dans le système AE. Ils sont affichés dans la Fenêtre d'Activités de l'Interface Utilisateur. De plus, le système AE crée des statistiques et des rapports.
"NO" - Pas de réplication dans le système AE.

BEG_LOGLINES= Définit le nombre de lignes qui doivent être reprises depuis le début du log du Job SAP dans le rapport de Job.
END_LOGLINES=

Nombre de lignes à la fin du log du Job SAP qui sont écrites dans le rapport de Job.

Si le paramètre END_LOGLINES ou BEG_LOGLINES est indiqué, l'intégralité du rapport de Job est utilisée par défaut. Si seul un paramètre est affiché, alors seules les lignes du début ou de la fin du rapport de Job sont lues.
Si "0" est la valeur indiquée pour les deux paramètres, aucun log de Job n'est indiqué.

Seules des valeurs numériques sont autorisées pour les deux paramètres.

GET_SPOOL=

Demander la liste Spool du Job démarré
Format de la valeur : Littéral de script

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

"YES" = Demander la liste Spool. Celle-ci est enregistrée en tant que fichier texte dans le répertoire que vous définissez dans le fichier INI de l'Agent SAP avec le paramètre Download_dir= (section [GLOBAL]). Le nom de ce fichier se compose de la manière suivante :
Par ailleurs, ce fichier est enregistré comme résultat de Job dans le Job.

"NO" = La liste Spool n'est pas demandée

Exemple 

Tous les Jobs planifiés portant le nom "REORG_SPOOL" sont lancés.

R3_ACTIVATE_JOBS NAME='REORG_SPOOL',NOFOUND=ABEND

 

Rubriques connexes :