Aller au contenu

BCHJOB

Début de travail par lots

En bref

La commande BCHJPB (Début de travail par lots) indique le début d'un travail dans un flot de travaux par lots en entrée.

Syntaxe minimale

BCHJOB

Paramètres

  • JOB Travail
  • JOBD Description de travail
  • JOBQ File d'attente de travaux
  • PRTDEV Unité imprimante
  • OUTQ File d'attente en sortie
  • JOBPTY Priorité du travail (en JOBQ)
  • OUTPTY Priorité de sortie (en OUTQ)
  • PRTTXT Texte à imprimer
  • RTGDTA Donnée de routage
  • RQSDTA Donnée demande ou commande
  • SYNTAX Vérification de syntaxe CL
  • CURLIB Bibliothèque en cours
  • INLLIBL Liste bibliothèques initiale
  • ENDSEV Niveau gravité pour arrêt
  • LOG Consignation des messages
  • LOGCLPGM Consigner cdes programme CL
  • INQMSGRPY Réponse message interrogation
  • HOLD Suspendre en file de travaux
  • DATE Date du travail
  • SWS Indicateurs externes
  • MSGQ File attente messages
  • SRTSEQ Séquence de tri
  • LANGID Identificateur de langue
  • CNTRYID ID pays ou région
  • CCSID ID codé de jeu de caractères
  • JOBMSGQMX Taille maxi file messages trav
  • JOBMSGQFL Action file msg trav saturée

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

  • Travail batch (*BATCH)
Compatible multitâche : Non

La commande BCHJPB (Début de travail par lots) indique le début d'un travail dans un flot de travaux par lots en entrée. La valeur des attributs définis dans la commande peut différer de celle indiquée dans la description de travail ou dans le profil utilisateur de ce travail. Pour la plupart des paramètres omis dans la commande, c'est la valeur indiquée dans la description de travail ou le profil utilisateur spécifié dans cette description qui est pris en compte.

Restrictions :

L'utilisateur qui lance la commande STRDBDR (Démarrer un lecteur BD), SBMDBJOB (Soumettre des travaux BD), STRDKTRDR (Démarrer un lecteur disquette) ou SBMDKTJOB (Soumettre travaux disquette) est considéré comme l'utilisateur qui lance la commande BCHJOB.

  1. Pour lancer cette commande, l'utilisateur qui lance la commande BCHJOB doit disposer des droits suivants :
    • Droit d'utilisation (*USE) sur la description de travail (JOBD) et droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette description de travail.
    • Droit d'utilisation (*USE) sur la file d'attente de travaux JOBQ et droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette file d'attente de travaux.
    • Droit d'utilisation (*USE) sur toutes les bibliothèques indiquées pour la valeur système QSYSLIBL, le paramètre CURLIB (Bibliothèque en cours) et le paramètre INLLIBL (Liste bibliothèques initiale).
    • Droit d'utilisation (*USE) et droit d'ajout (*ADD) sur la file d'attente de messages (MSGQ) et droit d'exécution (*EXECUTE) sur la bibliothèque contenant la file d'attente de messages.
    • Droit d'utilisation (*USE) sur le profil utilisateur indiqué dans la description de travail.
    • Droit d'exécution (*EXECUTE) sur toutes les descriptions d'unité dans le groupe d'ASP de l'espace de nom du travail.
  2. L'utilisateur indiqué dans la description du travail soumis doit disposer des droits suivants :
    • Droit d'utilisation (*USE) sur la description de travail (JOBD).
    • Droit *READ sur la file d'attente en sortie (OUTQ) et droit *EXECUTE sur la bibliothèque contenant cette file d'attente en sortie.
    • Droit d'utilisation (*USE) sur toutes les bibliothèques indiquées pour la valeur système QSYSLIBL, le paramètre CURLIB (Bibliothèque en cours) et le paramètre INLLIBL (Liste bibliothèques initiale).
    • Droit d'utilisation (*USE) sur la table de séquence de tri (SRTSEQ) et droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette table de séquence de tri.
    • Droit d'utilisation (*USE) sur toutes les descriptions d'unité indiquées dans le paramètre INLASPGRO (Groupe ASP initial) de la description de travail .
  3. La commande BCHJOB ne peut pas être utilisée à partir d'un poste de travail.
  4. Vous devez placer deux barres obliques devant la commande lorsque vous la tapez dans l'enregistrement de données : //BCHJOB ou // BCHJOB. (Vous pouvez séparer les barres obliques de la commande en insérant des espaces).
  5. La valeur en cours du groupe d'ASP pour l'unité d'exécution qui lance la commande SBMDBJOB (Soumettre des travaux BD) ou SBMDKTJOB (Soumettre travaux disquette) est utilisée pour le paramètre du groupe d'ASP initial du travail par lots soumis. De la même manière, la valeur en cours du groupe d'ASP pour l'unité d'exécution qui lance la commande STRDBRDR (Démarrer un lecteur BD) ou STRDKTRDR (Démarrer un lecteur disquette) est utilisée pour le paramètre du groupe d'ASP initial du travail du lecteur de spoule et celui du travail par lots soumis. La valeur du groupe d'ASP initial indiquée dans la description du travail est ignorée. Le traitement de la commande BCHJOB et des fonctions du lecteur de spoule, telles que la vérification de syntaxe, doit s'exécuter dans l'espace de nom utilisé par le travail par lots.

