TFRCTL

Transférer contrôle à pgm

En bref

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

Syntaxe minimale

TFRCTL PGM(…)

Paramètres

PGM Programme obligatoire
PARM Noms variables CL paramètres

Astuce : dans une session 5250, tapez TFRCTL 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 :

Programme batch (*BPGM)
Programme interactif (*IPGM)

Compatible multitâche : Oui

La commande TFRCTL (Transférer le contrôle à un programme) permet d'appeler le programme indiqué, de lui passer le contrôle et d'enlever le programme effectuant le transfert de la liste de retour. Puisque ce programme est enlevé de la liste d'appel, le programme appelé ne restitue pas le contrôle au programme à l'origine du transfert lorsqu'il rend le contrôle. De cette façon, le contrôle est transféré à la commande suivant le dernier appel au programme de transfert.

Restrictions :

Cette commande est admise uniquement dans les programmes CL OPM (modèle de programmation de base).
Vous devez disposer des droits *OBJOPR (opération sur les objets) et *EXECUTE (droits d'exécution) pour le programme à appeler et des droits *EXECUTE pour la bibliothèque dans laquelle figure le programme.
La commande TFRCTL prend en charge les unités d'exécution multiples, c'est-à-dire qu'elle peut être utilisée pour appeler un programme lorsqu'elle s'exécute dans un travail comportant plusieurs unités d'exécution. Aucune vérification n'est effectuée, que le programme à appeler prenne en charge les unités d'exécution multiples ou non.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PGM	Programme	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Programme	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
PARM	Noms variables CL paramètres	Values (jusqu'à 255 répétitions): CL variable name	Facultatif, positionnel 2

Programme (PGM)

Indique le programme recevant le contrôle en provenance du programme à l'origine du transfert.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom: Indiquez le nom du programme.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le programme est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque contenant le programme.

Noms variables CL paramètres (PARM)

Indique une ou de plusieurs variables CL à transmettre au programme devant recevoir le contrôle. Il ne peut s'agir que de variables correspondant à des paramètres qui ont eux-mêmes été passés au programme effectuant le transfert de contrôle.

nom-variable-CL: Indiquez le nom de la variable CL à transmettre. Vous pouvez indiquer jusqu'à 255 variables.

Exemples

TFRCTL   PGM(PROGA)  PARM(&PARM1)

Cette commande transfère le contrôle au programme PROGA et y intègre le paramètre &PARM1. Le paramètre &PARM1 doit avoir été préalablement transféré au programme émetteur de la commande.

Messages d'erreur

Messages *ESCAPE

CPF0805: Erreur lors de l'appel du programme &1 de &2.
CPF0809: Le transfert de contrôle (TFRCTL) à un programme C n'est pas admis.