CHGCMDDFT

La commande CHGCMDDFT (Modifier les valeurs par défaut de la commande) permet de changer la valeur par défaut d'un paramètre.

Seuls les paramètres qui possèdent une valeur par défaut peuvent recevoir une nouvelle valeur. La commande modifiée peut être soit fournie par IBM, soit définie par l'utilisateur.

Pour savoir quels paramètres d'une commande sont associés à des valeurs par défaut, tapez le nom de la commande et appuyez sur F4 (Invite). Les valeurs de paramètres par défaut s'affichent sur le premier écran d'invite de la commande. Si un paramètre est constitué d'une liste d'éléments ou d'un nom qualifié, il peut être associé à une valeur particulière (SNGVAL) par défaut, qui s'applique alors à toute la liste ou au nom qualifié. Par exemple, DSPJOB (Afficher l'état d'un travail) est une commande dans laquelle JOB désigne une liste d'éléments auxquels s'applique une valeur particulière (SNGVAL) par défaut. Pour plus de détails sur cette dernière, reportez-vous à la rubrique "Informations connexes".

La nouvelle valeur par défaut doit être admise par le paramètre modifié. Pour connaître les valeurs admises, placez le curseur sur la valeur par défaut affichée et appuyez sur la touche F4. L'écran Définition de valeur pour paramètre affiche la liste des valeurs admises et/ou la valeur du type de paramètre. Lorsque seule la liste de valeurs est affichée, seules ces dernières peuvent être utilisées comme nouvelles valeurs par défaut. Dans le cas contraire, vous pouvez utiliser toute valeur conforme aux critères du paramètre comme nouvelle valeur par défaut.

Traiter une commande dont les valeurs par défaut ont été précédemment modifiées revient à indiquer la nouvelle valeur par défaut du paramètre avec une copie non modifiée de cette même commande. La nouvelle valeur par défaut peut entrer en conflit avec d'autres combinaisons de paramètre lorsque le paramètre n'est pas explicitement spécifié.

Les nouvelles valeurs par défaut ne sont pas utilisables si la commande système qui les contient est exécutée à partir d'un écran système. Cela est dû au fait que le système ne peut pas utiliser l'unité de commande pour traiter une fonction. En revanche, il peut utiliser une unité interne IBM associée à un programme système pour exécuter la fonction demandée. Par conséquent, si vous exécutez la commande à partir d'un écran système, appuyez sur la touche F4 (Invite) pour afficher une invite permettant de traiter la commande. Dans ce cas, c'est la valeur par défaut indiquée qui est presque toujours utilisée.

Pour modifier une commande fournie par IBM, vous devez en créer une copie dans une bibliothèque utilisateur et changer les valeurs par défaut de cette copie, et non de la commande d'origine. La bibliothèque utilisateur doit figurer avant QSYS dans la liste des bibliothèques. Sauvegardez le source de la commande CHGCMDDFT de sorte que les mêmes modifications puissent être effectuées à nouveau ultérieurement. Cette procédure vous permet d'utiliser, le cas échéant, les valeurs par défaut d'origine de la commande fournie par IBM et d'éviter la suppression des modifications apportées aux commandes copiées si une nouvelle édition est installée ou si une PTF contenant la commande fournie par IBM est appliquée.

L'installation d'une nouvelle édition ou l'application d'une PTF contenant les commandes fournies par IBM peut provoquer un incident de compatibilité. En effet, si vous avez copié une commande fournie par IBM dans une bibliothèque utilisateur, cette copie ne s'exécutera pas correctement si la nouvelle version de la commande comporte de nouveaux paramètres. Cela résulte des non-concordances entre la commande copiée et le programme de traitement de commande fourni par IBM qui vient d'être installé. Pour la même raison, la commande copiée ne s'exécuterait pas correctement dans le programme de démarrage du profil utilisateur et la session ne pourrait pas être ouverte. Par conséquent, l'utilisateur ne peut pas ouvrir de session sur le système. Pour éviter cela, vous devez vous assurer qu'il existe sur le système au moins un profil utilisateur disposant des droits requis pour apporter les modifications appropriées aux programmes de démarrage et utilisant QCMD comme programme de démarrage. Vous avez également la possibilité de coder les programmes de démarrage afin de détecter toutes les erreurs et de les corriger en affichant l'écran Entrée de commandes (programme QCMD).

Le manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ contient les recommandations et exemples pour l'utilisation de la commande CHGCMDDFT (Modifier valeurs par défaut de commande).

Informations complémentaires

