ADDPJE

La commande Ajouter poste trav anticipés ADDPJE (Ajouter poste travaux à démarrage anticipé) permet d'ajouter un poste travaux à démarrage anticipé à la description de sous-système indiquée. Ce poste identifie les travaux à démarrage anticipé pouvant être lancés lors du démarrage du sous-système ou de l'exécution de la commande Démarrer travaux anticipés STRPJ (Démarrer les travaux anticipés).

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 sous-système indiquée, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant la description de sous-système
   • les droits opérationnels sur les objets (*OBJOPR) et de lecture (*READ) sur la description de travail, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette description de travail
   • le droit d'utilisation (*USE) sur le profil utilisateur
2. Seul un utilisateur détenant le droit spécial *ALLOBJ peut ajouter un poste qui ne possède pas de description de travail.

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 travaux à démarrage anticipé doit être ajouté. Si aucune bibliothèque n'est indiquée, la description de sous-système sera recherchée dans la liste des bibliothèques (*LIBL).

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 travaux à démarrage anticipé est ajouté.

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 le nom de la bibliothèque de la description de sous-système à laquelle le poste travaux à démarrage anticipé est ajouté.

Programme (PGM)

Indique le nom et la bibliothèque du programme lancé par le travail à démarrage anticipé. Ce nom est utilisé pour associer une demande à un travail à démarrage anticipé disponible. Si le programme n'existe pas lorsque le poste est ajouté, un qualifiant de bibliothèque doit être indiqué car le nom qualifié est conservé dans la description de sous-système.

Remarque :Une description de sous-système peut contenir deux postes comportant le même nom de programme, mais ceux-ci devront avoir des noms de bibliothèque différents.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom

Indiquez le nom du programme sous lequel s'exécutera le travail à démarrage anticipé.

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 du programme sous laquelle s'exécutera le travail à démarrage anticipé.

Profil utilisateur (USER)

Indique le nom du profil utilisateur avec lequel est initialisé le travail à démarrage anticipé. Le profil utilisateur en cours associé au travail à démarrage anticipé correspond également à cet utilisateur lorsque le travail est en attente de traitement d'une demande.

Remarque :Lorsqu'un travail à démarrage anticipé reçoit une demande à traiter, le profil utilisateur en cours associé au travail est mis à jour. Pour de plus amples informations sur la définition du profil, reportez-vous au manuel Work Management. Cette modification du profil utilisateur en cours s'applique uniquement à la vérification des droits. Toutefois, aucun des autres attributs du profil utilisateur, tels que CURLIB (bibliothèque en cours) ou INLPGM (programme initial à appeler), ne sera donné au travail à démarrage anticipé.

QUSER

Le travail s'exécutera sous le profil utilisateur QUSER fourni par IBM.

nom

Indiquez le nom du profil utilisateur sous lequel s'exécutera le travail à démarrage anticipé.

Démarrer les travaux (STRJOBS)

Indique si les travaux à démarrage anticipé seront lancés lors du démarrage du sous-système.

*YES

Les travaux à démarrage anticipé sont lancés lors du démarrage du sous-système.

*NO

Les travaux à démarrage anticipé ne sont pas lancés lors du démarrage du sous-système. Pour cela, il convient d'utiliser la commande Démarrer travaux anticipés STRPJ (Démarrer les travaux anticipés).

Nombre initial de travaux (INLJOBS)

Indique le nombre initial de travaux à démarrage anticipé à lancer lors du démarrage du sous-système précisé en regard de l'invite Description de sous-système (paramètre SBSD).

Remarques :

1. La valeur de ce paramètre doit être inférieure ou égale à celle indiquée en regard de l'invite Nombre maximal de travaux (paramètre MAXJOBS).
2. La valeur de ce paramètre doit être supérieure ou égale à celle indiquée en regard de l'invite Seuil (paramètre THRESHOLD).

3

Trois travaux à démarrage anticipé seront lancés lors du démarrage du sous-système.

1-9999

Indiquez le nombre de travaux à démarrage anticipé à lancer lors du démarrage du sous-système. Il doit être compris entre 1 et 9999.

Seuil (THRESHOLD)

Indique le moment où les travaux à démarrage anticipé supplémentaires sont lancés. Lorsque le pool de travaux disponibles (pour traiter des demandes) tombe en dessous de ce seuil, d'autres travaux (précisés en regard de l'invite Nombre additionnel de travaux (paramètre ADLJOBS)) sont lancés et ajoutés au pool disponible.

Remarque :La valeur de ce paramètre doit être inférieure ou égale à celle indiquée en regard de l'invite Nombre initial de travaux (paramètre INLJOBS).