Paramètres

Mot-clé Description Valeurs possibles Remarques
JOB Travail Nom, *JOBD Facultatif, positionnel 1
JOBD Description de travail Nom d'objet qualifié Facultatif, positionnel 2
Qualificatif 1: Description de travail Nom, QBATCH
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
JOBQ File d'attente de travaux Valeurs uniques: *RDR, *JOBD
Autres valeurs: Nom d'objet qualifié
Facultatif, positionnel 3
Qualificatif 1: File d'attente de travaux Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
PRTDEV Unité imprimante Nom, *USRPRF, *SYSVAL, *JOBD Facultatif
OUTQ File d'attente en sortie Valeurs uniques: *USRPRF, *DEV, *JOBD
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: File d'attente en sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
JOBPTY Priorité du travail (en JOBQ) 1-9, *JOBD Facultatif, positionnel 4
OUTPTY Priorité de sortie (en OUTQ) 1-9, *JOBD Facultatif, positionnel 5
PRTTXT Texte à imprimer Valeur caractère, *JOBD, *BLANK, *SYSVAL Facultatif
RTGDTA Donnée de routage Valeur caractère, QCMDB, *JOBD, *RQSDTA Facultatif
RQSDTA Donnée demande ou commande Valeur caractère, *, *JOBD, *NONE, *RTGDTA Facultatif
SYNTAX Vérification de syntaxe CL 0-99, *JOBD, *NOCHK Facultatif
CURLIB Bibliothèque en cours Nom, *USRPRF, *CRTDFT Facultatif
INLLIBL Liste bibliothèques initiale Valeurs uniques: *JOBD, *SYSVAL, *NONE
Autres valeurs (jusqu'à 25 répétitions): Nom
Facultatif
ENDSEV Niveau gravité pour arrêt 0-99, *JOBD Facultatif
LOG Consignation des messages Liste d'éléments Facultatif
Élément 1: Niveau 0-4, *JOBD
Élément 2: Filtre de gravité 0-99, *JOBD
Élément 3: Texte *JOBD, *MSG, *SECLVL, *NOLIST
LOGCLPGM Consigner cdes programme CL *JOBD, *NO, *YES Facultatif
INQMSGRPY Réponse message interrogation *JOBD, *RQD, *DFT, *SYSRPYL Facultatif
HOLD Suspendre en file de travaux *JOBD, *NO, *YES Facultatif
DATE Date du travail Date, *JOBD, *SYSVAL Facultatif
SWS Indicateurs externes Valeur caractère, *JOBD Facultatif
MSGQ File attente messages Valeurs uniques: *NONE, *USRPRF
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: File attente messages Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
SRTSEQ Séquence de tri Valeurs uniques: *USRPRF, *SYSVAL, *HEX, *LANGIDUNQ, *LANGIDSHR
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: Séquence de tri Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
LANGID Identificateur de langue Valeur caractère, *USRPRF, *SYSVAL Facultatif
CNTRYID ID pays ou région Valeur caractère, *USRPRF, *SYSVAL Facultatif
CCSID ID codé de jeu de caractères 1-65535, *USRPRF, *SYSVAL, *HEX Facultatif
JOBMSGQMX Taille maxi file messages trav 2-64, *JOBD, *SYSVAL Facultatif
JOBMSGQFL Action file msg trav saturée *JOBD, *SYSVAL, *NOWRAP, *WRAP, *PRTWRAP Facultatif

Travail (JOB)

Indique le nom associé au travail traité.

*JOBD
Le nom du travail est celui de la description de travail.
nom
Indiquez le nom utilisé pour le travail lors du traitement.

Description de travail (JOBD)

Indique la description du travail utilisée avec le travail.

Qualificatif 1 : Description de travail

QBATCH
La description de travail QBATCH, fournie par IBM dans la bibliothèque QGPL, est utilisée pour ce travail. QGPL doit se trouver dans la liste des bibliothèques utilisée par le lecteur de spoule pour lire les données en entrée du travail.
nom
Indiquez le nom de la description de travail.

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. Si le paramètre INLLIBL (Liste bibliothèques initiale) indique *JOBD, la liste des bibliothèques utilisée pour trouver la description de travail est la liste des bibliothèques de l'unité d'exécution dans laquelle la commande BCHJOB est en cours d'exécution. Si le paramètre INLLIBL indique une autre valeur que *JOBD, la liste des bibliothèques utilisée pour trouver la description de travail contient les bibliothèques mentionnées dans la valeur système QSYSLIBL et les bibliothèques indiquées dans le paramètre INLLIBL.
*CURLIB
Si le paramètre INLLIBL indique *JOBD, la liste des bibliothèques utilisée pour trouver la description de travail est la liste des bibliothèques pour l'unité d'exécution dans laquelle la commande BCHJOB est en cours d'exécution. La recherche porte sur la bibliothèque en cours de la liste des bibliothèques. Si aucune bibliothèque n'est indiquée comme étant la bibliothèque en cours pour la liste de bibliothèque, la bibliothèque QGPL est utilisée. Si le paramètre INLLIBL indique une autre valeur que *JOBD, la bibliothèque QGPL est utilisée car la liste des bibliothèques utilisée pour trouver la description de bibliothèque n'est pas dotée d'une bibliothèque en cours.
nom
Indiquez la bibliothèque contenant la description de travail.

File d'attente de travaux (JOBQ)

Indique le nom de la file d'attente de travaux dans laquelle le travail est placé.

Valeurs uniques

*RDR
Le système utilise la file d'attente de travaux indiquée dans la commande STRDBRDR (Démarrer un lecteur BD), SBMDBJOB (Soumettre des travaux BD), STRDKTRDR (Démarrer un lecteur disquette) ou SBMDKTJOB (Soumettre travaux disquette) qui lit ce travail.
*JOBD
Le système utilise la file d'attente désignée dans la description de travail.

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 du nouveau travail jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
La file d'attente est recherchée dans la bibliothèque en cours du nouveau travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom
Indiquez la bibliothèque contenant la file d'attente de travaux.

Unité imprimante (PRTDEV)

Indique le nom de l'unité imprimante par défaut utilisée pour ce travail.

*USRPRF
Le nom d'imprimante indiqué dans le profil utilisateur du travail est utilisée. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail). Le système recherche le nom de l'imprimante dans le profil, lors de l'exécution de la commande.
*SYSVAL
L'imprimante utilisée est celle indiquée dans la valeur système QPRTDEV lors de l'exécution de la commande.
*JOBD
L'imprimante utilisée est celle indiquée dans la description de travail.
nom
Indiquez le nom de l'imprimante à utiliser pour ce travail.

File d'attente en sortie (OUTQ)

Indique la file d'attente en sortie utilisée par défaut pour ce travail. Ce paramètre est admis uniquement pour les fichiers imprimante dans lesquels *JOB est défini pour les files d'attente en sortie.

Valeurs uniques

*USRPRF
La file d'attente en sortie indiquée dans le profil utilisateur du travail est utilisée. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail). Le système recherche le nom de la file d'attente, dans le profil, lors de l'exécution de la commande.
*DEV
Le système utilise la file d'attente en sortie associée à l'imprimante du fichier spoule.
*JOBD
La file d'attente en sortie indiquée dans la description de travail est utilisée avec ce travail.

Qualificatif 1 : File d'attente en sortie

nom
Indiquez le nom de la file d'attente en sortie.

Qualificatif 2 : Biblio

*LIBL
La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques du nouveau travail jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
La file d'attente est recherchée dans la bibliothèque en cours du nouveau travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom
Indiquez la bibliothèque contenant la file d'attente en sortie.

Priorité du travail (en JOBQ) (JOBPTY)

Indique la priorité de soumission dans la file d'attente. La priorité la plus élevée est 1 et la moins élevée 9.

*JOBD
Le système utilise le niveau de priorité indiqué dans la description de travail.
1-9
Indiquez le niveau de priorité.

Priorité de sortie (en OUTQ) (OUTPTY)

Indique la priorité de sortie pour les fichiers spoule en sortie produits par ce travail. Les valeurs admises vont de 1 à 9, 1 étant le niveau de priorité le plus élevé, 9, le plus faible.

*JOBD
Le système utilise le niveau de priorité de sortie indiqué dans la description de travail.
1-9
Indiquez le niveau de priorité des fichiers de sortie de ce travail.

Texte à imprimer (PRTTXT)

Indique le texte imprimé au bas de chaque page de la sortie imprimée et sur les pages intercalaires.

*JOBD
Le système utilise la valeur définie dans la description de travail.
*BLANK
Aucun texte n'est imprimé.
*SYSVAL
Le texte à imprimer est déterminé à partir de la valeur système QPRTTXT.
valeur-caractère
Indiquez la chaîne de caractères à imprimer au bas de chaque page (30 caractères au maximum, placés entre apostrophes si nécessaire).

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
Le système utilise la donnée de routage employée par le sous-système de traitement par lots fourni par IBM pour router les travaux par lots vers le processeur de langage de contrôle QCMD fourni par IBM.
*JOBD
Le système utilise la donnée de routage définie dans la description de travail.
*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.
valeur-caractère
Indiquez la chaîne de caractères utilisée comme donnée de routage pour démarrer la première 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.

*
Les données entrées à la suite de cette commande sont insérées dans la file d'attente de messages du travail en tant que donnée demande. Il peut s'agir, par exemple, d'une suite de commandes CL constituant le travail.
*JOBD
La donnée demande définie dans la description de travail est placée à la fin de la file d'attente de messages du travail.
*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) de cette commande est placée à la fin de la file d'attente de messages du travail.
valeur-caractère
Indiquez la chaîne de caractères devant constituer le dernier poste de la file d'attente de messages du travail (256 caractères au maximum, placés entre apostrophes si nécessaire).

