ADDJOBQE

La commande Ajouter poste file de travaux ADDJOBQE (Ajouter poste file d'attente de travaux) permet d'ajouter un poste file d'attente de travaux à la description de sous-système indiquée. Un poste file d'attente de travaux identifie une file d'attente dans laquelle des travaux sont sélectionnés pour être traité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)

Les travaux lancés à partir d'une file d'attente sont des travaux par lots, à l'exception des travaux interactifs utilisant la commande TFRJOB (Transférer un travail). 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. Pour plus de détails, reportez-vous à l'invite Numéro de séquence (paramètre SEQNBR).

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

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système à laquelle le poste file d'attente de travaux est ajouté.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom de la description de sous-système à laquelle le poste file d'attente de travaux est ajouté.

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.

1

Un seul travail de la file d'attente de travaux peut être actif.

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

10

Le numéro de séquence attribué à cette file d'attente de travaux est 10.

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

*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é.

*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é.

*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é.

*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é.

*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é.

*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é.

*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é.

*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é.

*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

Exemple 1 : ajout d'une file d'attente de travaux

ADDJOBQE   SBSD(QGPL/NIGHTSBS)  JOBQ(QGPL/NIGHT)  MAXACT(3)

Cette commande ajoute un poste file d'attente de travaux pour la file d'attente de travaux NIGHT (dans la bibliothèque QGPL) à la description de sous-système NIGHTSBS contenue dans la bibliothèque QGPL. Le poste indique qu'il est possible d'activer simultanément dans le sous-système jusqu'à trois travaux par lots de la file d'attente de travaux NIGHT. On suppose que le numéro de séquence par défaut est 10.

Exemple 2 : exécution de travaux à des niveaux de priorité spécifiques

ADDJOBQE   SBSD(QBASE)  JOBQ(JOBQ1)  MAXPTY1(2)  MAXPTY7(0)
           MAXPTY8(0)  MAXPTY9(0) SEQNBR(99)

Cette commande ajoute un poste file d'attente de travaux pour la file d'attente de travaux JOBQ1 à la description de sous-système QBASE. Le numéro de séquence pour cette file d'attente de travaux prend la valeur 99. Les niveaux de priorité indiqués empêchent l'exécution des travaux ayant des niveaux de priorité compris entre 7 et 9.

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.