2

Lorsqu'un travail à démarrage anticipé est disponible, d'autres travaux (indiqués en regard de l'invite Nombre additionnel de travaux (ADLJOBS)) sont lancés.

1-9999

Indiquez le nombre minimal de travaux à démarrage anticipé nécessaires pour le lancement des travaux supplémentaires. Il doit être compris entre 1 et 9999.

Nombre additionnel de travaux (ADLJOBS)

Indique le nombre additionnel de travaux à démarrage anticipé à lancer lorsque le nombre de travaux disponibles tombe en dessous du seuil précisé en regard de l'invite Seuil (paramètre THRESHOLD).

Remarque :La valeur de ce paramètre doit être inférieure à celle précisée en regard de l'invite Nombre maximal de travaux (paramètre MAXJOBS).

2

Deux travaux à démarrage anticipé supplémentaires sont lancés.

0-999

Indiquez le nombre de travaux à démarrage anticipé supplémentaires à lancer. Ce nombre doit être compris entre 0 et 999.

Nombre maximal de travaux (MAXJOBS)

Indique le nombre maximal de travaux à démarrage anticipé pouvant être actifs simultanément pour ce poste. Cette valeur inclut les travaux à démarrage anticipé qui répondent à une demande de démarrage, ceux qui sont en attente de répondre à une demande de démarrage et ceux qui sont lancés parce qu'ils ont atteint la valeur indiquée en regard de l'invite Seuil (paramètre THRESHOLD).

Remarques :

1. La valeur de ce paramètre doit être supérieure ou égale à celle indiquée en regard de l'invite Nombre initial de travaux (paramètre INLJOBS).
2. La valeur de ce paramètre doit être supérieure à celle indiquée en regard de l'invite Nombre additionnel de travaux (paramètre ADLJOBS).

*NOMAX

Il n'y a aucun nombre maximal de travaux à démarrage anticipé pouvant être actifs simultanément.

1-32000

Indiquez le nombre maximal de travaux à démarrage anticipé pouvant être actifs simultanément. Les valeurs possibles sont comprises entre 1 et 32000.

Travail (JOB)

Indique le nom du travail à démarrage anticipé à lancer. Ce type de travail est lancé automatiquement lorsque le sous-système, défini en regard de l'invite Description de sous-système (paramètre SBSD), est lancé, et que le paramètre STRJOBS(*YES) est indiqué.

*PGM

Le nom du travail est identique à celui indiqué en regard de l'invite Programme (paramètre PGM).

nom-travail

Indiquez le nom du travail à démarrage anticipé.

Description de travail (JOBD)

Indique le nom qualifié de la description de travail utilisée pour le travail à démarrage anticipé. Si la description de travail n'existe pas lors de l'ajout du poste, vous devez indiquer un qualifiant de bibliothèque car le nom qualifié de la description de travail est conservé dans la description de sous-système.

Remarque :Seul un utilisateur détenant les droits spéciaux sur tous les objets (*ALLOBJ) est admis à ajouter ou modifier un élément qui ne possède pas de description de travail.

Valeurs uniques

*USRPRF

La description de travail désignée dans le profil utilisateur précisé en regard de l'invite Profil utilisateur (paramètre USER) est utilisée.

*SBSD

La description de travail dont le nom est identique à celui indiqué en regard de l'invite Description de sous-système (paramètre SBSD) est utilisée.

Qualificatif 1 : Description de travail

nom

Indiquez le nom de la description de travail à utiliser pour ce travail à démarrage anticipé.

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 le nom de la bibliothèque de la description de travail.

Nombre maximal d'utilisations (MAXUSE)

Indique le nombre maximal de demandes que chaque travail à démarrage anticipé du pool pourra traiter avant d'être arrêté.

200

Le travail à démarrage anticipé pourra traiter au plus 200 demandes avant d'être arrêté et qu'un autre travail à démarrage anticipé ne prenne le relais.

*NOMAX

Il n'y a aucun nombre maximal de demandes qu'un travail à démarrage anticipé pourra traiter. Le travail ne sera pas arrêté par le sous-système.

Remarque :Evitez de garder des travaux trop longtemps car la taille maximale de l'historique du travail pourrait être dépassée. De même, évitez les situations où les travaux pourraient générer un nombre de fichiers spoule supérieur à la valeur maximale ou dépasser le temps UC maximal ou encore l'allocation maximale de mémoire temporaire.

1-1000

Indiquez le nombre maximal de demandes qu'un travail à démarrage anticipé peut traiter avant son arrêt. Ce nombre doit être compris entre 1 et 1000.

Attente de travail (WAIT)

Indique si les demandes de démarrage de programme doivent être rejetées ou rester en attente lorsqu'un travail à démarrage anticipé n'est pas immédiatement disponible.

Remarque :Reportez-vous au manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ pour déterminer le délai d'attente en fonction du type de communication utilisé.

*YES

Les demandes de démarrage de programme attendront qu'un travail à démarrage anticipé soit disponible, ou alors un autre travail à démarrage anticipé sera lancé pour traiter la demande.

*NO

Les demandes de démarrage de programme seront rejetées si aucun travail à démarrage anticipé n'est disponible.

Identificateur du pool (POOLID)

Indique l'identificateur du pool du sous-système dans lequel s'exécuteront les travaux à démarrage anticipé.

1

Les travaux s'exécuteront dans le pool 1.

1-10

Indiquez l'identificateur du pool du sous-système dans lequel les travaux s'exécuteront. Cette valeur doit être comprise entre 1 et 10.

Classe (CLS)

Indique le nom et la bibliothèque des classes sous lesquelles s'exécutent les travaux à démarrage anticipé ainsi que le nombre de travaux par classe. Les premiers travaux démarrent en utilisant la première classe indiquée, ceci jusqu'à ce que le nombre de travaux indiqués pour cette classe soit atteint. Les travaux suivants démarrent alors avec la seconde classe. Si la classe n'existe pas encore lors de l'ajout du poste de travail anticipé, il convient d'indiquer un qualifiant de bibliothèque car le nom qualifié de la classe est conservé dans la description du sous-système.

Remarque :Deux classes peuvent être indiquées pour ce paramètre.

Elément 1 : Classe

Valeurs uniques

*SBSD

Les travaux à démarrage anticipé s'exécuteront sous la classe dont le nom est identique à celui indiqué en regard de l'invite Description de sous-système (paramètre SBSD).

Qualificatif 1 : Classe

nom

Indiquez le nom de la classe à utiliser pour les travaux à démarrage anticipé.

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 le nom de bibliothèque de la classe à utiliser pour les travaux à démarrage anticipé.

Elément 2 : Nb travaux utilisant la classe

*CALC

Le système calcule le nombre de travaux à démarrage anticipé qui s'exécuteront sous cette classe. Si une seule classe est précisée et que *CALC est indiquée, tous les travaux utiliseront cette classe. Si deux classes sont précisées et que *CALC est défini pour les deux, la première classe correspondra à la valeur précisée en regard de l'invite Nombre maximal de travaux (paramètre MAXJOBS) divisée par deux, et la seconde à celle du paramètre MAXJOBS moins la valeur calculée pour la première classe. Si un nombre précis de travaux est donné pour une classe et que *CALC est indiquée pour l'autre, le système calculera la différence entre la valeur du paramètre MAXJOBS et nombre de travaux indiqué pour la valeur *CALC.

*MAXJOBS

Tous les travaux à démarrage anticipé utiliseront la classe indiquée.

0-32766

Indiquez le nombre de travaux utilisant cette classe. La somme des valeurs pour les deux classes doit correspondre à la valeur indiquée au paramètre MAXJOBS.

Elément 3 : Classe

Valeurs uniques

*NONE

Indiquez cette valeur si et seulement si une classe est utilisée pour ce poste de travail à démarrage anticipé.

*SBSD

Les travaux à démarrage anticipé s'exécuteront sous la classe dont le nom est identique à celui indiqué en regard de l'invite Description de sous-système (paramètre SBSD).

Qualificatif 1 : Classe

nom

Indiquez le nom de la classe à utiliser pour les travaux à démarrage anticipé.

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 le nom de bibliothèque de la classe à utiliser pour les travaux à démarrage anticipé.

Elément 4 : Nb travaux utilisant la classe

*CALC

Le système calcule le nombre de travaux à démarrage anticipé qui s'exécuteront sous cette classe. Si une seule classe est précisée et que *CALC est indiquée, tous les travaux utiliseront cette classe. Si deux classes sont précisées et que *CALC est défini pour les deux, la première classe correspondra à la valeur précisée en regard de l'invite Nombre maximal de travaux (paramètre MAXJOBS) divisée par deux, et la seconde à celle du paramètre MAXJOBS moins la valeur calculée pour la première classe. Si un nombre précis de travaux est donné pour une classe et que *CALC est indiquée pour l'autre, le système calculera la différence entre la valeur du paramètre MAXJOBS et nombre de travaux indiqué pour la valeur *CALC.

*MAXJOBS

Tous les travaux à démarrage anticipé utiliseront la classe indiquée.

0-32766

Indiquez le nombre de travaux utilisant cette classe. La somme des valeurs pour les deux classes doit correspondre à la valeur indiquée au paramètre MAXJOBS.

Affinité ress unité exécution (THDRSCAFN)

Indique l'affinité des unités d'exécution par rapport aux ressources système.

Valeurs uniques

*SYSVAL

Lors du lancement du travail à démarrage anticipé, c'est la valeur d'affinité des ressources de l'unité d'exécution, issue de la valeur système QTHDRSCAFN, qui est utilisée.

Elément 1 : Groupe

*NOGROUP

Les travaux à démarrage anticipé auront une affinité avec un groupe de processeurs et une mémoire. Les unités d'exécution secondaires en cours de fonctionnement derrière le travail n'auront pas obligatoirement d'affinité avec le même groupe de processeurs et la même mémoire.

*GROUP

Les travaux à démarrage anticipé auront une affinité avec un groupe de processeurs et une mémoire. Les unités d'exécution secondaires en cours de fonctionnement derrière le travail auront une affinité avec le même groupe de processeurs et la même mémoire que l'unité d'exécution initiale.

Elément 2 : Niveau

*NORMAL

Une unité d'exécution utilisera n'importe quel processeur ou mémoire du système à partir du moment où les ressources avec lesquelles il a une affinité ne sont pas immédiatement disponibles.

*HIGH

Une unité d'exécution utilise uniquement les ressources avec lesquelles elle a une affinité, et, si besoin, attend leur disponibilité.

Groupe affinité de ressources (RSCAFNGRP)

Indique si des travaux à démarrage anticipé utilisant ce poste sont regroupés pour leur permettre d'avoir une affinité avec les mêmes ressources système (processeurs et mémoire). La valeur *YES est prioritaire sur la valeur système QTHDRSCAFN *NOGROUP.

*NO

Les travaux à démarrage anticipé utilisant cet élément ne sont pas regroupés.

*YES

Les travaux à démarrage anticipé utilisant ce poste sont regroupés de sorte qu'ils aient une affinité avec les mêmes ressources système. Les travaux qui partagent des données dans la mémoire s'exécutent mieux s'ils ont une affinité avec les mêmes ressources.

Exemples

Exemple 1 : spécification des travaux à démarrage anticipé supplémentaires

ADDPJE   SBSD(QGPL/PJSBS)  PGM(QGPL/PGM1)  INLJOBS(15)
         THRESHOLD(5)  ADLJOBS(10)  WAIT(*NO)

Cette commande ajoute un poste travail à démarrage anticipé pour le programme PGM1 dans la bibliothèque QGPL à la description de sous-système PJSBS contenue dans la bibliothèque QGPL. Le poste indique que 15 travaux à démarrage anticipé (programme PGM1 de la bibliothèque QGPL) sont démarrés lorsque le sous-système PJSBS de la bibliothèque QGPL est démarré. Lorsque le pool des travaux disponibles à démarrage anticipé est réduit à quatre (parce que les travaux à démarrage anticipé servent des requêtes indiquées pour le programme PGM1 dans la bibliothèque QGPL), dix travaux supplémentaires sont alors démarrés. Si aucun travail à démarrage anticipé n'est disponible pour ce poste lorsqu'une requête est reçue, cette dernière est rejetée.

Exemple 2 : spécification d'un nombre maximum de travaux à démarrage anticipé

ADDPJE   SBSD(QGPL/PJSBS)  PGM(QGPL/PGM2)  USER(PJUSER)
         MAXJOBS(100) CLS(QGPL/CLS1 75 QGPL/CLS2 *CALC)
         MAXUSE(50)

Cette commande ajoute un poste travail à démarrage anticipé pour le programme PGM2 de la bibliothèque QGPL à la description de sous-système PJSBS contenue dans la bibliothèque QGPL. Le poste indique que le travail à démarrage anticipé pour ce poste s'exécute sous le profil utilisateur PJUSER. Le nombre maximal de travaux à démarrage anticipé pouvant être actifs simultanément pour ce poste est 100. Chaque travail à démarrage anticipé du pool peut traiter 50 requêtes avant la fin du travail. Si 100 travaux à démarrage anticipé sont actifs simultanément pour ce poste, 75 d'entre eux utiliseront CLS1 dans la bibliothèque QGPL et 25 d'entre eux utiliseront CLS2 dans la bibliothèque QGPL. Si 50 travaux à démarrage anticipé sont actifs simultanément pour ce poste, ils utiliseront tous la classe CLS1 dans la bibliothèque QGPL.

Messages d'erreur

Messages *ESCAPE

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.