CHGPJE

Modifier poste trav anticipés

En bref

La commande Modifier poste trav anticipés CHGPJE (Modifier un poste de travail à démarrage anticipé) permet de modifier un poste travail à démarrage anticipé existant dans la description de sous-système indiquée.

CHGPJE se lit CHG (Modifier) + PJE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGPJE SBSD(…) PGM(…)

Paramètres

SBSD Description de sous-système obligatoire
PGM Programme obligatoire
USER Profil utilisateur
STRJOBS Démarrer les travaux
INLJOBS Nombre initial de travaux
THRESHOLD Seuil
ADLJOBS Nombre additionnel de travaux
MAXJOBS Nombre maximal de travaux
JOB Travail
JOBD Description de travail
MAXUSE Nombre maximal d'utilisations
WAIT Attente de travail
POOLID Identificateur du pool
CLS Classe
THDRSCAFN Affinité ress unité exécution
RSCAFNGRP Groupe affinité de ressources

Astuce : dans une session 5250, tapez CHGPJE 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

Le sous-système peut être actif lors de la modification du poste travaux à démarrage anticipé. Dans ce cas, les modifications effectuées prennent effet ultérieurement. Tout nouveau travail à démarrage anticipé lancé par la suite utilisera les nouvelles valeurs. Cette commande 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 :

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
Seul un utilisateur détenant le droit spécial *ALLOBJ peut modifier un poste qui ne possède pas de description de travail.

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
PGM	Programme	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Programme	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
USER	Profil utilisateur	Nom, *SAME	Facultatif
STRJOBS	Démarrer les travaux	SAME, YES, *NO	Facultatif
INLJOBS	Nombre initial de travaux	1-9999, *SAME	Facultatif
THRESHOLD	Seuil	1-9999, *SAME	Facultatif
ADLJOBS	Nombre additionnel de travaux	0-999, *SAME	Facultatif
MAXJOBS	Nombre maximal de travaux	1-32000, SAME, NOMAX	Facultatif
JOB	Travail	Nom, SAME, PGM	Facultatif
JOBD	Description de travail	Valeurs uniques: SAME, USRPRF, SBSD Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Description de travail	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MAXUSE	Nombre maximal d'utilisations	1-1000, SAME, NOMAX	Facultatif
WAIT	Attente de travail	SAME, YES, *NO	Facultatif
POOLID	Identificateur du pool	1-10, *SAME	Facultatif
CLS	Classe	Liste d'éléments	Facultatif
	Élément 1: Classe	Valeurs uniques: SAME, SBSD Autres valeurs: Nom d'objet qualifié
	Qualificatif 1: Classe	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
	Élément 2: Nb travaux utilisant la classe	0-32766, SAME, CALC, *MAXJOBS
	Élément 3: Classe	Valeurs uniques: SAME, NONE, SBSD Autres valeurs: Nom d'objet qualifié*
	Qualificatif 1: Classe	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
	Élément 4: Nb travaux utilisant la classe	0-32766, SAME, CALC, *MAXJOBS
THDRSCAFN	Affinité ress unité exécution	Valeurs uniques: SAME, SYSVAL Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Groupe	NOGROUP, GROUP
	Élément 2: Niveau	NORMAL, HIGH
RSCAFNGRP	Groupe affinité de ressources	SAME, NO, *YES	Facultatif

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système qui contient le poste travaux à démarrage anticipé à 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 de travail à démarrage anticipé est modifié.

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 de la description de sous-système associée au poste travaux à démarrage anticipé à modifier.

Programme (PGM)

Indique le nom et la bibliothèque du programme identifiant le poste de travail à démarrage anticipé à modifier. Ce nom est utilisé pour associer une demande à un travail à démarrage anticipé disponible. 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. 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.

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

*SAME: La valeur de ce paramètre ne change pas.
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é sont lancés lors du démarrage du sous-système.

