CRTCMD

La commande CRTCMD (Créer une commande) crée une commande définie par l'utilisateur (une définition de commande) pouvant utiliser le même support de traitement que les commandes fournies par IBM. La définition de commande est un objet qui peut être stocké dans la bibliothèque générale (QGPL) ou dans une bibliothèque utilisateur. Pour modifier une commande existante (par exemple pour changer l'un des mots clés), vous devez d'abord la supprimer à l'aide de la commande DLTCMD (Supprimer une commande), puis la recréer à l'aide de la commande CRTCMD (Créer une commande). Cependant, vous pouvez modifier certaines valeurs à l'aide de la commande CHGCMD (Modifier une commande).

Pour créer une commande, vous devez entrer une série d'instructions de définition dans un fichier source. La commande CRTCMD (Créer une commande) utilisera ce fichier source pour créer l'objet de définition de commande. Vous pouvez utiliser, selon le cas, les instructions de définition de commande suivantes :

• Instruction CMD (commande) : Requise pour chaque commande à définir.
• Instruction PARM (paramètre) : Requise pour chaque paramètre de la commande à définir ; elle indique le paramètre à transmettre au CPP (programme de traitement de commande).
• Instruction ELEM (élément) : Permet de préciser la définition d'un paramètre constitué d'une liste de valeurs (une instruction par élément de liste).
• Instruction QUAL (qualificatif) : Requise pour décrire chaque partie d'un nom qualifié pouvant être accepté pour un paramètre (défini par une instruction PARM) ou pour un élément d'une liste de valeurs (défini par une instruction ELEM).
• Instruction DEP (dépendant) : Indique les paramètres interdépendants.
• Instruction PMTCTL (contrôle d'invite) : Décrit les conditions de sélection d'un paramètre dans une invite.

Les descriptions des instructions de définition de commandes se trouvent dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restriction : La commande CRTCMD ne sert qu'à créer la définition d'une commande CL réelle, et non des définitions d'instructions (telles que les instructions de définition de commande elles-mêmes).

Paramètres

Commande (CMD)

Indique la commande à créer.

Qualificatif 1 : Commande

nom

Indiquez le nom de la commande à créer.

Ce paramètre est obligatoire.

Qualificatif 2 : Biblio

*CURLIB

La commande 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 doit être placée.

Programme de traitement de cde (PGM)

Indique le nom et la bibliothèque du CPP (programme de traitement de commande) utilisé pour traiter la commande. Le CPP n'est pas nécessaire avant l'exécution de la commande.

Les paramètres transmis au programme de traitement de commande sont ceux définis par les instructions de définition de commande du fichier source précisé en regard de l'invite Fichier source (paramètre SRCFILE).

Ce paramètre est obligatoire.

Valeurs uniques

*REXX

Le CPP utilisé pour traiter cette commande est la procédure REXX identifiée en regard de l'invite REXX Membre source (paramètre REXSRCMBR).

Qualificatif 1 : Programme de traitement de cde

nom

Indiquez le nom du programme CPP 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

Le programme est recherché 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 où se trouve le programme.

Fichier source (SRCFILE)

Indique le fichier source qui contient les instructions de définition de commande.

Qualificatif 1 : Fichier source

QCMDSRC

Le fichier source QCMDSRC contient les instructions de définition de commande.

nom

Indiquez le nom du fichier source contenant les instructions de définition de la commande à créer.

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

Le fichier source est recherché 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 du fichier source contenant les instructions de définition de la commande à créer.

Membre source (SRCMBR)

Indique le membre du fichier source contenant les instructions de définition de la commande à créer.

*CMD

Si le fichier indiqué dans l'invite Fichier source (paramètre) est un fichier base de données, le nom du membre du fichier source est celui indiqué pour l'invite Commande (paramètre CMD) de cette commande.

nom

Indiquez le nom du membre du fichier source précisé pour le paramètre SRCFILE.

Fichier STREAM source (SRCSTMF)

Indique le nom de chemin du fichier STREAM contenant les instructions de définition de la commande à créer.

Le nom du chemin d'accès peut être absolu ou relatif. Un nom de chemin d'accès absolu commence par '/' ; un nom de chemin d'accès relatif commence par un caractère autre que '/'.

S'il est absolu, le nom de chemin d'accès est complet. S'il est relatif, le nom de chemin d'accès est complété par l'ajout du répertoire de travail en cours du travail.

Les paramètres SRCMBR et SRCFILE ne peuvent pas être indiqués en même temps que le paramètre SRCSTMF.

REXX Fichier source (REXSRCFILE)

Indique le fichier source contenant le CPP (programme de traitement de commande) REXX.

Qualificatif 1 : REXX Fichier source

QREXSRC

Le fichier QREXSRC contient le membre du fichier source du CPP REXX.

nom

Indiquez le nom du fichier source contenant le membre source à utiliser.

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

Le fichier source est recherché 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 utilisée pour localiser le fichier source REXX.

REXX Membre source (REXSRCMBR)

Indique le membre du fichier source contenant la procédure REXX devant faire office de CPP (programme de traitement de commande) apparent.

*CMD

Le nom de membre par défaut est le nom indiqué dans l'invite Commande (paramètre CMD) de cette commande.

nom

Indiquez le nom du membre du fichier source contenant la procédure REXX devant faire office de CPP apparent.

REXX Environnement de commande (REXCMDENV)

Indique l'environnement de commande actif lors du démarrage du CPP (programme de traitement de commande) REXX. Si l'environnement CL (langage de contrôle) n'est pas utilisé, un programme peut être indiqué pour traiter les commandes trouvées dans la procédure REXX. L'interpréteur REXX appelle ce programme pour traiter les commandes rencontrées dans la procédure. Cet environnement peut être modifié à l'aide de l'instruction ADDRESS de REXX.

Valeurs uniques

*COMMAND

L'environnement de commande CL est utilisé.

*CPICOMM

L'Interface commune de programmation (CPI) est utilisée pour l'environnement de commande de communication. CPICOMM est l'environnement de commande utilisé pour les commandes CL incluses dans la procédure REXX.

*EXECSQL

L'environnement de commande SQL est utilisé. Cet environnement s'applique aux commandes CL imbriquées dans une procédure SQL.

Qualificatif 1 : REXX Environnement de commande

nom

Indiquez le nom du programme à appeler pour traiter les commandes imbriquées dans la procédure REXX.

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

Le programme est recherché 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 où se trouve le programme.

REXX Programmes d'exit (REXEXITPGM)

Indique les programmes d'exit à utiliser lors du démarrage du CPP (programme de traitement de commande) REXX. Huit combinaisons de programmes et codes d'exit au maximum peuvent être indiquées.

Valeurs uniques

*NONE

Il n'existe pas de programmes d'exit pour le CPP de la procédure REXX.

Elément 1 : Programme

Qualificatif 1 : Programme

nom

Indiquez le nom du programme d'exit.

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

Le programme est recherché 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 sur laquelle doit porter la recherche.

Elément 2 : Exit code

2

Le programme associé est appelé dès qu'une fonction externe ou un sous-programme est appelé par le programme REXX. Le programme d'exit contrôle alors la localisation et l'appel du sous-programme.

3

Le programme associé est appelé dès que l'interpréteur va appeler une commande. Le programme d'exit contrôle alors la localisation et l'appel de la commande, en fonction de la chaîne de celle-ci et du nom de l'environnement en cours.

4

Le programme associé est appelé dès qu'une instruction ou une fonction REXX tente d'exécuter une opération sur la file d'attente de données externes REXX.

5

Le programme associé est appelé lorsqu'une opération d'entrée ou de sortie au niveau d'une session est exécutée.

7

Le programme associé est appelé après l'exécution de chaque clause de la procédure REXX pour déterminer si une pause devrait être marquée.

8

Le programme associé est appelé après l'exécution de chaque clause du programme REXX pour déterminer si le traçage devrait être mis en fonction ou hors fonction.

9

Le programme associé est appelé avant l'interprétation de la première instruction de la procédure REXX (y compris si cette dernière est appelée en tant que fonction ou sous-programme externe).

10

Le programme associé est appelé après l'interprétation de la dernière instruction de la procédure REXX (y compris si cette dernière est appelée en tant que fonction ou sous-programme externe).

Unités d'exécution protégées (THDSAFE)

Indique si la commande admet les unités d'exécution protégées et si elle peut être exécutée dans un travail comportant plusieurs de ces unités.

*NO

La commande n'admet pas les unités d'exécution protégées et ne doit pas être exécutée dans un travail comportant plusieurs de ces unités.

*YES

La commande admet les unités d'exécution protégées et peut être exécutée dans un travail comportant plusieurs de ces unités.

*COND

La commande admet les unités d'exécution protégées sous certaines conditions uniquement. Consultez l'aide en ligne ou la documentation dont vous disposez pour connaître ces conditions.

Action travail exéc multiples (MLTTHDACN)

Indiquez pour cette commande l'action relative aux travaux à unités d'exécution multiples. Si vous ne savez pas quelle action doit être exécutée dans un travail à unités d'exécution multiples, utilisez la valeur par défaut *SYSVAL.

*SYSVAL

L'action relative aux travaux à unités d'exécution multiples indiquée à l'aide de la valeur système QMLTTHDACN est utilisée.

*RUN

Exécution de la commande.

*MSG

Exécution de la commande et envoi d'un message de diagnostic.

*NORUN

La commande n'est pas exécutée.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SRCMBRTXT

Le texte provient du membre du fichier source utilisé pour créer la commande CL.

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

Options pour liste source (OPTION)

Indique les options à utiliser lors de la compilation du membre source. Vous pouvez indiquer autant d'options que vous le souhaitez, dans l'ordre de votre choix. Séparez les options avec un ou plusieurs espaces. Si une option apparaît plusieurs fois, la dernière occurrence est utilisée.

Option de création de fichier événements

*NOEVENTF

Ne crée pas le fichier événements destiné aux outils client.

*EVENTF

Crée un fichier événements destiné aux outils client. Le fichier événements est créé en tant que membre du fichier EVFEVENT dans la bibliothèque destinée à recevoir la commande créée. Si le fichier EVFEVENT n'existe pas, il est créé automatiquement. Le nom de membre du fichier événements est le même que celui de l'objet en cours de création.

Pgm de contrôle de validité (VLDCKR)

Indique le programme qui effectue un contrôle de validité supplémentaire des paramètres de la commande créée. Les paramètres transmis au CPP sont également transmis au programme de contrôle de validité. Ce dernier effectue des vérifications complémentaires, au-delà de celles définies par les instructions de définition de commande dans le fichier source et de celles effectuées normalement sur la syntaxe par le langage de contrôle. Pour plus de détails, 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/.

Valeurs uniques

*NONE

Il n'existe pas de programme de contrôle de validité spécifique à cette commande. Toutes les vérifications de validité sont effectuées par l'analyseur de commandes et le programme de traitement de commande. Lors des vérifications, les variables et expressions fournies ne sont pas utilisées.

Qualificatif 1 : Pgm de contrôle de validité

nom

Indiquez le nom et la bibliothèque du programme de contrôle de validité.

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

Le programme est recherché 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 le programme de contrôle de validité.

Mode d'exécution (MODE)

Indique les environnement d'exploitation dans lesquels la commande peut être utilisée.

Valeurs uniques

*ALL

La commande est admise dans tous les environnements d'exploitation : production, débogage et maintenance.

Autres valeurs (jusqu'à 3 répétitions)

*PROD

La commande est admise en mode production.

*DEBUG

La commande est admise en mode débogage.

*SERVICE

La commande est admise en mode maintenance.

Environnement permis (ALLOW)

Définit l'environnement dans lequel la commande peut être traitée.

Valeurs uniques

*ALL

La commande peut être exécutée dans un flot de données en entrée en mode par lots, un programme CL, une procédure REXX, un module CL ILE ou un traitement interactif. Elle peut également être transmise aux programmes API système QCMDEXC, QCAEXEC et QCAPCMD pour traitement.

Autres valeurs (jusqu'à 9 répétitions)

*BATCH

La commande peut être exécutée dans un flot de données en entrée, en dehors d'un programme CL compilé.

*INTERACT

La commande peut être traitée en interactif, en dehors d'un programme CL compilé.

*BPGM

La commande peut être traitée dans un programme CL compilé qui est appelé en mode de traitement par lots.

*IPGM

La commande peut être traitée dans un programme CL compilé qui est appelé en mode interactif.

*BREXX

La commande peut être utilisée dans une procédure REXX exécutée dans un travail en traitement par lots.

*IREXX

La commande peut être utilisée dans une procédure REXX exécutée dans un travail interactif.

*BMOD

La commande ne peut être utilisée que dans un programme par lots CL ILE.

*IMOD

La commande ne peut être utilisée que dans un programme interactif CL ILE.

*EXEC

La commande peut être utilisée comme paramètre dans la commande CALL et être transmise aux programmes API système QCMDEXC, QCAEXEC et QCAPCMD pour traitement. Si *EXEC est indiqué, *BATCH ou *INTERACT doit l'être également.

Utilisation limitée permise (ALWLMTUSR)

Indique si un utilisateur dont le profil est défini avec possibilités restreintes est autorisé à exécuter la commande via une ligne de commande ou un menu.

*NO

Cette commande n'est pas accessible via la ligne de commande d'un menu aux utilisateurs dont le profil est défini avec possibilités restreintes.

*YES

Cette commande est accessible via la ligne de commande d'un menu aux utilisateurs dont le profil est défini avec possibilités restreintes.

Nb maxi param positionnels (MAXPOS)

Indique le nombre maximal de paramètres positionnels (sans mot clé de paramètre) pouvant être définis pour cette commande. Cette valeur de paramètre doit être supérieure au nombre de paramètres non constants requis et inférieure au nombre total de paramètres non constants. Ne sont pas inclus dans ce nombre maximal de paramètres positionnels les paramètres de TYPE(*ZEROELEM), les paramètres ayant l'attribut CONSTANT, ainsi que les listes et noms qualifiés dont les instructions QUAL et ELEM ont l'attribut CONSTANT ou qui sont de TYPE(*ZEROELEM).

*NOMAX

Il n'y a pas de nombre limite de paramètres positionnels pour cette commande.

0-99

Indiquez le nombre maximal de paramètres positionnels.

Fichier msg du texte d'invite (PMTFILE)

Indique le fichier message contenant le texte d'invite de la commande.

Valeurs uniques

*NONE

Aucun fichier message n'est nécessaire pour le texte d'invite. Ce texte fait partie, le cas échéant, des instructions de définition de commande.

Elément 1 : Fichier msg du texte d'invite

Qualificatif 1 : fichier message

nom

Indiquez le nom du fichier message.

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

Le fichier message est recherché 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 le fichier message.

Elément 2 : Texte du message

Indique comment la commande en cours de création utilisera les informations des messages d'invite stockées dans l'objet de commande lorsque cette dernière est appelée.

*STATIC

Lorsque la commande est demandée, le texte d'invite est extrait des copies statiques des messages stockés dans l'objet *CMD lors de la création de la commande. Si vous souhaitez que la commande puisse afficher du texte d'invite en plusieurs langues, vous devez créer un objet *CMD pour chaque langue.

*DYNAMIC

Lorsque la commande est demandée, des messages de texte d'invite sont extraits d'une manière dynamique du fichier message spécifié pour ce paramètre à l'aide des identificateurs de messages stockés dans l'objet *CMD lors de la création de la commande. L'identificateur de message spécifié pour le paramètre PROMPT ou CHOICE d'une instruction de définition de commande CMD, PARM, QUAL ou ELEM doit se trouver dans le fichier message de texte d'invite lorsque la commande est demandée.

S'il s'avère impossible de trouver le fichier message lorsque la commande est demandée, tout le texte d'invite est extrait des copies statiques des messages d'invite stockés dans l'objet *CMD. Si le fichier message est trouvé, mais qu'un message donné en est absent, la copie statique du texte d'invite stockée dans l'objet *CMD est utilisée pour ce message.

En créant une commande avec des identificateurs de messages spécifiés pour PROMPT et CHOICE, un fichier message a spécifié le premier élément de ce paramètre, *DYNAMIC a spécifié le deuxième élément, avec pour résultat une seule commande pouvant avoir du texte d'invite en plus d'une langue. En ayant une copie du fichier message de texte d'invite dans la langue souhaitée dans la liste des bibliothèques à l'invite, la même commande peut être demandée en plus d'une langue. Les commandes CL du système d'exploitation et la plupart des produits IBM utilisent l'option *DYNAMIC pour activer une seule copie de la commande pour traiter toutes les versions de langue installées.

fichier message (MSGF)

Indique le fichier message contenant les messages identifiés dans les instructions de définition de commande DEP. L'invite Identificateur de message (paramètre MSGID) des instructions DEP permet de préciser l'identificateur de message à envoyer si une erreur de syntaxe de paramètre est détectée. Pour les messages identifiés par un préfixe à trois caractères autre que 'CPF', le fichier message indiqué pour ce paramètre sera utilisé. QCPFMSG est toujours utilisé comme fichier message pour les messages dont l'identificateur comporte le préfixe 'CPF'.

Qualificatif 1 : fichier message

QCPFMSG

Le fichier message QCPFMSG contient les messages d'erreur DEP.

nom

Indiquez le nom du fichier message qui contient les messages d'erreur DEP.

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

Le fichier message est recherché 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 le fichier message.

Etagère d'aide (HLPSHELF)

Ce paramètre n'est plus pris en charge.

Groupe de panneaux d'aide (HLPPNLGRP)

Indique le groupe de panneaux d'aide spécifique à cette commande.

Valeurs uniques

*NONE

Aucun groupe de panneaux d'aide n'est défini.

Qualificatif 1 : Groupe de panneaux d'aide

nom

Indiquez le nom du groupe de panneaux d'aide spécifique à cette 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

Le groupe de panneaux est recherché 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 le groupe de panneaux.

Identificateur d'aide (HLPID)

Indique le nom racine de tous les identificateurs des sections d'aide pour cette commande. Toutes les sections d'aide du groupe de panneaux d'aide associé à cette commande commenceront par ce nom.

*NONE

Aucun identificateur d'aide n'est indiqué. *NONE n'est pas admis si un nom de groupe de panneaux est indiqué dans l'invite Groupe de panneaux d'aide (paramètre HLPPNLGRP).

*CMD

Le nom de la commande doit être utilisé comme racine pour les identificateurs des sections d'aide du groupe de panneaux d'aide.

nom

Indiquez le nom racine de tous les identificateurs des sections d'aide pour cette commande.

Index d'aide (HLPSCHIDX)

Indique le nom de l'index d'aide à utiliser lorsque vous appuyez sur la touche d'aide par index depuis l'écran d'aide.

Valeurs uniques

*NONE

Aucun index d'aide n'est associé à cette commande.

Qualificatif 1 : Index d'aide

nom

Indiquez le nom de l'index d'aide à utiliser lorsque vous appuyez sur la touche d'aide par index.

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

L'index d'aide est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant l'index d'aide.

Bibliothèque en cours (CURLIB)

Indique quelle bibliothèque en cours est associée au travail en cours.

Remarque :Cette bibliothèque est utilisée, le cas échéant, lors du traitement de la commande par le programme de contrôle de validité.

*NOCHG

La bibliothèque en cours reste la même pour le traitement de cette commande. Si elle est modifiée durant le traitement de la commande, les modifications restent actives une fois ce dernier terminé.

*CRTDFT

Aucune bibliothèque en cours n'est active pendant le traitement de la commande. La bibliothèque en cours utilisée avant le début de ce traitement est rétablie une fois celui-ci terminé.

Si *CURLIB est indiqué comme valeur cible de valeur particulière ou spéciale pour cette commande, ou pour toute autre commande exécutée sans qu'aucune bibliothèque en cours ne soit active, la bibliothèque QGPL est utilisée par défaut comme bibliothèque en cours.

nom

Indiquez le nom de la bibliothèque devant constituer la bibliothèque en cours. La bibliothèque peut ne pas exister lors de la création de la commande, mais doit exister lors de son traitement. Une fois celui-ci terminé, la bibliothèque en cours est rétablie à sa valeur précédente. Si la commande CHGLIBL (Modifier liste bibliothèques) ou CHGCURLIB (Modifier bibliothèque en cours) a été utilisée durant le traitement pour modifier la bibliothèque en cours, la modification ne prend effet que pendant le traitement de la commande. Vous ne pouvez pas indiquer QTEMP comme bibliothèque en cours.

Bibliothèque de logiciel (PRDLIB)

Indique la bibliothèque de logiciel à utiliser lors du traitement de la commande.

Remarque :La bibliothèque de logiciel relative à une commande ou à un menu reste dans la liste des bibliothèques tant que la commande ou le menu est actif, sauf si cette bibliothèque est modifiée par une autre commande ou un autre menu. Une fois cette modification terminée, la bibliothèque de logiciel est rétablie à la valeur en cours avant le démarrage de la commande ou du menu.

*NOCHG

La bibliothèque de logiciel est la même lors du démarrage du traitement de la commande. Si elle est modifiée durant le traitement de la commande, les modifications restent actives une fois ce traitement terminé.

*NONE

Il n'existe pas de bibliothèque de logiciel dans la liste des bibliothèques associée au travail. La valeur précédente de la bibliothèque de logiciel est rétablie une fois le traitement de la commande terminé.

nom

Indiquez le nom de la bibliothèque à utiliser comme bibliothèque de logiciel lors du traitement de la commande. La bibliothèque peut ne pas exister lors de la création de la commande, mais doit exister lors de son traitement. Une fois celui-ci terminé, la valeur antérieure de la bibliothèque de produit est rétablie. Vous ne pouvez pas indiquer QTEMP comme bibliothèque de produit.

Programme substitution invite (PMTOVRPGM)

Indique le nom et la bibliothèque du POP (programme de substitution d'invite) destiné à remplacer (sur l'écran d'invite) les valeurs par défaut par les valeurs en cours indiquées pour le paramètre. Si un POP est indiqué, les paramètres clés (KEYPARM(*YES) précisés dans l'instruction PARM du source de définition de la commande) sont les seuls paramètres visibles sur l'écran d'invite initial. Lorsque des valeurs sont entrées pour les paramètres clés, les autres paramètres apparaissent à l'écran avec les valeurs réelles au lieu des valeurs par défaut.

*NONE

Aucun POP n'est indiqué.

Remarque :Si *NONE est indiqué alors que des paramètres clés existent dans le source de définition de la commande (KEYPARM(*YES) précisé dans l'instruction PARM), le système envoie un message d'avertissement à la création de la commande et KEYPARM(*NO) est adopté pour tous les paramètres.

nom

Indiquez le nom du programme de substitution d'invite pour 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

Le POP est recherché 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 le POP.

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.

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

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

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

*NO

La commande existante n'est pas remplacée et la création de la nouvelle commande de même nom, type et bibliothèque n'est pas admise.

Interface graphique possible (ENBGUI)

Indique si les écrans d'invite de commande acceptent la conversion en interface graphique.

*NO

Les écrans d'invite de commande n'acceptent pas la conversion en interface graphique.

*YES

Les écrans d'invite de commande acceptent la conversion en interface graphique. Des informations sur leur contenu sont incluses dans le flot de données 5250.

Exemples

CRTCMD   CMD(PAYROLL)  PGM(PAY076)  SRCFILE(PAYSOURCE)
         AUT(*EXCLUDE)

La commande PAYROLL est créée à partir du fichier source PAYSOURCE. Il s'agit d'une commande privée qui appelle le programme de traitement de commandes PAY076. Elle est admise lorsqu'elle est indiquée dans un flot de données en entrée en mode par lots, lorsqu'elle est compilée dans un programme CL, lorsqu'elle est entrée de façon interactive ou lorsqu'elle est passé au programme QCMDEXC.

Messages d'erreur

Messages *ESCAPE

CPF0201

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

CPF0210

Ouverture du fichier imprimante impossible.

CPF0212

Ouverture du fichier source impossible.