Pour un mot clé défini comme liste d'éléments ou comme nom qualifié, et dont la valeur par défaut est SNGVAL, un élément ou un qualificatif peut être indiqué comme premier élément de la liste d'éléments ou de noms qualifiés. La valeur par défaut SNGVAL peut être remplacée par une autre valeur SNGVAL admise s'il en existe une, mais l'élément ou le qualificatif requis ne peut pas avoir de valeur par défaut. Une valeur SNGVAL ne peut pas être utilisée comme nouvelle valeur par défaut si la valeur par défaut existante n'est pas SNGVAL. Pour savoir si les éléments ou les qualificatifs d'un nom qualifié ont des valeurs par défaut, remplacez la valeur SNGVAL par une valeur admise pour le mot clé, effacez les autres éléments ou qualificatifs de la liste et appuyez sur la touche ENTREE. Si d'autres éléments ou qualificatifs de la liste ont des valeurs par défaut, ces valeurs apparaissent maintenant dans la zone d'entrée de l'élément ou du qualificatif de la liste.

Restriction: L'utilisateur doit posséder le droit de gestion de l'objet et le droit *USE pour la commande en cours de modification.

Paramètres

Commande (CMD)

Indique la commande à modifier. Cette commande peut être définie par l'utilisateur ou fournie par IBM.

Qualificatif 1 : Commande

nom

Indiquez le nom de la commande dont les valeurs par défaut de paramètres sont à 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 la bibliothèque qui contient la commande.

Nouv chaîne paramètre/défaut (NEWDFT)

Indique, entre apostrophes, la chaîne de caractères qui contient les nouvelles valeurs par défaut affectées à un paramètre, à un élément ou à un qualificatif, si aucune valeur n'a été indiquée par l'utilisateur lors du traitement de la commande. Seuls les paramètres, éléments ou qualificatifs possédant déjà une valeur par défaut peuvent recevoir une nouvelle valeur.

*N sert à occuper une position dans un nom qualifié ou dans une liste de valeurs, en remplacement d'éléments ou de qualificatifs qui n'ont pas de valeur par défaut. Si ces derniers possèdent une valeur par défaut, mais que celle-ci n'est pas remplacée, *N ou la valeur par défaut existante peut alors servir à occuper une position.

Remarque :Le contrôle de dépendance entre paramètres et le contrôle de validité sont effectués lors de l'exécution de la commande, et non pendant la modification de la valeur par défaut.

valeur-alphanumérique

Indiquez entre apostrophes la nouvelle chaîne de valeurs de paramètre par défaut.

Exemples

Les exemples suivants présentent les changements apportés aux valeurs par défaut des paramètres de commandes lors du traitement de la commande CHGCMDDFT.

Exemple 1 : modification de la valeur par défaut du paramètre AUT

CHGCMDDFT   CMD(CRTPF)  NEWDFT('AUT(*EXCLUDE)')

Cette commande permet de remplacer la valeur par défaut du paramètre AUT par *EXCLUDE pour la commande CRTPF.

Exemple 2 : Modification des valeurs par défaut de la commande CRTCLPGM

CHGCMDDFT   CMD(USRQSYS/CRTCLPGM)
            NEWDFT('PGM(LIB1/*N) SRCFILE(LIB1/FILE1) LOG(*YES)')

Cette commande modifie les valeurs par défaut de la commande (Créer un programme CL) lorsque le paramètre NEWDFT est indiqué sous la forme ci-dessus. Dans l'exemple, la valeur par défaut du paramètre LOG est *YES. Aucune valeur par défaut ne peut être indiquée pour le second qualificatif (nom-programme) du paramètre PGM car il n'en existe pas. *N est alors utilisé pour occuper une position dans ce qualificatif. La valeur par défaut du premier qualificatif (nom-bibliothèque) du paramètre PGM est LIB1. La valeur par défaut du premier qualificatif du paramètre SRCFILE (nom-bibliothèque) est LIB1. Celle du second qualificatif (nom-fichier-source) est FILE1.

Exemple 3 : modification de la valeur par défaut CRTPF du paramètre MAXMBRS

CHGCMDDFT   CMD(CRTPF)  NEWDFT('MAXMBRS(*NOMAX)')

Cette commande permet de remplacer la valeur par défaut du paramètre MAXMBRS par *NOMAX dans la commande CRTPF.

Messages d'erreur

Messages *ESCAPE

CPF6216

La commande &1 est incorrecte pour la commande &2.

CPF6260

Erreurs lors de la modification des valeurs par défaut.

CPF6261

Commande &1 de la bibliothèque &2 non modifiable.