Vérification de syntaxe CL (SYNTAX)

Indique si la syntaxe des commandes CL en file d'attente de messages doit être vérifiée. Si c'est le cas, la vérification se fait à la soumission des commandes et non lors de l'exécution du travail, ce qui permet une détection précoce des erreurs. Ce paramètre n'est utilisé que si un astérisque (*) est indiqué pour le paramètre RQSDTA (Donnée demande ou commande).

Restrictions :

  • Les commandes STRDBRDR (Démarrer un lecteur BD) et STRDKTRDR (Démarrer un lecteur disquette) prennent en charge la fonction de vérification de syntaxe. Cela permet de vérifier les droits sur les commandes.
  • L'utilisateur doit disposer du droit d'utilisation (*USE) sur la commande et du droit d'exécution (*EXECUTION) sur la bibliothèque contenant cette commande.
*JOBD
C'est la valeur indiquée dans la description de travail qui détermine si la syntaxe de la donnée demande doit être vérifiée et, le cas échéant, le niveau de gravité à utiliser pour les messages.
*NOCHK
La syntaxe de la donnée demande n'est pas vérifiée.
0-99
Indiquez le niveau de priorité le plus faible qui entraîne l'arrêt du traitement. La syntaxe de la donnée demande est vérifiée. Si une erreur de syntaxe apparaît avec un niveau de gravité inférieur ou égal à la valeur indiquée, le traitement du travail contenant la commande erronée est arrêté.

