CHGJOBD
Modifier description travail
En bref
La commande Modifier description travail CHGJOBD (Modifier une description de travail) permet de modifier les attributs de travail définis pour un objet description de travail.
CHGJOBD se lit CHG
(Modifier) + JOBD.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGJOBD JOBD(…)
Paramètres
-
JOBDDescription de travail obligatoire -
JOBQFile d'attente de travaux -
JOBPTYPriorité du travail (en JOBQ) -
OUTPTYPriorité de sortie (en OUTQ) -
PRTDEVUnité imprimante -
OUTQFile d'attente en sortie -
TEXTTexte 'descriptif' -
USERUtilisat -
ACGCDECode comptabilité -
PRTTXTTexte à imprimer -
RTGDTADonnée de routage -
RQSDTADonnée demande ou commande -
INLLIBLListe bibliothèques initiale -
INLASPGRPGroupe ASP initial -
LOGConsignation des messages -
LOGCLPGMConsigner cdes programme CL -
LOGOUTPUTSortie historique du travail -
JOBMSGQMXTaille maxi file messages trav -
JOBMSGQFLAction file msg trav saturée -
SYNTAXVérification de syntaxe CL -
ENDSEVNiveau gravité pour arrêt -
INQMSGRPYRéponse message interrogation -
HOLDSuspendre en file de travaux -
DATEDate du travail -
SWSIndicateurs externes -
DEVRCYACNAction rétablissement unité -
TSEPOOLPool fin de tranche de temps -
ALWMLTTHDUnités exéc multiples admises -
SPLFACNAction de fichier spoule -
DDMCNVConversation DDM -
WLCGRPGroupe de charge de travail
Astuce : dans une session 5250, tapez CHGJOBD 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 : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande Modifier description travail CHGJOBD (Modifier une description de travail) permet de modifier les attributs de travail définis pour un objet description de travail. Chaque attribut peut être modifié, à l'exception de l'attribut relatif aux droits. Pour plus de détails sur les modifications des droits sur un objet, reportez-vous aux commandes Révoquer droits sur un objet RVKOBJAUT (Révoquer les droits sur un objet) et Accorder droits sur un objet GRTOBJAUT (Accorder des droits sur un objet).
Restrictions :
- Pour utiliser cette commande, vous devez détenir les droits suivants :
- les droits opérationnels sur les objets (*OBJOPR), de gestion des objets (*OBJMGT) et de lecture (*READ) sur la description de travail indiquée, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant la description de travail
- le droit d'utilisation (*USE) sur le profil utilisateur précisé en regard de l'invite Utilisat (paramètre USER)
- Pour remplacer la valeur du paramètre Code comptabilité ACGCDE par une valeur autre que *USRPRF, l'utilisateur doit disposer du droit (*USE) sur la commande Modifier le code comptabilité CHGACGCDE.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| JOBD | Description de travail | Nom d'objet qualifié | Obligatoire, clé, positionnel 1 |
| Qualificatif 1: Description de travail | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| JOBQ | File d'attente de travaux | Valeurs uniques: *SAME Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 3 |
| Qualificatif 1: File d'attente de travaux | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| JOBPTY | Priorité du travail (en JOBQ) | 1-9, *SAME | Facultatif |
| OUTPTY | Priorité de sortie (en OUTQ) | 1-9, *SAME | Facultatif |
| PRTDEV | Unité imprimante | Nom, *SAME, *USRPRF, *SYSVAL, *WRKSTN | Facultatif |
| OUTQ | File d'attente en sortie | Valeurs uniques: *SAME, *USRPRF, *DEV, *WRKSTN Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File d'attente en sortie | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| TEXT | Texte 'descriptif' | Valeur caractère, *SAME, *BLANK | Facultatif |
| USER | Utilisat | Nom, *SAME, *RQD | Facultatif, positionnel 2 |
| ACGCDE | Code comptabilité | Valeur caractère, *SAME, *USRPRF, *BLANK | Facultatif |
| PRTTXT | Texte à imprimer | Valeur caractère, *SAME, *SYSVAL, *BLANK | Facultatif |
| RTGDTA | Donnée de routage | Valeur caractère, *SAME, *RQSDTA | Facultatif |
| RQSDTA | Donnée demande ou commande | Valeur caractère, *SAME, *NONE, *RTGDTA | Facultatif |
| INLLIBL | Liste bibliothèques initiale | Valeurs uniques: *SAME, *SYSVAL, *NONE Autres valeurs (jusqu'à 250 répétitions): Nom |
Facultatif |
| INLASPGRP | Groupe ASP initial | Nom, *SAME, *NONE | Facultatif |
| LOG | Consignation des messages | Liste d'éléments | Facultatif |
| Élément 1: Niveau | 0-4, *SAME | ||
| Élément 2: Filtre de gravité | 0-99, *SAME | ||
| Élément 3: Texte | *SAME, *MSG, *SECLVL, *NOLIST | ||
| LOGCLPGM | Consigner cdes programme CL | *SAME, *NO, *YES | Facultatif |
| LOGOUTPUT | Sortie historique du travail | *SAME, *SYSVAL, *JOBLOGSVR, *JOBEND, *PND | Facultatif |
| JOBMSGQMX | Taille maxi file messages trav | 2-64, *SAME, *SYSVAL | Facultatif |
| JOBMSGQFL | Action file msg trav saturée | *SAME, *SYSVAL, *NOWRAP, *WRAP, *PRTWRAP | Facultatif |
| SYNTAX | Vérification de syntaxe CL | 0-99, *SAME, *NOCHK | Facultatif |
| ENDSEV | Niveau gravité pour arrêt | 0-99, *SAME | Facultatif |
| INQMSGRPY | Réponse message interrogation | *SAME, *RQD, *DFT, *SYSRPYL | Facultatif |
| HOLD | Suspendre en file de travaux | *SAME, *NO, *YES | Facultatif |
| DATE | Date du travail | Date, *SAME, *SYSVAL | Facultatif |
| SWS | Indicateurs externes | Valeur caractère, *SAME | Facultatif |
| DEVRCYACN | Action rétablissement unité | *SAME, *SYSVAL, *MSG, *DSCMSG, *DSCENDRQS, *ENDJOB, *ENDJOBNOLIST | Facultatif |
| TSEPOOL | Pool fin de tranche de temps | *SAME, *SYSVAL, *NONE, *BASE | Facultatif |
| ALWMLTTHD | Unités exéc multiples admises | *SAME, *NO, *YES | Facultatif |
| SPLFACN | Action de fichier spoule | *SAME, *SYSVAL, *KEEP, *DETACH | Facultatif |
| DDMCNV | Conversation DDM | *SAME, *KEEP, *DROP | Facultatif |
| WLCGRP | Groupe de charge de travail | Nom, *SAME, *SBSD, *NONE | Facultatif |
Description de travail (JOBD)
Indique le nom et la bibliothèque de la description de travail à modifier.
Remarque :Vous ne pouvez pas indiquer la description de travail QSYSJOBD. Il s'agit de la description de travail de secours du système qui ne peut pas être modifiée.
Ce paramètre est obligatoire.
Qualificatif 1 : Description de travail
- nom
- Indiquez le nom de la description de travail.
Qualificatif 2 : Biblio
- *LIBL
- Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.
- *CURLIB
- L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez la bibliothèque dans laquelle figure la description de travail.
File d'attente de travaux (JOBQ)
Indique le nom et la bibliothèque de la file d'attente par défaut dans laquelle sont placés les travaux soumis à l'aide de la description de travail.
Valeurs uniques
- *SAME
- La file d'attente de travaux ne change pas.
Qualificatif 1 : File d'attente de travaux
- nom
- Indiquez le nom de la file d'attente de travaux.
Qualificatif 2 : Biblio
- *LIBL
- Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.
- *CURLIB
- L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. 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.
Remarque :Si la file d'attente de travaux n'existe pas lors de la modification de la description de travail, un qualifiant de file d'attente de travaux doit être indiqué car le nom qualifié de la file d'attente de travaux est conservé dans la description de sous-système.
Priorité du travail (en JOBQ) (JOBPTY)
Indique le niveau de priorité en file d'attente de travaux pour les travaux utilisant cette description de travail. Le niveau de priorité le plus élevé est 1, et le niveau le plus bas est 9.
- *SAME
- Le niveau de priorité en soumission ne change pas.
- 1-9
- Indiquez le niveau de priorité des travaux utilisant cette description de travail.
Priorité de sortie (en OUTQ) (OUTPTY)
Indique le niveau de priorité de sortie pour les fichiers spoule produits par les travaux utilisant cette description de travail. La priorité la plus élevée est 1 et la moins élevée 9.
- *SAME
- Le niveau de priorité de sortie pour les fichiers spoule ne change pas.
- 1-9
- Indiquez une valeur de 1 à 9 définissant le niveau de priorité de sortie des fichiers spoule produits par les travaux qui utilisent cette description de travail. La priorité la plus élevée est 1 et la moins élevée 9.
Unité imprimante (PRTDEV)
Indique le nom qualifié de l'unité imprimante par défaut pour ce travail. Si le fichier imprimante spécifie une sortie spoule, celle-ci est placée dans la file d'attente en sortie de l'unité, qui porte le même nom que cette dernière.
Remarque :Cela suppose que les valeurs par défaut pour le fichier imprimante, la description de travail, le profil utilisateur et le poste de travail ont été indiquées au paramètre File d'attente en sortie OUTQ.
- *SAME
- L'unité d'imprimante par défaut ne change pas.
- *USRPRF
- L'imprimante indiquée dans le profil utilisateur sous lequel le travail a été démarré est utilisée.
- *SYSVAL
- L'unité indiquée dans la valeur système QPRTDEV lors du démarrage du travail définit l'imprimante utilisée.
- *WRKSTN
- L'imprimante attribuée au poste de travail à partir duquel le travail a été démarré est utilisée.
- nom
- Indiquez l'unité d'imprimante affectée aux travaux utilisant cette description de travail.
File d'attente en sortie (OUTQ)
Indique le nom et la bibliothèque de la file d'attente en sortie par défaut pour les travaux qui utilisent cette description de travail. Ce paramètre ne s'applique qu'aux fichiers spoule d'impression pour lesquels *JOB est indiqué pour la file d'attente en sortie.
Valeurs uniques
- *SAME
- La file d'attente en sortie par défaut ne change pas.
- *USRPRF
- Le nom de la file d'attente en sortie pour les travaux utilisant cette description de travail provient du profil utilisateur sous lequel le travail a été démarré.
- *DEV
- La file d'attente en sortie associée à l'imprimante indiquée au paramètre Unité DEV du fichier imprimante est utilisée. Cette file a le même nom que l'imprimante. Le paramètre DEV est déterminé par les commandes Créer un fichier imprimante CRTPRTF (Créer un fichier imprimante), Modifier un fichier imprimante CHGPRTF (Modifier un fichier imprimante) ou Substituer fichier imprimante OVRPRTF (Substituer un fichier imprimante).
Remarque :Cela suppose que les valeurs par défaut pour le fichier imprimante, la description de travail le profil utilisateur et le poste de travail ont été indiquées au paramètre File d'attente en sortie OUTQ.
- *WRKSTN
- La file d'attente en sortie utilisée avec cette description de travail est la file d'attente en sortie affectée au poste de travail associé au travail lorsque ce dernier est démarré.
Qualificatif 1 : File d'attente en sortie
- nom
- Indiquez le nom de la file d'attente en sortie.
Qualificatif 2 : Biblio
- *LIBL
- Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.
- *CURLIB
- L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. 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.
Remarque :Si la file d'attente en sortie n'existe pas lors de la modification de la description de travail, un qualifiant de bibliothèque doit être indiqué car le nom qualifié de la file d'attente en sortie est conservé dans la description de travail.
Texte 'descriptif' (TEXT)
Texte décrivant brièvement l'objet.
- *SAME
- Le texte, s'il existe, ne change pas.
- *BLANK
- Aucun texte n'est spécifié.
- valeur-alphanumérique
- Entrez, entre apostrophes, un texte de 50 caractères au maximum.
Utilisat (USER)
Indique le nom du profil utilisateur associé à cette description de travail. Les noms QSECOFR, QSPL, QDOC, QDBSHR, QRJE, QSYS, QLPAUTO, QLPINSTALL, QTSTRQS et QDFTOWN sont des valeurs incorrectes pour ce paramètre.
- *SAME
- Le nom du profil utilisateur ne change pas.
- *RQD
- Vous devez indiquez un nom d'utilisateur pour pouvoir utiliser la description de travail. Pour les postes écran, vous devez indiquer un nom d'utilisateur lors de l'ouverture de session sur le poste de travail. *RQD n'est pas une valeur correcte pour les descriptions de travail associées aux poste travail à démarrage automatique, ni pour les descriptions utilisées par la commande Début de travail par lots BCHJOB (Travail par lots). Elle n'est correcte pour la commande Soumettre un travail SBMJOB (Soumettre un travail) que si vous avez indiqué *CURRENT en regard de l'invite Utilisat (paramètre USER).
- nom
- Indiquez le nom d'utilisateur identifiant le profil utilisateur associé aux travaux par lots utilisant cette description de travail. Pour les travaux interactifs, ce nom sera utilisé pour ouvrir une session sans indiquer de nom d'utilisateur.
Code comptabilité (ACGCDE)
Indique le code comptabilité à employer lors de la consignation des ressources système utilisées pour les travaux associés à cette description. Pour indiquer un code autre que *USRPRF, vous devez être autorisé à utiliser la commande Modifier le code comptabilité CHGACGCDE (Modifier le code comptabilité).
- *SAME
- Le code comptabilité ne change pas.
- *USRPRF
- Le code comptabilité des travaux utilisant cette description de travail provient du profil utilisateur associé au travail.
- *BLANK
- Un code comptabilité composé de 15 caractères blancs est attribué aux travaux utilisant cette description de travail.
- valeur-alphanumérique
- Indiquez le code comptabilité pour les travaux qui utilisent cette description de travail et dont les statistiques de comptabilité sont consignées dans le journal de comptabilité du système QACGJRN. Si vous indiquez moins de 15 caractères, la chaîne est complétée à droite avec des caractères blancs.
Texte à imprimer (PRTTXT)
Permet de demander l'impression d'une ligne de texte au bas de chaque page.
- *SAME
- Le texte à imprimer ne change pas.
- *SYSVAL
- La valeur contenue dans la valeur système QPRTTXT est utilisée.
- *BLANK
- Aucun texte n'est imprimé.
- valeur-alphanumérique
- Indiquez la chaîne de caractères à imprimer au bas de chaque page. Cette chaîne peut comprendre jusqu'à 30 caractères (entre apostrophes).
Donnée de routage (RTGDTA)
Indique la donnée de routage à utiliser avec cette description de travail pour démarrer des travaux.
- *SAME
- Les données de routage ne changent pas.
- *RQSDTA
- Les 80 premiers caractères de la demande indiquée en regard de l'invite Donnée demande ou commande (paramètre RQSDTA) sont utilisés comme donnée de routage pour le travail.
- valeur-alphanumérique
- Indiquez la donnée de routage pour les travaux utilisant cette description de travail. Vous pouvez entrer jusqu'à 80 caractères (entre apostrophes, si nécessaire).
Donnée demande ou commande (RQSDTA)
Indique la demande devant constituer le dernier poste de la file d'attente de messages du travail pour les travaux qui utilisent cette description de travail.
- *SAME
- La donnée demande ne change pas.
- *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 en regard de l'invite Donnée de routage (paramètre RTGDTA) est placée en dernière position dans la file d'attente de messages du travail.
- valeur-alphanumérique
- Indiquez la chaîne de caractères devant constituer le dernier poste de la file d'attente de messages du travail en tant que demande distincte. Vous pouvez entrer jusqu'à 256 caractères (entre apostrophes, si nécessaire). Une commande CL doit être placée entre apostrophes, et toute apostrophe normalement nécessaire à l'intérieur de la chaîne doit être doublée.
Liste bibliothèques initiale (INLLIBL)
Indique la valeur initiale de la liste des bibliothèques utilisateur devant être employée pour les travaux qui utilisent cette description de travail.
Remarque :La duplication des noms de bibliothèque dans la liste des bibliothèques n'est pas admise.
- *SAME
- La partie utilisateur de la liste des bibliothèques ne change pas.
- *SYSVAL
- C'est la liste des bibliothèques par défaut du système qui est employée pour les travaux utilisant cette description de travail. Cette liste comprend le nom des bibliothèques indiquées dans la valeur système QUSRLIBL au moment du démarrage d'un travail utilisant cette description.
- *NONE
- La partie utilisateur de la liste des bibliothèques est vide ; seule la partie système est utilisée.
Autres valeurs (jusqu'à 250 répétitions)
- nom
- Indiquez la bibliothèque dans la partie utilisateur de la liste des bibliothèques devant être employée pour les travaux qui utilisent cette description de travail.
Remarque :La recherche s'effectue dans l'ordre dans lequel figurent les bibliothèques dans cette liste.
Groupe ASP initial (INLASPGRP)
Indique la configuration initiale pour le nom de groupe de pools de mémoire secondaire (ASP)pour l'unité d'exécution initiale des travaux utilisant cette description de travail. Une unité d'exécution peut utiliser la commande Définir groupe ASP SETASPGRP (Définir un groupe de pools de mémoire secondaire)pour modifier son espace de nom de bibliothèque. Lorsqu'un groupe d'ASP est associé à une unité d'exécution, toutes les bibliothèques des ASP indépendants des groupes d'ASP sont accessibles et les objets de ces bibliothèques peuvent être référencés à l'aide de la syntaxe de nom d'objet qualifié de la bibliothèque classique. Les bibliothèques des ASP indépendants du groupe d'ASP indiqué plus les bibliothèques de l'ASP système (numéro d'ASP 1) et des ASP utilisateur de base (numéros d'ASP 2 à 32) forment l'espace de nom de la bibliothèque pour l'unité d'exécution.
Restrictions :
- Les descriptions de travail QGPL/QDFTJOBD et QGPL/QDFTSVR ne peuvent pas être modifiées pour spécifier le nom d'un groupe d'ASP. La valeur de INLASPGRP doit être *NONE pour ces descriptions de travail.
- *SAME
- La valeur reste inchangée.
- *NONE
- Indique que l'unité d'exécution initiale des travaux utilisant la description de travail va être démarrée sans groupe d'ASP. L'espace de nom de bibliothèque ne va pas inclure les bibliothèques des groupes d'ASP. Seules les bibliothèques de l'ASP système et de tous les ASP utilisateur de base vont se trouver dans l'espace de nom de bibliothèque.
- nom
- Indique le nom du groupe d'ASP qui doit être configuré pour l'unité d'exécution des travaux utilisant la description de travail. Le nom de groupe d'ASP est le nom de l'unité du pool de mémoire secondaire principal au sein du groupe d'ASP. Toutes les bibliothèques de tous les ASP de tous les groupes d'ASP vont être incluses dans l'espace de nom de bibliothèque.
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
- *SAME
- Le niveau de consignation du message ne change pas.
- 0-4
- Indiquez le niveau de consignation pour les messages du travail.
- 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. La consignation indique le lancement, l'arrêt et l'état d'achèvement du travail.
- 2
- Les informations suivantes sont consignées :
- Informations de niveau 1.
- Messages associés à des demandes pour lesquels un message de haut niveau est envoyé avec un code gravité supérieur ou égal à la gravité de consignation. Le message de demande et tous les messages qui lui sont associés sont consignés.
Remarque :Un message de haut niveau est un message envoyé à la file d'attente de messages du programme qui reçoit le message de message. Par exemple, QCMD est un programme de traitement des demandes fourni par IBM qui reçoit les 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, messages de trace compris.
- 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é
- *SAME
- Le niveau de gravité du message ne change pas.
- 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
- *SAME
- Le niveau du texte du message ne change pas.
- *MSG
- Seul le texte du message est consigné 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 consignables et exécutées dans un programme CL doivent être consignées dans la file d'attente de messages du programme CL, cette file constituant l'historique du travail. Ce paramètre détermine l'état de l'indicateur de consignation du travail. Si *NO est indiqué, l'indicateur est hors fonction et les commandes CL ne sont pas consignées. Si *YES est indiqué ici et que *JOB figure en regard de l'invite Consignation des messages (paramètre LOG) pour la commande Créer un programme CL CRTCLPGM (Créer un programme CL), la consignation s'effectue pour toutes les commandes du programme CL pouvant être consignées dans l'historique du travail.
- *SAME
- La valeur reste inchangée.
- *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.
Sortie historique du travail (LOGOUTPUT)
Permet de définir la façon dont l'historique du travail sera créé lorsque le travail sera terminé. Ceci ne concerne pas les historiques de travaux générés lorsque la file d'attente de messages est saturée et que l'action correspondante est *PRTWRAP. Les messages contenus dans la file d'attente de messages du travail sont écrits dans un fichier spoule à partir duquel l'historique du travail peut être imprimé, sauf si l'API QMHCTLJL était utilisée dans le travail pour indiquer que les messages de l'historique du travail doivent être écrits dans un fichier base de données.
La valeur de sortie d'historique du travail peut être modifiée à tout moment tant que l'historique n'est pas généré ou supprimé. Pour ce faire, vous pouvez utiliser l'API QWTCHGJB ou la commande CHGJOB.
La valeur de sortie d'historique du travail peut être affichée à tout moment tant que l'historique n'est pas généré ou supprimé. Pour ce faire, utilisez la commande DSPJOBLOG.
L'historique du travail peut être supprimé lorsque l'exécution du travail est terminée et que l'historique du travail n'a pas encore été généré ou supprimé. Pour supprimer l'historique du travail, vous pouvez utiliser l'API QWTRMVJL ou la commande ENDJOB.
- *SAME
- La valeur reste inchangée.
- *SYSVAL
- La valeur indiquée dans la valeur système QLOGOUTPUT est utilisée.
- *JOBLOGSVR
- L'historique du travail sera généré par un serveur d'historique du travail. Pour en savoir plus sur les serveurs d'historique de travail, consultez les informations sur la commande STRLOGSVR.
- *JOBEND
- L'historique du travail sera généré par le travail lui-même. Si l'historique du travail ne peut pas générer son propre historique du travail, celui-ci sera généré par un serveur d'historique du travail. Par exemple, un travail ne génère pas son propre historique lorsque le système traite une commande PWRDWNSYS.
- *PND
- L'historique du travail ne sera pas généré. L'historique du travail demeure en instance en attendant d'être enlevé.
Taille maxi file messages trav (JOBMSGQMX)
Indique la taille maximale de la file d'attente de messages du travail.
- *SAME
- La taille maximale de la file d'attente de messages du travail reste inchangée.
- *SYSVAL
- Lors du démarrage du travail, la taille maximale de la file d'attente est déterminée par la valeur système QJOBMSGQMX.
- 2-64
- Indiquez la taille maximum, en mégaoctets, de la file d'attente de messages.
Action file msg trav saturée (JOBMSGQFL)
Indique l'action à entreprendre lorsque la file d'attente de messages du travail est saturée.
- *SAME
- L'action à entreprendre en cas de saturation de la file d'attente de messages du travail reste inchangée.
- *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 ainsi écrasés sont imprimés.
Vérification de syntaxe CL (SYNTAX)
Indique si les demandes placées dans la file d'attente de messages du travail (pour les travaux utilisant cette description de travail) doivent être soumises à la vérification de syntaxe propre aux commandes CL. Dans l'affirmative, la vérification s'effectue au moment de la soumission des commandes, et non lors du lancement du travail, ce qui permet de détecter très tôt les erreurs de syntaxe. Lorsque vous demandez la vérification de syntaxe, vous devez également indiquer à partir de quel niveau de gravité un message d'erreur syntaxique peut entraîner l'interruption du traitement.
- *SAME
- Le contrôle de syntaxe ne change pas.
- *NOCHK
- Les demandes ne sont pas soumises à la vérification de syntaxe propre aux commandes CL.
- 0-99
- Indiquez la gravité minimale de message pouvant mettre fin à l'exécution d'un travail. La syntaxe des demandes est vérifiée selon les règles propres aux commandes CL. Si le système rencontre une erreur provoquant un message dont la gravité est au moins égale au niveau indiqué ici, l'exécution du travail concerné est interrompue.
Niveau gravité pour arrêt (ENDSEV)
Indique à partir de quel niveau de gravité les messages d'arrêt programme peuvent entraîner l'interruption d'un travail par lots. Le travail est interrompu lorsqu'une demande figurant dans le flot de travaux par lots en entrée provoque l'envoi (au programme QCMD ou QCL qui traite cette demande) d'un message d'arrêt programme dont le code gravité est supérieur ou égal à la valeur indiquée ici. Cette valeur est comparée à la gravité de tout message d'arrêt programme non contrôlé dont l'émission fait suite à l'exécution d'une commande CL non compilée dans un travail par lots.
- *SAME
- La valeur en cours de ce paramètre ne change pas.
- 0-99
- Indiquez le niveau de gravité pour les messages d'arrêt programme émis à la suite d'une demande contenue dans un flot de travaux par lots ; les messages dont le niveau est au moins égal à la valeur indiquée provoqueront l'interruption des travaux utilisant cette description. Le code gravité maximal pour un message d'arrêt programme est généralement de 50. Tout message d'arrêt programme non traité et de gravité supérieure ou égale à la valeur indiquée provoque l'arrêt du travail.
Réponse message interrogation (INQMSGRPY)
Indique la procédure à suivre pour répondre aux messages d'interrogation relatifs aux travaux utilisant cette description de travail. Vous pouvez demander que les réponses aux messages soient données selon la procédure habituelle ; vous pouvez également demander des réponses par défaut ou appropriées aux conditions rencontrées. Ces conditions figurent dans les postes liste de réponse système créés par la commande Ajouter poste liste de réponse ADDRPYLE (Ajouter un poste à la liste de réponse).
- *SAME
- Le mode de réponse aux messages d'interrogation ne change pas.
- *RQD
- Une réponse est exigée pour tout message d'interrogation prédéfini issu d'un travail utilisant cette description de travail.
- *DFT
- La réponse par défaut au message est utilisée pour répondre à tous les messages d'interrogation prédéfinis qui sont produits durant l'exécution d'un travail utilisant cette description. La réponse par défaut est définie soit dans la description du message, soit au niveau du système.
- *SYSRPYL
- La liste de réponse système est vérifiée afin de déterminer si l'un des postes concorde avec l'identificateur et la valeur optionnelle de comparaison pour tout message d'interrogation provenant d'un travail qui utilise cette description. S'il y a concordance, la réponse figurant dans cette liste est utilisée. S'il n'existe aucun poste pour ce message, une réponse est obligatoire.
Suspendre en file de travaux (HOLD)
Indique si les travaux qui utilisent cette description de travail doivent être suspendus en file d'attente de travaux. Un travail est suspendu jusqu'à sa libération par la commande Libérer un travail RLSJOB (Libérer un travail), ou jusqu'à son arrêt par la commande Arrêter un travail ENDJOB (Arrêter un travail) ou Mettre à blanc file de travaux CLRJOBQ (Mettre à blanc une file d'attente de travaux).
- *SAME
- La condition de suspension du travail ne change pas.
- *NO
- Les travaux utilisant cette description de travail ne sont pas suspendus en file d'attente.
- *YES
- Les travaux utilisant cette description sont suspendus en file d'attente.
Date du travail (DATE)
Indique la date à attribuer, lors de son démarrage, au travail qui utilise cette description.
- *SAME
- La date du travail ne change pas.
- *SYSVAL
- La date du travail est celle de la valeur système QDATE au démarrage du travail.
- date
- Indiquez la date du travail à démarrer. Le format en cours pour l'attribut de travail DATFMT doit être utilisé.
Indicateurs externes (SWS)
Indique l'état initial d'un groupe de huit indicateurs externes utilisés par les travaux associés à cette description de travail. Ces indicateurs peuvent être positionnés ou testés dans un programme CL et permettent de contrôler le déroulement du programme. Les seules valeurs correctes pour chacun de ces indicateurs à un chiffre sont 0 (hors fonction) et 1 (en fonction).
- *SAME
- La valeur des huit indicateurs externes ne change pas.
- valeur-alphanumérique
- Indiquez, entre apostrophes si nécessaire, une combinaison de huit chiffres (0 ou 1) afin de modifier l'état des indicateurs externes.
Action rétablissement unité (DEVRCYACN)
Indique, en cas d'erreur d'E-S sur l'unité *REQUESTOR, l'action de rétablissement à entreprendre pour les travaux interactifs qui utilisent cette description de travail. Cet attribut ne concerne pas les travaux en traitement par lots.
- *SAME
- L'action de rétablissement de l'unité ne change pas.
- *SYSVAL
- La valeur système QDEVRCYACN en cours lors du démarrage du travail est utilisée.
- *MSG
- Le programme d'application demandant l'opération d'E-S reçoit un message d'erreur indiquant l'échec de l'opération.
- *DSCMSG
- Le travail est automatiquement déconnecté. Une fois celui-ci reconnecté, un message d'erreur apparaît indiquant qu'une erreur d'E-S s'est produite et que l'unité a été rétablie. Le contenu de l'écran affiché avant l'apparition de l'erreur doit cependant être réaffiché.
- *DSCENDRQS
- Le travail est automatiquement déconnecté. Une fois celui-ci reconnecté, la commande Arrêter la demande en cours ENDRQS (Arrêter la demande en cours) est lancée, indiquant le processeur à l'origine de la demande précédente. En l'absence de processeur de demande, la commande ENDRQS échoue et un message d'erreur est émis.
- *ENDJOB
- Le travail est arrêté à l'aide de l'option *IMMED. Un historique du travail est créé.
- *ENDJOBNOLIST
- Le travail est arrêté à l'aide de l'option *IMMED. Aucun historique du travail n'est créé.
Pool fin de tranche de temps (TSEPOOL)
Indique si des travaux interactifs doivent être transférés dans un autre pool de la mémoire principale, une fois la tranche de temps écoulée. En cas de longue attente, le travail est replacé dans le pool d'origine. Cette option permet éventuellement de limiter l'impact du pseudo-batch sur les temps de réponse interactifs.
- *SAME
- La valeur de ce paramètre ne change pas.
- *SYSVAL
- La valeur système QTSEPOOL en cours lors du démarrage du travail est utilisée.
- *NONE
- Le travail ne sera pas transféré une fois la tranche de temps écoulée.
- *BASE
- Le travail sera transféré dans le pool de base une fois la tranche de temps écoulée.
Unités exéc multiples admises (ALWMLTTHD)
Indique si le travail peut être exécuté avec des unités d'exécution multiples définies par l'utilisateur. Cet attribut n'empêche pas la création d'unités d'exécution définies par le système dans le travail. Il ne peut plus être modifié après le lancement du travail correspondant. Il s'applique aux travaux à démarrage automatique ou anticipé, aux travaux en mode par lots soumis à partir de postes planning de travaux ainsi qu'aux travaux démarrés à l'aide des commandes Soumettre un travail SBMJOB (Soumettre un travail) et Début de travail par lots BCHJOB (Début de travail). Cet attribut est ignoré lors du lancement de tous les autres types de travail. *YES ne devrait être défini pour cet attribut que dans les descriptions de travail utilisées uniquement avec des fonctions permettant de créer des unités d'exécution multiples définies par l'utilisateur.
- *SAME
- La valeur ne change pas.
- *NO
- Le travail ne peut pas être exécuté avec des unités d'exécution multiples définies par l'utilisateur.
- *YES
- Le travail peut être exécuté avec des unités d'exécution multiples définies par l'utilisateur.
Action de fichier spoule (SPLFACN)
Indique si l'accès aux fichiers spoule se fait par les interfaces travail après l'arrêt du travail ou non. Le fait de conserver les fichiers spoule avec les travaux permet aux commandes telles que Gérer les travaux soumis WRKSBMJOB (Gérer des travaux soumis) de gérer les fichiers spoule même après l'arrêt du travail. Le fait de détacher les fichiers spoule des travaux réduit l'utilisation des ressources système en permettant aux structures des travaux d'être recyclées lors de l'arrêt des travaux.
- *SAME
- La valeur reste inchangée.
- *SYSVAL
- La valeur indiquée dans la valeur système QSPLFACN est utilisée.
- *KEEP
- Lorsque le travail est terminé, tant qu'il existe au moins un fichier spoule pour le travail dans le pool de mémoire secondaire du système (ASP 1) ou dans un ASP utilisateur de base (ASP 2 à 32), les fichiers spoule sont conservés avec le travail et l'état du travail est mis à jour afin d'indiquer l'achèvement du travail. Si tous les fichiers spoule restants se retrouvent dans des pools de mémoire secondaire indépendants (ASP 33-255), ces fichiers sont détachés du travail et ce dernier est enlevé du système.
- *DETACH
- Lorsque le travail est arrêté, les fichiers spoule sont détachés du travail et ce dernier est enlevé du système.
Conversation DDM (DDMCNV)
Indique si les connexions effectuées via les protocoles DDM restent actives lorsqu'elles sont inutilisées. Ces connexions englobent les conversations APPC, les communications TCP/IP actives ou les connexions Opti-Connect. Les protocoles DDM sont utilisés dans les applications DRDA, DDM ou DB2 Multisystem. Pour plus de détails sur la gestion des données réparties, reportez-vous à IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
- *SAME
- La valeur reste inchangée.
- *KEEP
- Le système maintient les conversations DDM actives en l'absence d'utilisateurs, sauf si :
- La phase d'activation prend fin dans le système source.
- Une demande explicite de fin de conversation a été émise par l'intermédiaire de la commande Récupérer conversations DDM (RCLDDMCNV) (Récupérer les conversations DDM) ou Récupérer les ressources RCLRSC (Récupérer des ressources).
- Un incident de communications ou une erreur interne s'est produit.
- Une connexion DRDA à un serveur d'applications qui n'est pas en cours d'exécution sur le System i s'arrête.
- *DROP
- Le système met fin à une conversation DDM s'il n'y a pas d'utilisateur. Par exemple, lorsqu'une application ferme un fichier DDM, ou qu'une application DRDA exécute une instruction SQL DISCONNECT.
Groupe de charge de travail (WLCGRP)
Indique le groupe de charge de travail à associer aux travaux qui utilisent cette description de travail. Pour plus d'informations sur les groupes de charge de travail, reportez-vous à l'aide sur la commande ADDWLCGRP.
- *SAME
- Le groupe de charge de travail ne change pas.
- *SBSD
- Le groupe de charge de travail défini dans la description de sous-système sera utilisé.
- *NONE
- Aucun groupe de charge de travail n'est utilisé.
- nom
- Indiquez le nom du groupe de charge de travail à associer aux travaux qui utilisent cette description de travail. Si le groupe de charge de travail n'existe pas lorsque le travail est démarré, aucun groupe de charge de travail n'est utilisé.
Exemples
Exemple 1 : paramétrage des priorités de travail en cours d'exécution et de sortie
CHGJOBD JOBD(QGPL/QPGMR) JOBPTY(2) OUTPTY(2)
Cette commande permet aux travaux utilisant la description de travail QPGMR fournie par IBM dans la bibliothèque QGPL d'être traités avec une priorité de travail et de sortie plus élevée que celle indiquée préalablement pour QPGMR. QPGMR paramètre au préalable les priorités de travail en cours d'exécution et de sortie sur le niveau 5. Pour plus d'informations sur les valeurs des paramètres de travail fournies par IBM, reportez-vous au manuel de programmation CL.
Exemple 2 : modification des limites de priorité
Supposons que le profil utilisateur a été créé comme suit :
Partie 1 :
CRTUSRPRF USRPRF(JLRAY) PASSWORD(GAMMA) SPCAUT(*JOBCTL)
PTYLMT(4) AUT(*NONE)
Essayez ensuite de modifier les limites de priorité de la description de travail BATCH5 à l'aide de la commande suivante :
Partie 2 :
CHGJOBD JOBD(BATCH5) USER(JLRAY) JOBPTY(1) OUTPTY(1)
Etant donné que la limite de priorité indiquée dans le profil utilisateur prévaut sur les limites indiquées dans une description de travail, un message d'erreur est envoyé et une priorité de 4 est supposée pour les niveaux de priorité de travail et de sortie.
Exemple 3 : demande de mot de passe pour l'ouverture d'une session sur le poste de travail
CHGJOBD JOBD(INT4) USER(*RQD) RTGDTA(QCMDI) LOG(*SAME)
ACGCDE('USERXYZ CODE123') TEXT(*BLANK)
Le paramètre USER indique que l'utilisateur de la description de travail INT4 doit entrer un mot de passe pour ouvrir une session sur un poste de travail. Les caractères QCMDI sont utilisés comme données de routage qui seront comparées à la table de routage du sous-système sous lequel le travail est exécuté. Toutes les valeurs de la liste des paramètres LOG restent inchangées. Les travaux utilisant cette description de travail ont des données comptables enregistrées sous le code comptabilité, "USERXYZ CODE123", lorsque la comptabilité des travaux est active. Le texte relatif à la description de travail est effacé.
Exemple 4 : envoi des travaux dans la file d'attente de travaux spécifique à l'aide de ce système
CHGJOBD JOBD(BATCH3) JOBQ(NIGHTQ) JOBPTY(4) OUTPTY(4)
RTGDTA(QCMDB) INQMSGRPY(*DFT)
TEXT('Batch #3 JOBD for high priority night work')
Cette commande modifie une description de travail nommée BATCH3 dans la liste des bibliothèques. Les travaux utilisant cette description sont désormais placés dans la file d'attente de travaux NIGHTQ. La priorité des travaux utilisant cette description et leurs fichiers spoule est 4. QCMDB correspond aux données de routage comparées aux postes de la table de routage du sous-système dans lequel le travail est exécuté. Le texte indique désormais que cette description de travail concerne un travail nocturne de priorité élevée. Le paramètre INQMSGRPY indique que tous les messages de type *INQ émis à partir d'un travail utilisant automatiquement cette description de travail entraînent l'envoi du message de réponse par défaut.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.