CHGPRXCMD

Modifier commande proxy

En bref

La commande CHGPRXCMD permet de modifier certains des attributs d'une commande proxy.

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

Syntaxe minimale

CHGPRXCMD CMD(…)

Paramètres

CMD Commande obligatoire
TGTCMD Commande cible
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGPRXCMD 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 CHGPRXCMD permet de modifier certains des attributs d'une commande proxy. Les programmes CL utilisant la commande proxy modifiée n'ont pas à être recréés. La commande CHGPRXCMD ne modifie pas l'objet de définition de commande cible.

Restrictions :

Vous devez disposer des droits de gestion (*OBJMGT) sur la commande en cours de modification.
La commande CHGPRXCMD permet de modifier uniquement les attributs qui sont indiqués dans la commande CRTPRXCMD.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CMD	Commande	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Commande	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TGTCMD	Commande cible	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif, positionnel 2
	Qualificatif 1: Commande cible	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, SYSTEM, NLVLIBL
TEXT	Texte 'descriptif'	Valeur caractère, SAME, CMDPMT, TGTCMD, BLANK	Facultatif

Commande (CMD)

Indique la commande proxy à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Commande

nom: Indiquez le nom de la commande proxy à modifier.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La commande est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque contenant la commande.

Commande cible (TGTCMD)

Indique la commande cible pour cette commande proxy. Tous les paramètres indiqués pour la commande proxy seront validés et traités à l'aide de la commande cible indiquée.

Valeurs uniques

*SAME: La commande cible ne change pas.

Qualificatif 1 : Commande cible

nom: Indiquez le nom de la commande cible qui traite la commande.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La commande est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
*SYSTEM: La commande est recherchée uniquement dans la bibliothèque QSYS. Si un programme d'exit est enregistré pour le point d'exit QIBM_QCA_CHG_COMMAND, il est autorisé à modifier la commande.
*NLVLIBL: La commande est recherchée uniquement dans les bibliothèques en version langue nationale de la liste des bibliothèques et dans la bibliothèque QSYS. Si un programme d'exit est enregistré pour le point d'exit QIBM_QCA_CHG_COMMAND, il est autorisé à modifier la commande.
nom: Indiquez le nom de la bibliothèque contenant la commande.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte, s'il existe, ne change pas.

*CMDPMT: La description du texte sera identique au titre de la commande affiché lorsque la commande est demandée.

*TGTCMD: Le texte descriptif de la commande cible sera utilisé pour décrire la commande proxy. Si la commande cible n'existe pas au moment de l'exécution de cette commande, le texte descriptif de la commande proxy sera le nom qualifié de la commande cible.
*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Entrez un texte de 50 octets maximum, entre apostrophes.

Exemples

CHGPRXCMD CMD(QGPL/WRKJOB) TGTCMD(QSYS/DSPJOB)
          TEXT('Alias WRKJOB to DSPJOB')

La commande proxy nommée WRKJOB dans la bibliothèque QGPL est modifiée afin d'utiliser DSPJOB dans QSYS comme commande cible. Lors de l'affichage de l'invite ou de l'exécution de la commande QGPL/WRKJOB, la commande cible DSPJOB de la bibliothèque QSYS est utilisée pour le traitement des paramètres de la commande WRKJOB.

Messages d'erreur

Messages *ESCAPE

CPF6209: Bibliothèque &1 non trouvée.
CPF6210: Commande &1 non trouvée dans la bibliothèque &2.
CPF6211: Non autorisé à modifier la commande &1.
CPF6212: Commande &1 non modifiée.
CPF6213: Impossible d'allouer la commande &1 dans la bibliothèque &2.
CPF6214: Erreurs lors de la modification de la commande &1.
CPF6215: La commande &1 dans la bibliothèque &2 ne peut pas être modifiée.
CPF6216: La commande &1 est incorrecte pour la commande &2.
CPF6219: Non autorisé à accéder à la bibliothèque &2.