Bibliothèque en cours (CURLIB)

Indique quelle bibliothèque en cours est associée au travail en cours.

*USRPRF
La bibliothèque en cours, pour ce travail par lots, est celle définie dans le profil utilisateur. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail).
*CRTDFT
Il n'existe pas de bibliothèque en cours pour le travail. Si des objets sont créés dans la bibliothèque en cours, QGPL est utilisée par défaut.
nom
Entrez la bibliothèque en cours pour le travail par lots.

Liste bibliothèques initiale (INLLIBL)

Indique la partie utilisateur initiale de la liste des bibliothèques dans laquelle sont recherchés les noms d'objets qui ont été indiqués sans qualificatif de bibliothèque.

Remarque :La duplication des noms de bibliothèque dans la liste des bibliothèques n'est pas admise.

Valeurs uniques

*JOBD
La liste des bibliothèques utilisateur indiquée dans la description de travail est utilisée comme valeur initiale de la liste des bibliothèques utilisateur.
*SYSVAL
Le travail utilise la liste des bibliothèques utilisateur par défaut donnée par le système. Cette liste comporte les noms des bibliothèques définis dans la valeur système QUSRLIBL au lancement du travail.
*NONE
La partie utilisateur, de la liste initiale des bibliothèques, est vide.

Autres valeurs (jusqu'à 25 répétitions)

nom
Indiquez le nom d'une ou de plusieurs bibliothèques qui constitueront la partie utilisateur de la liste des bibliothèques utilisée par le travail. La recherche s'effectue dans l'ordre dans lequel figurent les bibliothèques dans la liste.

Niveau gravité pour arrêt (ENDSEV)

Indique à partir de quel niveau de gravité un message d'arrêt programme peut entraîner l'arrêt d'un travail par lots. Le travail est arrêté lorsqu'un message d'arrêt de gravité supérieure à ce niveau parvient au programme de traitement de la demande, via le flot d'entrée.

*JOBD
C'est le code gravité défini dans la description de travail qui est pris en compte.
0-99
Entrez le code de gravité d'un message d'arrêt programme reçu à la suite d'une demande émise dans le flot de données en entrée qui provoquera l'arrêt du travail. Indiquez un code inférieur ou égal à 50, 50 étant la valeur maximale pour un message d'arrêt programme envoyé aux utilisateurs. Tout message d'arrêt non traité et de gravité supérieure ou égale à la valeur indiquée provoque l'arrêt du travail.

Consignation des messages (LOG)

Indique les valeurs de consignation de message utilisées pour déterminer la quantité et le type des informations placées dans l'historique du travail. Ce paramètre comporte trois éléments : le niveau de consignation, la gravité et le niveau de texte des messages.

Elément 1 : Niveau

*JOBD
Le système utilise la valeur définie pour le niveau de consignation des messages dans la description de travail.
0-4
Indique le niveau de consignation des messages utilisé pour ce travail. Il existe cinq niveaux :
0
Aucun message n'est consigné.
1
Tous les messages envoyés dans la file d'attente de messages externe du travail qui sont affectés d'un niveau de gravité supérieur ou égal à la valeur indiquée sont consignés. Sont inclus les messages de début, d'arrêt et d'achèvement du travail.
2
Les informations suivantes sont consignées :
  • informations de niveau 1,
  • messages de demande donnant lieu à l'émission d'un message de haut niveau dont le code de gravité est supérieur ou égal à la gravité de consignation définie. Le message de demande ainsi que tous les messages associés sont consignés.

Remarque :Un message de haut niveau est un message envoyé dans la file d'attente de messages du programme qui reçoit la demande. Par exemple, QCMD est un programme de traitement des demandes fourni par IBM qui reçoit des messages de demande.

3
Les informations suivantes sont consignées :
  • informations de niveau 1 et 2,
  • tous les messages de demande
  • les commandes exécutées par un programme CL sont consignées si les valeurs de consignation de l'attribut de travail et de l'attribut de consignation du programme l'admettent.
4
Les informations suivantes sont consignées :
  • tous les messages de demande et tous les messages dont le niveau de gravité est supérieur ou égal au niveau de gravité de consignation de messages défini, y compris les messages de trace,
  • les commandes exécutées par un programme CL sont consignées si les valeurs de consignation de l'attribut de travail et de l'attribut de consignation du programme l'admettent.

Elément 2 : Filtre de gravité

*JOBD
Le système utilise la valeur définie pour le niveau de consignation des messages dans la description de travail.
0-99
Indiquez le niveau de gravité à utiliser avec le niveau de consignation pour déterminer les messages d'erreur à consigner dans l'historique du travail.

Elément 3 : Texte

*JOBD
Le système utilise la valeur indiquée pour le texte du message dans la description du travail.
*MSG
Seul le texte du message est enregistré dans l'historique.
*SECLVL
Le texte de message et l'aide sur le message (sections Cause et Que faire) du message d'erreur sont écrits dans l'historique du travail.
*NOLIST
Si le travail se termine normalement, aucun historique du travail n'est généré. L'historique du travail n'est généré qu'en cas de fin anormale du travail (code de fin de travail égal ou supérieur à 20). Les messages qui s'affichent dans l'historique du travail contiennent à la fois le texte du message et l'aide correspondante.

Consigner cdes programme CL (LOGCLPGM)

Indique si les commandes exécutées dans un programme en langage de contrôle (CL) sont consignées dans l'historique du travail via la file d'attente de messages du programme CL. Ce paramètre détermine l'état de l'indicateur de consignation du travail. Si *JOB a été indiqué à l'invite Consignation des messages (paramètre LOG) dans la commande CRTCLPGM (Créer un programme CL), l'indicateur défini à l'invite Consigner cdes programme CL (paramètre LOGCLPGM) est utilisé. Les autres valeurs de l'invite Consignation des messages (paramètre LOG) se substituent aux valeurs de l'invite Consigner cdes programme CL (paramètre LOGCLPGM). Les commandes sont consignées de la même façon que les demandes.

*JOBD
C'est la valeur indiquée dans la description de travail qui est prise en compte.
*NO
Les commandes de programme CL ne sont pas consignées dans l'historique du travail.
*YES
Les commandes de programme CL sont consignées dans l'historique du travail.

Réponse message interrogation (INQMSGRPY)

Indique le mode de réponse aux messages prédéfinis envoyés à la suite de l'exécution de ce travail. Vous pouvez déterminer que le contrôle des réponses des messages d'interrogation est issu de la description du travail, que tous les messages d'interrogation reçoivent une réponse ou qu'une réponse par défaut est émise, ou encore qu'une réponse appropriée est recherchée dans la liste des réponses du système à chaque envoi de message d'interrogation prédéfini.

*JOBD
C'est la valeur définie dans la description de travail qui détermine la réponse à donner aux messages d'interrogation.
*RQD
Toute personne recevant un message d'interrogation lors de l'exécution du travail doit y répondre.
*DFT
La réponse par défaut du message est envoyée pour tout message d'interrogation émis lors de l'exécution du travail.
*SYSRPYL
Le système vérifie, dans la liste de réponse système, si l'exécution de ce travail a déjà provoqué l'émission d'un message d'interrogation avec un identificateur et, éventuellement, une donnée de comparaison identiques. Si c'est le cas, il utilise la réponse faite précédemment. Sinon, une réponse au message est requise.

Suspendre en file de travaux (HOLD)

Indique si le travail était suspendu quand il a été placé en file d'attente. Un travail demeure suspendu, jusqu'à ce qu'il soit libéré par la commande RSLJOB ( Libérer un travail) ou arrêté par la commande ENDJOB (Arrêter un travail) ou CLRJOBQ (Mettre à blanc une file d'attente de travaux).

