CHGMNU

Modifier un menu

En bref

La commande CHGMNU (Modifier un menu) permet de modifier les éléments suivants :

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

Syntaxe minimale

CHGMNU MENU(…)

Paramètres

MENU Menu obligatoire
DSPF Fichier écran
MSGF Fichier de messages fichier message
CMDLIN Ligne de commande
DSPKEY Afficher touches de fonction
PGM Programme
CURLIB Bibliothèque en cours
PRDLIB Bibliothèque de logiciel
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGMNU 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 CHGMNU (Modifier un menu) permet de modifier les éléments suivants :

La bibliothèque en cours et la bibliothèque de logiciel associées à un menu
Le nom du fichier écran et la bibliothèque associés à un menu de type *DSPF
Le nom du fichier de messages et la bibliothèque associés à un menu de type *DSPF
La longueur de la ligne de commande à afficher sur un menu de type *DSPF : longue, courte ou inexistante (ligne d'option)
L'affichage optionnel d'une description des touches de fonction actives sur un menu de type *DSPF
Le nom du programme et la bibliothèque associés à un menu de type *PGM
Le texte descriptif d'un menu

Restrictions :

Vous devez disposer des droits *OBJOPR et *OBJMGT sur l'objet menu et du droit *USE sur la bibliothèque contenant l'objet menu.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MENU	Menu	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Menu	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
DSPF	Fichier écran	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Fichier écran	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MSGF	fichier message	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: fichier message	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
CMDLIN	Ligne de commande	SAME, LONG, SHORT, NONE	Facultatif
DSPKEY	Afficher touches de fonction	SAME, NO, *YES	Facultatif
PGM	Programme	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Programme	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
CURLIB	Bibliothèque en cours	Nom, SAME, NOCHG, MNULIB, CRTDFT	Facultatif
PRDLIB	Bibliothèque de logiciel	Nom, SAME, NOCHG, *NONE	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Menu (MENU)

Indique le menu à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Menu

nom: Indiquez le nom de l'objet menu.

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 menu 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: Désignez la bibliothèque dans laquelle figure le menu.

Fichier écran (DSPF)

Indiquez le fichier écran utilisé pour le menu. Le fichier écran doit contenir un format d'enregistrement portant son nom : il s'agit du format de menu. Des formats d'aide peuvent également être inclus dans le fichier.

Les formats d'aide suivent la convention d'appellation #Hxxyy, où xx représente la première option de menu et yy la dernière à laquelle le format d'aide s'applique. (Par exemple, #H0306 s'applique aux options de menu 3 à 6.) #H0000 désigne l'aide générale relative au menu.

Ce paramètre n'est applicable que si vous avez indiqué *DSPF pour le paramètre TYPE (Type de menu) lors de la création du menu (commande CRTMNU).

Valeurs uniques

*SAME: Le nom et la bibliothèque du fichier écran ne sont pas modifiés.

Qualificatif 1 : Fichier écran

nom: Indiquez le nom du fichier écran à 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 écran 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: Désignez la bibliothèque dans laquelle figure le fichier écran.

fichier message (MSGF)

Désigne le fichier de messages contenant les commandes à lancer lorsqu'une option de menu est sélectionnée. Le MSGID des messages de ce fichier sont au format USRxxxx, où xxxx représente le numéro de l'option de menu qui est entrée à la ligne de commande.

Ce paramètre n'est applicable que si vous avez indiqué *DSPF pour le paramètre TYPE (Type de menu) lors de la création du menu (commande CRTMNU).

Valeurs uniques

*SAME: Le nom et la bibliothèque du fichier de messages ne sont pas modifiés.

Qualificatif 1 : fichier message

nom: Indique le nom du fichier de messages à 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 de messages 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: Désignez la bibliothèque dans laquelle figure le fichier de messages.

Ligne de commande (CMDLIN)

Indique si la ligne de commande à afficher est longue, courte ou inexistante (ligne d'option).

Ce paramètre n'est applicable que si vous avez indiqué *DSPF pour le paramètre TYPE (Type de menu) lors de la création du menu (commande CRTMNU).

*SAME: La longueur de la ligne de commande ou d'option reste inchangée.
*LONG: La longueur de la ligne de commande sera de 153 octets.
*SHORT: La longueur de la ligne de commande sera de 73 octets.
*NONE: L'écran comportera une ligne d'option de 4 octets.

Afficher touches de fonction (DSPKEY)

Indique si le libellé des touches de fonction doit apparaître en bas du menu affiché.

Ce paramètre n'est applicable que si vous avez indiqué *DSPF pour le paramètre TYPE (Type de menu) lors de la création du menu (commande CRTMNU).

*SAME: L'affichage n'est pas modifié.
*NO: Le libellé des touches de fonction n'est pas affiché en bas de l'écran.
*YES: Le libellé des touches de fonction est affiché en bas de l'écran.

Programme (PGM)

Désigne le programme auquel le menu fait appel.

Ce paramètre n'est applicable que si vous avez indiqué *PGM pour le paramètre TYPE(Type de menu) lors de la création du menu (commande CRTMNU).

Valeurs uniques

*SAME: Le nom du programme et la bibliothèque ne sont pas modifiés.

Qualificatif 1 : Programme

nom: Indiquez le nom du programme à appeler.

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 celle-ci n'est pas précisée, QGPL est prise par défaut.
nom: Désignez le nom de la bibliothèque dans laquelle figure le programme.

Bibliothèque en cours (CURLIB)

Indique la bibliothèque à utiliser comme bibliothèque en cours lorsque le menu est lancé.

*SAME: La bibliothèque en cours associée au menu n'est pas modifiée.
*NOCHG: La bibliothèque en cours n'est pas modifiée pour le traitement de ce menu.
*MNULIB: La bibliothèque en cours devient la bibliothèque contenant le menu lors de son affichage.
*CRTDFT: Il n'y a pas de bibliothèque en cours lorsque le menu est affiché. La bibliothèque en cours qui était active avant l'affichage du menu (le cas échéant) est restaurée lorsque vous quittez le menu.
nom: Indiquez le nom de la bibliothèque à utiliser comme bibliothèque en cours lorsque le menu est affiché.

Bibliothèque de logiciel (PRDLIB)

Indique la bibliothèque à utiliser comme bibliothèque de logiciel lorsque le menu est lancé.

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 reprend à l'état qui lui était associé lors du démarrage de la commande ou de la bibliothèque.

*SAME: La bibliothèque de logiciel associée au menu n'est pas modifiée.
*NOCHG: La bibliothèque de logiciel n'est pas modifiée lors de l'affichage du menu ; elle conserve la même valeur lorsque vous quittez celui-ci.
*NONE: La bibliothèque de logiciel figurant dans la liste des bibliothèques n'est pas utilisée lorsque le menu est affiché.
nom: Indiquez le nom de la bibliothèque de logiciel à utiliser lorsque le menu est affiché.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte descriptif n'est pas modifié.
*BLANK: Aucun texte n'est indiqué pour le menu.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

CHGMNU   MENU(ARLIB/ARPERS)  PGM(ARLIB/PERSLIST)

Cette commande permet de modifier le programme appelé lors du lancement d'un menu appelé ARPERS et stocké dans la bibliothèque ARLIB. Le menu appelle désormais un programme appelé PERSLIST, également disponible dans la bibliothèque ARLIB.

Vous devez avoir créé le menu ARPERS en indiquant TYPE(*PGM) dans la commande CRTMNU du paramètre PGM à définir ici.

Messages d'erreur

Messages *ESCAPE

CPF6ACD: Menu &1 de &2 incompatible avec édition du système.
CPF6AC2: Le menu &1 de &2 n'a pas été modifié.