*SAME: La valeur en cours ne change pas.
*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. La commande Démarrer travaux anticipés STRPJ (Démarrer les travaux anticipés) doit donc être utilisée.

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

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).
La valeur de ce paramètre doit être inférieure ou égale à celle indiquée en regard de l'invite Seuil (paramètre THRESHOLD).

*SAME: Le nombre de travaux à démarrage anticipé lancés lors du démarrage du sous-système ne change pas.
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. Ce seuil est contrôlé chaque fois qu'un travail à démarrage anticipé est associé à une demande de lancement de procédure.

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

*SAME: La valeur de ce paramètre ne change pas.
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).

*SAME: La valeur de ce paramètre ne change pas.
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.

Remarques

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).
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).
Si la valeur de ce paramètre est modifiée, la valeur précisée en regard de l'invite Classe (paramètre CLS) devra l'être également.

*SAME: Le nombre de travaux à démarrage anticipé pouvant être actifs simultanément ne change pas.
*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é.

*SAME: Le nom du travail ne change pas.
*PGM: Le nom du travail est celui du programme indiqué en regard de l'invite Programme (paramètre PGM).
nom: Indiquez le nom du travail à démarrage anticipé.

Description de travail (JOBD)

Indique le nom et la bibliothèque de la description de travail utilisée pour le travail à démarrage anticipé. Si la description de travail n'existe pas lors de la modification du poste, un qualifiant de bibliothèque doit être indiqué 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

*SAME: La description de travail ne change pas.
*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é pourra traiter avant d'être arrêté de façon contrôlée par le sous-système à l'aide de la commande Arrêter un travail ENDJOB, avec le paramètre Type d'arrêt OPTION (*CNTRLD).

*SAME: La valeur reste inchangée.
*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.
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 :Pour déterminer une temporisation, reportez-vous à la brochure relative au type de communications utilisé.

*SAME: La valeur de ce paramètre ne change pas.
*YES: Les demandes de démarrage de programme attendront qu'un travail à démarrage anticipé soit disponible, ou qu'un autre soit lancé.
*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é.

*SAME: La valeur de ce paramètre ne change pas.
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 maximal 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. Lorsque le nombre de travaux indiqués pour la première classe est atteint, les travaux de la seconde classe sont démarrés. Si la classe indiquée n'existe pas lors de la modification de ce poste, un qualifiant de bibliothèque doit être précisé car le nom qualifié de la classe est conservé dans la description de sous-système.

Remarques

Ce paramètre admet deux classes.
Si la valeur précisée en regard de l'invite Nombre maximal de travaux (paramètre MAXJOBS) est modifiée, le nombre de travaux précisé pour ce paramètre doit l'être également. Si les valeurs *CALC ou *MAXJOBS sont indiquées, le système recalcule le nombre de travaux devant utiliser la classe indiquée.

Elément 1 : Classe

Valeurs uniques

*SAME: La classe reste inchangée.
*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

*SAME: Le nombre de travaux utilisant cette classe reste inchangé.
*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

*SAME: La seconde classe, si elle été préalablement précisée, reste inchangée.
*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

*SAME: Le nombre de travaux utilisant la seconde classe reste inchangé.
*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

*SAME: L'affinité des ressources de l'unité d'exécution reste inchangée.
*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.

*SAME: Le groupe d'affinité des ressources reste inchangé.
*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

CHGPJE   SBSD(QGPL/PJSBS)  PGM(QGPL/PGM1)  STRJOBS(*NO)
         THRESHOLD(1)  ADLJOBS(1)

Cette commande modifie le poste travail à démarrage anticipé pour le programme PGM1 de la bibliothèque QGPL dans la description de sous-système PJSBS contenue dans la bibliothèque QGPL. Les travaux à démarrage anticipé associés à ce poste ne sont pas lancés lorsque la description de sous-système PJSBS de la bibliothèque QGPL est de nouveau lancée. La commande STRPJ est requise pour lancer les travaux à démarrage anticipé. Lorsque d'autres travaux doivent être lancés, un travail supplémentaire est lancé.

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.