*JOBD
C'est la valeur définie dans la description de travail qui détermine si le travail est suspendu lorsqu'il est placé dans la file d'attente de travaux.
*NO
Le travail n'est pas suspendu lorsqu'il est placé en file d'attente.
*YES
Le travail est suspendu lorsqu'il est placé en file d'attente, et ce jusqu'à ce qu'il soit libéré ou arrêté.

Date du travail (DATE)

Indique la date attribuée au travail lors du démarrage de celui-ci.

*JOBD
La date du travail est la date définie dans la description de travail.
*SYSVAL
La date du travail est celle de la valeur système QDATE au démarrage du travail.
date
Indiquez la date de travail à utiliser, au démarrage du travail. Cette date doit être saisie suivant le format défini par l'attribut DATFMT du travail.

Indicateurs externes (SWS)

Indique l'état initial des huit indicateurs externes du travail. Ces indicateurs peuvent être testés ou définis dans un programme CL ; ils permettent de contrôler le flot du programme. Les indicateurs ne peuvent prendre que les valeurs 1 (actif) ou 0 (inactif), que vous pouvez préciser dans la chaîne de 8 caractères.

*JOBD
C'est la valeur indiquée dans la description de travail qui définit l'état initial des indicateurs externes.
valeur-caractère
Indiquez l'état initial des indicateurs externes du travail (combinaison de huit chiffres, de valeur 0 ou 1).

