CRTPRXCMD

La commande CRTPRXCMD permet de créer une nouvelle définition de commande proxy définie par l'utilisateur. Cette définition de commande sera de type *CMD.

Une fois créée, la commande proxy ne peut pas être modifiée à l'aide de la commande CHGPRXCMD. D'autres interfaces spécifiques à cette commande qui font référence à une commande proxy permettent d'agir sur la commande indiquée au paramètre TGTCMD (Commande cible). La commande cible peut être une commande ordinaire ou encore une autre commande proxy. Il est possible d'enchaîner jusqu'à 5 commandes proxy. La dernière commande cible de la chaîne doit être une commande ordinaire. L'exécution de la commande CHGCMD ou CHGCMDDFT sur la commande proxy permet de modifier la commande cible. Lorsqu'une commande proxy est exécutée ou affichée sous forme d'invite, la commande cible l'est également.

Les autres opérations sur les objets non spécifiques aux commandes peuvent avoir des effets sur la commande proxy sans aucune conséquence sur la commande cible. Par exemple, le fait de déplacer une commande proxy dans une autre bibliothèque, de sauvegarder une commande proxy ou encore de supprimer une commande proxy n'a d'effet que sur l'objet *CMD proxy ; l'objet *CMD cible n'est pas affecté.

Paramètres

Commande (CMD)

Indique la commande proxy à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Commande

nom

Indiquez le nom de la commande proxy à créer.

Qualificatif 2 : Biblio

*CURLIB

La commande proxy est créé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 dans laquelle la commande proxy doit être placée.

Commande cible (TGTCMD)

Indique la commande cible utilisée pour le traitement de cette commande. Cette commande n'est pas nécessaire tant que la commande n'est pas utilisée dans une invite, une compilation ou dans l'exécution de la commande proxy. Les paramètres indiqués pour la commande proxy sont transmis à la commande cible afin d'être validés et interprétés. La commande cible peut être une commande ordinaire ou encore une autre commande proxy. Il est possible d'enchaîner jusqu'à 5 commandes proxy. La dernière commande cible de la chaîne doit être une commande ordinaire.

Ce paramètre est obligatoire.

Qualificatif 1 : Commande cible

nom

Indiquez le nom de la commande cible pour cette commande proxy.

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.

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

*CMDPMT

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

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Entrez un texte de 50 octets maximum, entre apostrophes.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*USE

L'utilisateur peut exécuter des opérations de base sur l'objet, telles que l'affichage d'une invite ou l'exécution d'une commande. Cet utilisateur ne peut pas modifier l'objet. Les droits d'utilisation (*USE) incluent les droits d'exploitation (*OBJOPR), de lecture (*READ), et d'exécute (*EXECUTE) sur les objets.

*LIBCRTAUT

Le système détermine les droits sur l'objet en utilisant la valeur définie dans l'invite Droits pour objets créés (paramètre CRTAUT) de la commande CRTLIB (Créer une bibliothèque) pour la bibliothèque qui contiendra les objets à créer. Si la valeur indiquée dans l'invite Droits pour objets créés (paramètre CRTAUT) est modifiée, la nouvelle valeur n'affectera aucun des objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom

Indiquez le nom d'une liste d'autorisation. Les droits sur l'objet définis dans cette liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister à la création de l'objet.

Remplacer commande (REPLACE)

Indique si une commande existante portant le même nom et figurant dans la même bibliothèque que la commande créée doit être remplacée ou non.

Si vous indiquez *YES et qu'une commande existe déjà sous le même nom et dans la même bibliothèque, elle est renommée et placée dans la bibliothèque QRPLOBJ, avant d'être supprimée lors du prochain IPL du système d'exploitation.

*YES

Si l'opération de création aboutit, la commande existante est remplacée par la nouvelle commande.

*NO

Une commande existante n'est pas remplacée et la création d'une nouvelle commande de même nom et figurant dans la même bibliothèque n'est pas admise.

Exemples

CRTPRXCMD CMD(QGPL/WJ) TGTCMD(WRKJOB)
          TEXT('WRKJOB Shortcut')

La commande proxy nommée WJ est créée dans la bibliothèque QGPL. Lors de l'affichage de l'invite ou de l'exécution de la commande WJ, la commande cible WRKJOB de a liste des bibliothèques est utilisée pour le traitement des paramètres de la commande WJ.

Messages d'erreur

Messages *ESCAPE

CPF0201

Commande &2 non créée dans la bibliothèque &3.