TFRJOB

La commande TFRJOB (Transférer un travail) permet de transférer un travail à la file d'attente de travaux indiquée. C'est le travail qui lance la commande qui est transféré. S'il est interactif, il est affecté, dans la file d'attente de travaux, du niveau de priorité le plus élevé. Au moment du transfert, de nouvelles données demande et de routage peuvent être définies pour le travail.

Si les objets alloués à la phase d'activation précédente sont nécessaires dans la nouvelle, ils doivent être alloués une nouvelle fois. Si les objets ouverts dans la phase d'activation précédente sont nécessaires dans la nouvelle, ils doivent être rouverts.

Restrictions :

1. Pour utiliser cette commande, vous devez disposer des droits suivants :
   • Droit d'utilisation (*USE) sur la file d'attente de travaux et droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette file d'attente de travaux.
   • Droit *USE sur la description de sous-système associée au sous-système auquel la file d'attente de travaux a été allouée. Cette restriction s'applique uniquement si le travail en cours de transfert est un travail interactif.
2. Si le travail transféré est un travail interactif, les restrictions suivantes s'appliquent :
   • La file d'attente de travaux dans laquelle le travail est placé doit être associée à un sous-système actif.
   • Le poste de travail associé au travail doit disposer du poste "poste de travail"correspondant dans la description de sous-système associée au nouveau sous-système.
   • Le poste de travail associé au travail ne doit pas être associé à un autre travail suspendu par le biais de la touche Syst Attn (Appel système). Le travail suspendu doit être annulé pour permettre l'exécution de la commande commande TFRJOB.
   • Le travail ne doit pas être un travail de groupe.
3. Le travail ne doit pas être un travail de communication par lots (démarré à la suite d'un demande de démarrage de programme) sauf s'il répond à l'un des critères suivants :
   • Le travail a été lancé à partir d'une unité de communication APPC.
   • La session de l'unité de communication est arrêtée.

Remarques :

1. L'exécution de cette commande dans un travail par lots entraîne la perte des fichiers spoule en entrée car ceux-ci ne sont plus accessibles dans la nouvelle phase d'activation.
2. Si le sous-système cible est arrêté (via la commande ENDSBS (Arrêter un sous-système), la commande ENDSYST (Arrêter le système) ou la commande PWRDWNSYS Mettre le système hors tension) lorsqu'un travail interactif transféré se trouve dans une file d'attente de travaux, le travail est annulé lors de l'arrêt du sous-système.
3. Comme la commande PWRDWNSYS empêche les sous-systèmes de démarrer de nouveaux travaux ou de nouvelles phases d'activation, un travail par lots transféré dans une file d'attente de travaux (à l'aide de la commande TFRJOB) n'est pas traité avant la mise en tension du système.
4. Les objets temporaires associés au travail transféré (tels que la liste de bibliothèques, la bibliothèque QTEMP et tous les objets qu'elle contient) sont supprimés au cours de l'exécution de la commande PWRDWNSYS afin que le système ne puisse pas restaurer le travail dans son état précédent lors d'un IPL. Lors de l'IPL, le système enlève le travail de la file d'attente et génère l'historique du travail correspondant.
5. Si la commande TFRJOB est émise dans un programme CL, toutes les commandes suivantes sont ignorées.
6. Lorsque la nouvelle phase d'activation est démarrée, l'utilisateur en cours doit disposer du droit *USE sur la description du sous-système dans lequel la phase d'activation s'exécute.

Paramètres

File d'attente de travaux (JOBQ)

Indique le nom qualifié de la file d'attente de travaux à laquelle le travail est transféré.

Ce paramètre est obligatoire.

Qualificatif 1 : File d'attente de travaux

nom

Indiquez le nom de la file d'attente de travaux.

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 la file d'attente de travaux.

Donnée de routage (RTGDTA)

Indique les données de routage utilisées pour démarrer la phase d'activation suivante du travail. Ces données permettent de déterminer le poste de routage identifiant le programme exécuté par le travail.

QCMDI

Cette donnée de routage correspond à un poste de routage défini dans les descriptions de sous-système, fournies par IBM, qui démarre une phase d'activation traitée par le processeur de langage de contrôle QCMD fourni par IBM, dans la bibliothèque QSYS.

*RQSDTA

Les 80 premiers caractères de la données demande indiquée dans le paramètre(RQSDTA) (Donnée demande ou commande) de cette commande sont également utilisés comme donnée de routage pour la phase d'activation.

valeur-caractère

Indiquez la chaîne de caractères utilisée comme donnée de routage pour démarrer la phase d'activation (80 caractères au maximum, placés entre apostrophes si nécessaire).

Donnée demande ou commande (RQSDTA)

Indique les données de demande constituant le dernier poste de la file d'attente de messages du travail. Il peut s'agir d'une commande CL à exécuter ou d'une chaîne de caractères utilisée par un autre programme.

*NONE

Aucune donnée demande n'est placée dans la file d'attente de messages du travail.

*RTGDTA

La donnée de routage indiquée dans le paramètre RTGDTA (Donnée de routage) est également placée à la fin de la file d'attente de messages du travail.

valeur-caractère

Indiquez la chaîne de caractères à placer à la fin de la file d'attente de messages du travail pour la nouvelle phase d'activation ou les phases suivantes du travail (256 caractères au maximum, placés entre apostrophes si nécessaire).

Exemples

TFRJOB   JOBQ(QGPL/APPLICQ)  RTGDTA(APPLICS)

Cette commande permet de transférer le travail qui a émis la commande dans la file d'attente de travaux APPLICQ de la bibliothèque QGPL. Le travail est acheminé à l'aide de la donnée de routage APPLICS. S'il s'agit d'un travail interactif, la file d'attente de travaux doit être allouée par un sous-système actif.

Messages d'erreur

Messages *ESCAPE

CPF1289

Transfert du travail non admis.

CPF1315

La commande &1 n'est pas admise dans cet environnement.

CPF1357

Travail non transféré.

CPF1364

Travail non transféré. File d'attente de travaux &1 de &2 non active.

CPF1365

Travail non transféré. Sous-système &1 en cours d'arrêt.

CPF1366

Le sous-système &1 n'a aucun poste écran pour &2.

CPF1367

&1 non autorisé à utiliser le sous-système &2.

CPF1368

&1 non autorisé à la file d'attente de travaux &2 de &3.

CPF1369

File d'attente de travaux &1 de &2 non trouvée.

CPF1370

File d'attente de travaux &1 de &2 inaccessible.

CPF1372

Travail non transféré. En cours d'arrêt.

CPF1373

Travail non transféré. Appel système en cours pour le travail.

CPF1375

Travail non transféré. Impossible de transférer le seul travail actif.