File attente messages (MSGQ)

Indique la file d'attente de messages dans laquelle le message d'achèvement est envoyé lorsque le travail soumis est terminé, que la fin soit normale ou anormale. En cas de fin anormale, l'aide associée au message précise les causes possibles de l'incident.

Valeurs uniques

*NONE
Aucun message d'achèvement n'est envoyé.
*USRPRF
Le système utilise la file d'attente de messages définie dans le profil de l'utilisateur ayant soumis le travail.

Qualificatif 1 : File attente messages

nom
Indiquez le nom de la file d'attente de messages où le message d'achèvement doit être envoyé.

Qualificatif 2 : Biblio

*LIBL
La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques du nouveau travail jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
La file d'attente est recherchée dans la bibliothèque en cours du nouveau travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom
Indiquez la bibliothèque contenant la file d'attente de messages.

Séquence de tri (SRTSEQ)

Indique la table de séquence de tri à utiliser pour effectuer des comparaisons de chaînes pour ce travail.

Valeurs uniques

*USRPRF
La table de séquence de tri indiquée dans le profil utilisateur du travail est utilisée. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail).
*SYSVAL
La valeur système QSRTSEQ est utilisée.
*HEX
Aucune table de séquence de tri n'est utilisée. Les valeurs hexadécimales des caractères sont utilisées pour déterminer la séquence de tri.
*LANGIDUNQ
Une table de tri à poids uniques est utilisée.
*LANGIDSHR
Une table de tri à poids partagés est utilisée.

