Aller au contenu

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

  • JOBD Description de travail obligatoire
  • JOBQ File d'attente de travaux
  • JOBPTY Priorité du travail (en JOBQ)
  • OUTPTY Priorité de sortie (en OUTQ)
  • PRTDEV Unité imprimante
  • OUTQ File d'attente en sortie
  • TEXT Texte 'descriptif'
  • USER Utilisat
  • ACGCDE Code comptabilité
  • PRTTXT Texte à imprimer
  • RTGDTA Donnée de routage
  • RQSDTA Donnée demande ou commande
  • INLLIBL Liste bibliothèques initiale
  • INLASPGRP Groupe ASP initial
  • LOG Consignation des messages
  • LOGCLPGM Consigner cdes programme CL
  • LOGOUTPUT Sortie historique du travail
  • JOBMSGQMX Taille maxi file messages trav
  • JOBMSGQFL Action file msg trav saturée
  • SYNTAX Vérification de syntaxe CL
  • ENDSEV Niveau gravité pour arrêt
  • INQMSGRPY Réponse message interrogation
  • HOLD Suspendre en file de travaux
  • DATE Date du travail
  • SWS Indicateurs externes
  • DEVRCYACN Action rétablissement unité
  • TSEPOOL Pool fin de tranche de temps
  • ALWMLTTHD Unités exéc multiples admises
  • SPLFACN Action de fichier spoule
  • DDMCNV Conversation DDM
  • WLCGRP Groupe 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 :

  1. 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)
  2. 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 :

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

CPF1618
Description de travail &1 de &2 endommagée.
CPF1625
Description de travail &1 de &2 non modifiée.
CPF4ACF
Echec de l'opération pour l'objet &1 dans &2 type *&3 en raison d'erreurs de réplication.
CPF9872
Programme ou programme de service &1 de la bibliothèque &2 arrêté. Code raison : &3.

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