CHGJOBQE
Modifier poste file de travaux
En bref
La commande Modifier poste file de travaux CHGJOBQE (Modifier un poste file d'attente de travaux) permet de modifier un poste file d'attente de travaux existant dans la description de sous-système indiquée.
CHGJOBQE se lit CHG
(Modifier) + JOBQE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGJOBQE SBSD(…) JOBQ(…)
Paramètres
-
SBSDDescription de sous-système obligatoire -
JOBQFile d'attente de travaux obligatoire -
MAXACTMaximum de travaux actifs -
SEQNBRNuméro de séquence -
MAXPTY1Activité maxi priorité 1 -
MAXPTY2Activité maxi priorité 2 -
MAXPTY3Activité maxi priorité 3 -
MAXPTY4Activité maxi priorité 4 -
MAXPTY5Activité maxi priorité 5 -
MAXPTY6Activité maxi priorité 6 -
MAXPTY7Activité maxi priorité 7 -
MAXPTY8Activité maxi priorité 8 -
MAXPTY9Activité maxi priorité 9
Astuce : dans une session 5250, tapez CHGJOBQE 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 poste file de travaux CHGJOBQE (Modifier un poste file d'attente de travaux) permet de modifier un poste file d'attente de travaux existant dans la description de sous-système indiquée. Cette commande peut être utilisée quel que soit l'état du sous-système : actif ou inactif. Un poste file d'attente de travaux identifie la file d'attente dans laquelle les travaux sont sélectionnés pour être lancés dans le sous-système. Les travaux peuvent être placés dans une file d'attente par des lecteurs de spoule ou à l'aide des commandes suivantes :
- Soumettre un travail (SBMJOB)
- Soumettre des travaux BD (SBMDBJOB)
- Soumettre travaux disquette (SBMDKTJOB)
- Transférer un travail (TFRJOB)
- Transférer un travail par lots (TFRBCHJOB)
Dans un sous-système, les files d'attente de travaux ayant les numéros de séquence les moins élevés sont traitées en premier.
Restrictions :
- Pour pouvoir utiliser cette commande, vous devez disposer des droits opérationnels sur les objets (*OBJOPR), des droits de gestion sur les objets (*OBJMGT) et de lecture (*READ) sur la description de sous-système indiquée, ainsi que du droit d'exécution (*EXECUTE) sur la bibliothèque contenant la description de sous-système.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| SBSD | Description de sous-système | Nom d'objet qualifié | Obligatoire, positionnel 1 |
| Qualificatif 1: Description de sous-système | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| JOBQ | File d'attente de travaux | Nom d'objet qualifié | Obligatoire, positionnel 2 |
| Qualificatif 1: File d'attente de travaux | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| MAXACT | Maximum de travaux actifs | 0-32000, *SAME, *NOMAX | Facultatif, positionnel 3 |
| SEQNBR | Numéro de séquence | 1-9999, *SAME | Facultatif |
| MAXPTY1 | Activité maxi priorité 1 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY2 | Activité maxi priorité 2 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY3 | Activité maxi priorité 3 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY4 | Activité maxi priorité 4 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY5 | Activité maxi priorité 5 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY6 | Activité maxi priorité 6 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY7 | Activité maxi priorité 7 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY8 | Activité maxi priorité 8 | 0-99, *SAME, *NOMAX | Facultatif |
| MAXPTY9 | Activité maxi priorité 9 | 0-99, *SAME, *NOMAX | Facultatif |
Description de sous-système (SBSD)
Indique le nom et la bibliothèque de la description de sous-système dans la quelle figure le poste file d'attente de travaux à modifier.
Ce paramètre est obligatoire.
Qualificatif 1 : Description de sous-système
- nom
- Indiquez le nom de la description de sous-système pour laquelle le poste file d'attente de travaux est modifié.
Remarque : L'objet QSYSSBSD fourni par IBM n'est pas admis pour ce paramètre.
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 sous-système.
File d'attente de travaux (JOBQ)
Indique le nom et la bibliothèque de la file d'attente de travaux par lots lancés par ce sous-système. Si la file d'attente de travaux n'existe pas lors de l'ajout ou de la modification du poste, vous devez indiquer un qualifiant de bibliothèque autre que *LIBL car le nom de la file d'attente de travaux est conservé dans la description de sous-système.
Ce paramètre est obligatoire.
Qualificatif 1 : File d'attente de travaux
- nom
- Indiquez le nom de la file d'attente de travaux par lots lancés par ce sous-système.
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.
Maximum de travaux actifs (MAXACT)
Indiquez le nombre maximal de travaux provenant de cette file d'attente et pouvant être actifs simultanément.
- *SAME
- Le nombre maximal de travaux pouvant être actifs simultanément ne change pas.
- *NOMAX
- Aucune limite n'est fixée pour le nombre de travaux pouvant être lancés simultanément via ce poste file d'attente de travaux. Toutefois, le niveau maximal d'activité des postes de routage, le sous-système ou le niveau de priorité de travail spécifique peuvent empêcher le lancement de certains travaux. Si vous indiquez *NOMAX, la totalité des travaux figurant dans la file d'attente sont lancés, même si le niveau d'activité du pool de mémoire utilisé empêche leur exécution simultanée.
- 0-32000
- Indiquez le nombre maximal de travaux provenant de cette file d'attente et pouvant être actifs simultanément.
Numéro de séquence (SEQNBR)
Indique le numéro de séquence de cette file d'attente de travaux, utilisé par le sous-système pour déterminer l'ordre de traitement des différentes files.
Le sous-système sélectionne en priorité les travaux contenus dans la file d'attente dont le numéro de séquence est le moins élevé. Une fois ces travaux traités ou le nombre de travaux indiqué en regard de l'invite Maximum de travaux actifs (paramètre MAXACT) atteint, le sous-système traite ceux de la file d'attente possédant le numéro de séquence le plus élevé, jusqu'à ce que tous les postes file d'attente de travaux soient traités ou que la limite maximale de travaux admis soit atteinte. Il arrive que la séquence soit interrompue et que le sous-système traite une file d'attente de travaux possédant un numéro de séquence moins élevé. C'est notamment le cas lorsque l'une des conditions suivantes est remplie :
- Une file d'attente de travaux ou un travail suspendu est libéré.
- Un travail est placé ou transféré dans une file d'attente de travaux.
- Une nouvelle file d'attente de travaux est allouée.
- Un travail prend fin.
- *SAME
- Le numéro de séquence attribué à cette file d'attente de travaux ne change pas.
- 1-9999
- Indiquez le numéro de séquence de cette file d'attente de travaux. Ce numéro doit être unique dans la description de sous-système.
Activité maxi priorité 1 (MAXPTY1)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 2 (MAXPTY2)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 3 (MAXPTY3)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 4 (MAXPTY4)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 5 (MAXPTY5)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 6 (MAXPTY6)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 7 (MAXPTY7)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 8 (MAXPTY8)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Activité maxi priorité 9 (MAXPTY9)
Indique le nombre de travaux pouvant être lancés pour le niveau de priorité de travail indiqué.
- *SAME
- Le nombre de travaux lancés à un niveau de priorité donné ne change pas.
- *NOMAX
- Aucun maximum n'est fixé pour le nombre de travaux pouvant être lancés avec un niveau de priorité spécifique.
- 0-99
- Indiquez le nombre de travaux pouvant être lancés avec un niveau de priorité donné. La valeur 0 indique qu'aucun travail n'est lancé avec un niveau de priorité spécifique.
Exemples
CHGJOBQE SBSD(QGPL/QBATCH) JOBQ(QGPL/QBATCH) MAXACT(4)
MAXPTY1(1) MAXPTY2(*NOMAX)
Cette commande modifie le nombre maximal de travaux pouvant être actifs simultanément à partir de la file d'attente de travaux QBATCH de la bibliothèque QGPL. Le numéro de séquence du poste file d'attente de travaux ne change pas. Le nombre maximal de travaux de la file d'attente de travaux QBATCH pouvant être actifs simultanément est quatre. Un seul travail peut être actif au niveau de priorité 1. Au niveau 2, le nombre maximal de travaux actifs simultanément n'est pas limité. Les niveaux de priorité compris entre 3 et 9 ne changent pas.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.