TFRGRPJOB

Transférer à travail de groupe

En bref

La commande TFRGRPJOB (Transférer à travail de groupe) interrompt l'exécution du travail qui la lance ; le travail de groupe indiqué au paramètre GRPJOB ( Travail de groupe ) est repris (s'il existait) ou créé (s'il n'existait pas).

TFRGRPJOB se lit TFR (Transférer) + GRPJOB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

TFRGRPJOB

Paramètres

GRPJOB Travail de groupe
INLGRPPGM Programme initial de groupe
SPCENV Environnement spécial
RSTDSP Réaffichage
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez TFRGRPJOB 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 TFRGRPJOB (Transférer à travail de groupe) interrompt l'exécution du travail qui la lance ; le travail de groupe indiqué au paramètre GRPJOB (Travail de groupe) est repris (s'il existait) ou créé (s'il n'existait pas). Dans les deux cas, le travail indiqué par le paramètre GRPJOB prend le contrôle. Le travail qui lance la commande TFRGRPJOB est interrompu jusqu'à ce que le contrôle lui soit rendu et que l'exécution soit reprise.

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit *USE sur le programme de groupe initial et du droit *EXECUTE sur la bibliothèque qui contient ce programme.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
GRPJOB	Travail de groupe	Nom, PRV, SELECT	Facultatif, positionnel 1
INLGRPPGM	Programme initial de groupe	Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1: Programme initial de groupe	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SPCENV	Environnement spécial	DFT, INLGRPPGM, S36, NONE	Facultatif
RSTDSP	Réaffichage	NO, YES	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif

Travail de groupe (GRPJOB)

Indique le travail de groupe auquel le contrôle est transféré.

*PRV: Le contrôle est transféré au précédent travail actif du groupe. S'il n'existe plus, l'exécution du dernier travail actif est reprise. Cette valeur n'est admise que s'il existe un autre travail de groupe dans le groupe.
*SELECT: L'écran Transfert à travail de groupe est affiché. Vous pouvez choisir un travail de groupe ou en créer un nouveau.
nom: Indiquez le nom du travail de groupe auquel le contrôle est transféré.

Programme initial de groupe (INLGRPPGM)

Indiquez le nom du premier programme du travail de groupe. Ce paramètre n'est pris en compte que si un travail de groupe est créé. Si le travail de groupe existe déjà, ce paramètre est ignoré.

Qualificatif 1 : Programme initial de groupe

nom: Indiquez le nom du premier programme du travail de groupe.

Qualificatif 2 : Biblio

*LIBL: La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques jusqu'à ce qu'une occurrence soit trouvée.
*CURLIB: Le programme est recherché dans la bibliothèque en cours de l'unité d'exécution. Si la bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom: Indiquez la bibliothèque contenant le programme.

Environnement spécial (SPCENV)

Indique l'environnement dans lequel démarre le travail de groupe. Ce paramètre est admis uniquement lorsque cette commande crée un travail de groupe. Si le contrôle est transféré à un groupe existant, ce paramètre n'est pas pris en compte.

*DFT

Le groupe de travail démarre dans l'environnement d'exécution de la commande. Le groupe de travail démarre en environnement IBM 36 si l'une des conditions suivantes se vérifie :

L'environnement IBM 36 est actif dans le travail dans lequel cette commande est exécutée.
Le profil utilisateur indique que l'utilisateur travaille en environnement IBM 36 et que le premier programme appelé dans le travail de groupe est QCMD.

*INLGRPPGM

Le nouveau groupe démarre dans l'environnement déterminé par le premier groupe appelé dans travail de groupe. Si le premier programme de groupe est QCMD, l'environnement est déterminé par la valeur d'environnement spécial définie dans le profil utilisateur.

*S36

Le nouveau groupe démarre en environnement IBM 36.

*NONE

Le nouveau groupe ne démarre pas dans un environnement spécial.

Réaffichage (RSTDSP)

Indique si les données affichées sur une unité écran par ce fichier écran sont sauvegardées lorsque ce fichier est suspendu (temporairement inactif) de sorte qu'un autre fichier écran puisse être utilisé pour afficher d'autres données sur la même unité.

*NO: Les données affichées par ce fichier ne sont pas sauvegardées lorsque celui-ci est suspendu.
*YES: Les données affichées lorsque le fichier est suspendu sont sauvegardées pour pouvoir être restaurées à l'écran lorsque le fichier est de nouveau utilisé.

Texte 'descriptif' (TEXT)

Définit la description du travail de groupe. Ce paramètre n'est pris en compte que si un travail de groupe est créé. Si le travail de groupe existe déjà, ce paramètre est ignoré.

*BLANK: Le texte est à blanc.
valeur-caractère: Indiquez, entre apostrophes, un texte de 50 caractères au maximum, si nécessaire.

Exemples

TFRGRPJOB   GRPJOB(GROUPJ1)  INLGRPPGM(QGPL/PROGRAM1)

Cette commande permet de suspendre l'exécution du travail en cours. Si le travail de groupe GROUPJ1 existe déjà, son exécution reprend à l'endroit où elle avait été interrompue (commande en langage évolué suivant la demande TFRGRPJOB).

Si le travail de groupe GROUPJ1 n'existe pas, il est créé et il exécute le programme PROGRAM1 dans la bibliothèque QGPL.

Messages d'erreur

Messages *ESCAPE

CPF1E15: Une erreur s'est produite lors de l'appel d'Assistant.
CPF1310: La commande TFRGRPJOB a échoué. Code raison : &1.
CPF1313: La valeur &1 du paramètre &2 n'est pas un nom correct.
CPF1314: Valeur &1 non admise pour le paramètre &2.
CPF9871: Erreur lors du traitement.