Qualificatif 1 : Séquence de tri

nom
Indiquez le nom de la table de séquence de tri.

Qualificatif 2 : Biblio

*LIBL
La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques du nouveau travail jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
La recherche est effectuée dans la bibliothèque en cours du nouveau travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom
Indiquez la bibliothèque contenant la table de séquence de tri.

Identificateur de langue (LANGID)

Indique l'identificateur de langue à associer à ce travail. L'identificateur de langue est utilisé lorsque *LANGIDUNQ or *LANGIDSHR est indiqué avec le paramètre SRTSEQ (Séquence de tri). Si l'ID codé de jeu de caractères (CCSID) du travail est 65535, ce paramètre est également utilisé pour déterminer la valeur du CCSID par défaut du travail (DFTCCSID).

*USRPRF
L'identificateur de langue indiqué dans le profil utilisateur du travail est utilisé. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail).
*SYSVAL
La valeur système QLANGID est utilisée.
valeur-caractère
Indiquez l'identificateur de langue qui sera utilisé par le travail.

ID pays ou région (CNTRYID)

Indique l'identificateur de pays ou région qui sera utilisé par le travail.

*USRPRF
L'identificateur de pays ou région indiqué dans le profil utilisateur du travail est utilisé. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail).
*SYSVAL
La valeur système QCNTRYID est utilisée.
valeur-caractère
Indiquez l'identificateur de pays ou région qui sera utilisé par le travail.

ID codé de jeu de caractères (CCSID)

Indique l'identificateur codé de jeu de caractères devant être utilisé pour ce travail.

*USRPRF
Le CCSID indiqué dans le profil utilisateur du travail est utilisé. Le profil utilisateur est défini dans la description de travail, qui est indiquée avec le paramètre JOBD (Description de travail).
*SYSVAL
Le CCSID utilisé est celui indiqué pour la valeur système QCCSID.
*HEX
Le CCSID 65535 est utilisé.
1-65535
Indiquez le CCSID.

