ENDGRPJOB

Arrêter un travail de groupe

En bref

La commande ENDGRPJOB (Arrêter un travail de groupe) permet d'arrêter un travail donné au sein d'un groupe et de reprendre l'exécution d'un autre travail du même groupe.

ENDGRPJOB se lit END (Arrêter) + GRPJOB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDGRPJOB

Paramètres

GRPJOB Travail de groupe
RSMGRPJOB Travail de groupe à reprendre
LOG Historique du travail

Astuce : dans une session 5250, tapez ENDGRPJOB puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande ENDGRPJOB (Arrêter un travail de groupe) permet d'arrêter un travail donné au sein d'un groupe et de reprendre l'exécution d'un autre travail du même groupe. Vous pouvez préciser les informations suivantes :

le nom du travail à arrêter,
le nom du travail auquel le contrôle est transmis (uniquement si l'arrêt du travail est déclenché par le travail lui-même),
la création éventuelle d'un historique pour le travail arrêté.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
GRPJOB	Travail de groupe	Nom, *	Facultatif, positionnel 1
RSMGRPJOB	Travail de groupe à reprendre	Nom, *PRV	Facultatif
LOG	Historique du travail	NOLIST, LIST	Facultatif

Travail de groupe (GRPJOB)

Indique le nom du travail de groupe à arrêter.

*: Le travail de groupe qui a émis cette commande est arrêté.
nom: Indiquez le travail de groupe contenant le travail à arrêter.

Travail de groupe à reprendre (RSMGRPJOB)

Indique le travail à exécuter, une fois le travail actif arrêté. Ce paramètre n'est admis que lorsque le travail qui a émis la commande s'arrête lui-même.

*PRV: Le traitement du dernier travail de groupe actif reprend.
nom: Indiquez le travail à exécuter, une fois le travail actif arrêté.

Historique du travail (LOG)

Indique si l'historique du travail de groupe à arrêter doit être généré.

*NOLIST: Les informations de l'historique ne sont pas placées dans une file d'attente en sortie.
*LIST: Les informations de l'historique sont placées dans une file d'attente en sortie.

Exemples

Exemple 1 : Arrêt du travail de groupe qui a émis la commande

ENDGRPJOB   GRPJOB(*)  LOG(*LIST)  RSMGRPJOB(GROUPJOB1)

Cette commande permet d'arrêter le travail en cours d'exécution. L'historique du travail est placé en file d'attente pour impression. A l'issue de l'exécution du travail, le travail de groupe GROUPJOB1 devient le travail actif du groupe.

Exemple 2 : Impression de la sortie d'un travail terminé

ENDGRPJOB   GRPJOB(GROUPJOB2)  LOG(*LIST)

Supposons que le travail qui émet la commande ENDGRPJOB soit le travail de groupe GROUPJOB1, qui veut arrêter le travail de groupe GROUPJOB2. Le travail GROUPJOB2 s'arrête. L'historique du travail est placé en file d'attente pour impression.

Exemple 3 : Arrêt d'un travail faisant partie d'une session alternée

ENDGRPJOB   GRPJOB(*)  LOG(*NOLIST)

Supposons que le travail qui émet la commande ENDGRPJOB soit le seul travail du groupe et qu'il fasse partie d'une session alternée. Le travail qui émet la commande s'arrête. L'historique du travail n'est pas placé en file d'attente dans un fichier de sortie. Lorsque le travail s'arrête, l'autre travail de la session alternée reprend.

Messages d'erreur

Messages *ESCAPE

CPF1309: Le sous-système ne peut pas achever la commande &1.
CPF1314: Valeur &1 non admise pour le paramètre &2.
CPF1317: Aucune réponse du sous-système pour le travail &3/&2/&1.
CPF1322: Commande ENDGRPJOB non admise actuellement.
CPF1323: Travail de groupe &1 non arrêté : paramètres incompatibles.
CPF1324: Travail de groupe &1 non arrêté : paramètres incompatibles.
CPF1325: Travail de groupe &1 non arrêté : le travail de groupe &2 n'existe pas.
CPF1326: Le travail de groupe &1 n'existe pas.
CPF1327: Le travail de groupe &1 ne peut plus être arrêté par ENDGRPJOB.
CPF1351: Erreur dans le sous-système pour le travail &3/&2/&1.