CHGPJ

Modifier le travail anticipé

En bref

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

Syntaxe minimale

CHGPJ

Paramètres

OUTPTY Priorité de sortie (en OUTQ)
PRTTXT Texte à imprimer
PRTDEV Unité imprimante
OUTQ File d'attente en sortie
ACGCDE Code comptabilité

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

La commande CHGPJ (Modifier le travail anticipé) remplace les attributs du travail à démarrage anticipé à partir duquel la commande est émise par les attributs de la description de travail indiquée au poste des travaux à démarrage anticipé, ou par les attributs de la description de travail indiquée dans le profil associé à l'utilisateur en cours. Lorsqu'une demande de démarrage de programme est reçue, le système définit l'utilisateur en cours en fonction du profil utilisateur indiqué dans la demande. L'utilisateur en cours peut ensuite être modifié par l'API de définition de profil (QWTSETP).

Restrictions :

Pour utiliser cette commande, vous devez disposer des droits suivants :
- Droit *USE sur la description de travail et droit *EXECUTE sur la bibliothèque contenant cette description de travail.
- Droit *READ sur la file d'attente en sortie (OUTQ) et droit *EXECUTE sur la bibliothèque contenant cette file d'attente en sortie.
Cette commande doit être appelée uniquement par un travail anticipé qui traite une demande de démarrage de programme. Elle ne fonctionne pas avec les travaux de démarrage par lots.
Cette commande est à unités d'exécution protégées sous certaines conditions. Pour plus d'informations, reportez-vous à la section Remarques sur les attributs autorisant les unités d'exécution multiples.

Remarques sur les attributs autorisant les unités d'exécution multiples:

Cette commande permet de modifier les attributs du travail à démarrage anticipé dans lequel la commande a été lancée. Tous les attributs portent sur le travail.

La colonne Unités d'exécution multiples du tableau ci-après indique si les attributs peuvent être modifiés et permettre les unités d'exécution multiples.

Oui : - Les attributs associés à cette valeur autorisent les unités d'exécution multiples. Vous pouvez modifier ces attributs en entrant cette commande à partir de l'unité d'exécution initiale et d'une unité d'exécution secondaire.

Non : - Les attributs associés à cette valeur n'autorisent pas les unités d'exécution multiples. Toute tentative de modification de ces attributs est refusée si plusieurs unités d'exécution sont actives.

Tableau Attributs et unités d'exécution multiples autorisées:

Attribut                                 Unités d'exécution multiples
----------------------------     ----------
ACGCDE (Code de comptabilité du travail)          Non
OUTPTY (Priorité en sortie)                       Oui
OUTQ (File d'attente en sortie)                   Oui
PRTTXT (Texte à imprimer)                         Oui
PRTDEV  (Unité imprimante)                        Oui

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OUTPTY	Priorité de sortie (en OUTQ)	SAME, PGMSTRRQS, *PJE	Facultatif
PRTTXT	Texte à imprimer	SAME, PGMSTRRQS, *PJE	Facultatif
PRTDEV	Unité imprimante	SAME, PGMSTRRQS, *PJE	Facultatif
OUTQ	File d'attente en sortie	SAME, PGMSTRRQS, *PJE	Facultatif
ACGCDE	Code comptabilité	SAME, PGMSTRRQS, *PJE	Facultatif

Priorité de sortie (en OUTQ) (OUTPTY)

Indique la priorité de sortie pour les fichiers spoule en sortie produits par ce travail. Le système modifie les fichiers spoule en sortie dans les files d'attente en sortie, dans l'espace de nom de la bibliothèque pour l'unité d'exécution qui lance la commande.

*SAME: Cette valeur reste inchangée.
*PGMSTRRQS: La valeur indiquée dans la description de travail du profil de l'utilisateur en cours est utilisée.
*PJE: Le travail à démarrage anticipé utilisera la valeur indiquée dans la description de travail associée au poste travaux à démarrage anticipé de la description de sous-système.

Texte à imprimer (PRTTXT)

Indique le texte imprimé au bas de chaque page de la sortie imprimée, ainsi que sur les pages de séparation.

*SAME: Cette valeur reste inchangée.
*PGMSTRRQS: La valeur indiquée dans la description de travail du profil de l'utilisateur en cours est utilisée.
*PJE: Le travail à démarrage anticipé utilisera la valeur indiquée dans la description de travail associée au poste travaux à démarrage anticipé de la description de sous-système.

Unité imprimante (PRTDEV)

Indique le nom de l'unité imprimante par défaut utilisée pour ce travail.

*SAME: Cette valeur reste inchangée.
*PGMSTRRQS: La valeur indiquée dans la description de travail du profil de l'utilisateur en cours est utilisée. Si *USRPRF est indiqué pour ce paramètre dans la description de travail, le travail utilisera la valeur définie dans le profil de l'utilisateur en cours.
*PJE: Le travail à démarrage anticipé utilisera la valeur indiquée dans la description de travail associée au poste travaux à démarrage anticipé de la description de sous-système. Si *USRPRF est indiqué pour ce paramètre dans la description de travail, le travail utilisera la valeur définie dans le profil utilisateur associé au poste travaux à démarrage anticipé (paramètre USER).

File d'attente en sortie (OUTQ)

Indique le nom de la file d'attente en sortie pour les fichiers spoule en sortie générés par le travail anticipé. Cela n'affecte en rien les fichiers déjà créés par ce travail.

*SAME: Cette valeur reste inchangée.
*PGMSTRRQS: La valeur indiquée dans la description de travail du profil de l'utilisateur en cours est utilisée. Si *USRPRF est indiqué pour ce paramètre dans la description du travail, le travail utilisera la valeur définie dans le profil de l'utilisateur en cours.
*PJE: Le travail à démarrage anticipé utilisera la valeur indiquée dans la description de travail associée au poste travaux à démarrage anticipé de la description de sous-système. Si *USRPRF est indiqué pour ce paramètre dans la description de travail, le travail utilisera la valeur définie dans le profil utilisateur associé au poste travaux à démarrage anticipé (paramètre USER).

Code comptabilité (ACGCDE)

Indique le code de comptabilité utilisé pour ce travail.

*SAME: Le code comptabilité reste inchangé.
*PGMSTRRQS: La valeur indiquée dans la description de travail du profil de l'utilisateur en cours est utilisée. Si *USRPRF est indiqué pour ce paramètre dans la description du travail, le travail utilisera la valeur définie dans le profil de l'utilisateur en cours.
*PJE: Le travail à démarrage anticipé utilisera la valeur indiquée dans la description de travail associée au poste travaux à démarrage anticipé de la description de sous-système. Si *USRPRF est indiqué pour ce paramètre dans la description de travail, le travail utilisera la valeur définie dans le profil utilisateur associé au poste travaux à démarrage anticipé (paramètre USER).

Exemples

Exemple 1 : Modification de la priorité de sortie

CHGPJ   OUTPTY(*PGMSTRRQS)

Cette commande permet de remplacer la priorité de sortie des fichiers spoule par celle indiquée dans la description de travail associée au profil de l'utilisateur en cours.

Exemple 2 : Modification de la file d'attente en sortie

CHGPJ   OUTQ(*PJE)

Cette commande permet de remplacer la file d'attente en sortie des fichiers générés par ce travail par celle définie dans la description de travail indiquée dans le poste du travail à démarrage anticipé.

Messages d'erreur

Messages *ESCAPE

CPF1314: Valeur &1 non admise pour le paramètre &2.
CPF1317: Aucune réponse du sous-système pour le travail &3/&2/&1.
CPF1321: Travail &3/&2/&1 non trouvé.
CPF1332: Fin des noms dupliqués.
CPF1334: La modification demandée doit porter sur un travail interactif.
CPF1336: Erreurs dans la commande CHGJOB pour le travail &3/&2/&1.
CPF1337: &3/&2/&1 non autorisé à modifier paramètres.
CPF1340: Fonction de contrôle de travail non effectuée.
CPF1341: Lecteur/éditeur &3/&2/&1 non admis comme nom de travail.
CPF1343: Type du travail &3/&2/&1 incorrect pour la fonction.
CPF1344: Vous n'êtes pas autorisé à contrôler le travail &3/&2/&1.
CPF1351: Erreur dans le sous-système pour le travail &3/&2/&1.
CPF1352: Fonction non exécutée. &3/&2/&1 en transition.