Taille maxi file messages trav (JOBMSGQMX)

Indique la taille maximale de la file d'attente de messages du travail.

*JOBD
La valeur indiquée dans la description de travail détermine la taille maximale de la file d'attente de messages du travail.
SYSVAL
La valeur système QJOBMSGQMX détermine, au moment du démarrage du travail, la taille maximale de la file d'attente de messages de ce dernier.
2-64
Indiquez la taille maximale (en Mo) de la file d'attente de messages de ce travail.

Action file msg trav saturée (JOBMSGQFL)

Indique l'action à entreprendre lorsque la file d'attente de messages du travail est saturée.

*JOBD
La valeur indiquée dans la description de travail détermine l'action à entreprendre.
*SYSVAL
La valeur système QJOBMSGQFL est utilisée.
*NOWRAP
La file d'attente de messages ne boucle pas lorsqu'elle est saturée. Le travail est arrêté.
*WRAP
La file d'attente de messages boucle lorsqu'elle est saturée et elle se remplit à nouveau.
*PRTWRAP
La file d'attente de messages boucle lorsqu'elle est saturée et les messages qui vont ainsi être écrasés sont imprimés.

Exemples

Exemple 1 : Recherche de messages d'interrogation dans la liste des réponses système

BCHJOB   JOBD(PAYROLL)  INQMSGRPY(*SYSRPYL)

Cette commande permet de lancer un travail par lots appelé PAYROLL. Un message d'interrogation envoyé (à la suite de l'exécution de ce travail) et associé à un poste de la liste des réponses système reçoit une réponse définie en fonction de la réponse figurant dans cette liste. Pour un message d'interrogation qui n'est pas représenté dans la liste de réponses, une réponse est requise.

Le nom du travail correspond à celui de la description de travail utilisée avec le travail. La liste des bibliothèques de l'unité d'exécution dans laquelle la commande BCHJOB est traitée est utilisée pour localiser la description de travail PAYROLL. Le groupe d'ASP de l'unité d'exécution dans laquelle la commande BCHJOB est traitée est utilisé comme groupe d'ASP initial du nouveau travail. Les valeurs des autres attributs proviennent de la description de travail PAYROLL ou du profil utilisateur indiqué dans cette description de travail.

Exemple 2 : Définition des indicateurs externes

BCHJOB   JOBD(QGPL/QBATCH)  JOB(PAYROLL)  JOBQ(BATCH2)
         INLLIBL(PAYLIB) SWS(00101100)  DATE(010188)

Cette commande permet de lancer un travail par lots appelé PAYROLL et exécuté à l'aide des attributs indiqués dans la description de travail fournie par IBM pour les travaux par lots, QBATCH. Le travail est placé dans la file d'attente de travaux BATCH2. La bibliothèque PAYLIB est la seule bibliothèque utilisateur de la liste de bibliothèques. Des indicateurs externes sont définis pour être utilisés dans le travail et la date définie correspond au 1er janvier 1988.

Exemple 3 : Définition des niveaux de gravité

BCHJOB   JOBD(COMPILE)  JOBPTY(5)  SYNTAX(10)
         INLLIBL(MYCMDS)  ENDSEV(40)

Cette commande permet de lancer un travail par lots appelé COMPILE. Le travail est exécuté à l'aide de tous les attributs indiqués dans la description de travail COMPILE, à l'exception du groupe d'ASP initial et des paramètres définis par cette commande. La bibliothèque MYCMDS est la seule bibliothèque utilisateur de la liste qui est utilisée lors de la vérification de la syntaxe des commandes ou de leur exécution. Les erreurs de syntaxe associées à une valeur supérieure ou égale à 10 entraînent l'arrêt du traitement du travail. Le travail est associé à la priorité de soumission 5 et s'exécute tant le système ne détecte pas d'erreurs entraînant l'envoi d'un message d'arrêt programme associé à un niveau de gravité supérieur ou égal à 40.

Messages d'erreur

Messages *ESCAPE

CPF1374
Commande BCHJOB incorrecte dans cet environnement.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.