Aller au contenu

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

  • SBSD Description de sous-système obligatoire
  • JOBQ File d'attente de travaux obligatoire
  • MAXACT Maximum de travaux actifs
  • SEQNBR Numéro de séquence
  • MAXPTY1 Activité maxi priorité 1
  • MAXPTY2 Activité maxi priorité 2
  • MAXPTY3 Activité maxi priorité 3
  • MAXPTY4 Activité maxi priorité 4
  • MAXPTY5 Activité maxi priorité 5
  • MAXPTY6 Activité maxi priorité 6
  • MAXPTY7 Activité maxi priorité 7
  • MAXPTY8 Activité maxi priorité 8
  • MAXPTY9 Activité 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 :

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

CPF1619
Description de sous-système &1 de &2 endommagée.
CPF1691
La description de sous-système actif n'a peut-être pas été modifiée.
CPF1697
Description de sous-système &1 non modifiée.

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