TFRBCHJOB

La commande TFRBCHJOB (Transférer un travail par lots) permet de transférer un travail par lots dans la file d'attente de travaux indiquée. Il n'est pas nécessaire que la file d'attente soit déjà allouée à un sous-système actif lors du transfert. Le travail transféré est celui qui contient la commande. La donnée de routage et la donnée demande peuvent être définies lors du transfert. La donnée de routage est traitée dans le sous-système comportant la file d'attente de travaux active ; la donnée demande est placée à la suite d'autres données demande pour le travail. Le travail transféré reprend le traitement de la donnée demande après le transfert.

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.
2. Le travail en cours de transfert doit être un travail par lots démarré à partir d'une file d'attente de travaux.
3. La commande TFRBCHJOB ne doit pas s'exécuter dans un travail de communication par lots (c'est-à-dire un travail par lots démarré à la suite d'une demande de démarrage de programme) ou dans un travail immédiat par traitement par lots.

Remarques :

1. L'exécution de cette commande 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 vous travaillez en environnement IBM 36, la commande TFRBCHJOB ne permet pas de transférer cet environnement à la nouvelle phase d'activation.
3. 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.
4. Si la commande TFRBCHJOB est émise dans un programme CL, toutes les commandes suivantes sont ignorées.
5. Un travail par lots transféré à une file d'attente de travaux par la commande TFRBCHJOB continue d'exister après un IPL s'il se trouvait dans la file d'attente de travaux lors de l'arrêt du système et que la file d'attente de travaux n'est pas un ASP indépendant. Les objets temporaires d'un travail par lots sont supprimés lors de la mise hors tension du système.
6. La bibliothèque QTEMP d'un travail par lots transféré à l'aide de la commande TFRBCHJOB est toujours vide lors du lancement de la nouvelle phase d'activation. Lorsqu'un travail par lots est transféré vers une file d'attente de travaux par la commande TFRBCHJOB, des précautions doivent être prises pour la liste de bibliothèques. La fonction TFRBCHJOB sauvegarde la liste de bibliothèques pour récupérer le travail dans la file d'attente lorsqu'un IPL est effectué. Lorsque la phase d'activation du travail par lots transféré est lancée, les bibliothèques de la liste sauvegardée doivent se trouver sur le système. Dans le cas contraire, la phase d'activation du travail s'arrête.

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 requis.

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.

QCMDB

Cette donnée de routage correspond à un poste de routage de la description de sous-système fournie par IBM, qui démarre une phase d'activation traitée par le processeur de langage de contrôle QCMD fourni par IBM.

*RQSDTA

Les 80 premiers caractères de la donnée demande définie dans le paramètre RQSDTA de la commande sert de donnée de routage pour cette 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

TFRBCHJOB   JOBQ(QGPL/APPLICQ)  RTGDTA(APPLICS)

Cette commande permet de transférer le travail par lots dans lequel la commande a été émise 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. Le travail doit être un travail par lots.

Messages d'erreur

Messages *ESCAPE

CPF1288

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

CPF1289

Transfert du travail non admis.

CPF1291

Le travail &3/&2/&1 ne peut pas être transféré.

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.

CPF1375

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

CPF1376

Une bibliothèque de la liste de recherche est supprimée.

CPF1377

Une bibliothèque de la liste de recherche est endommagée.