DLTMNU

Supprimer un menu

En bref

La commande DLTMNU (Supprimer un menu) permet de supprimer du système le menu que vous avez désigné.

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

Syntaxe minimale

DLTMNU MENU(…)

Paramètres

MENU Menu obligatoire
DLTREFOBJ Supprimer objets référencés

Astuce : dans une session 5250, tapez DLTMNU 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 DLTMNU (Supprimer un menu) permet de supprimer du système le menu que vous avez désigné.

Remarque :Cette commande vous permet également de supprimer les fichiers écran et les fichiers de messages associés à un menu de type *DSPF, ou de supprimer le programme associé à un menu de type *PGM.

Restrictions :

Vous devez disposer des droits *OBJEXIST et *OBJOPR sur le menu et du droit *EXECUTE sur la bibliothèque dans laquelle se trouve le menu.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MENU	Menu	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Menu	Nom générique, nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALL, *ALLUSR
DLTREFOBJ	Supprimer objets référencés	Valeurs uniques: NONE, ALL Autres valeurs (jusqu'à 3 répétitions): DSPF, MSGF, *PGM	Facultatif

Menu (MENU)

Indique les menus à supprimer.

Ce paramètre est obligatoire.

Qualificatif 1 : Menu

nom-générique: Indiquez le nom générique correspondant aux menus à supprimer. Un nom générique est une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*). Tous les menus dont le nom commence par les caractères inclus dans la chaîne seront supprimés.
nom: Indiquez le nom du menu à supprimer.

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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

*USRLIBL: S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

'xxxxx' représente le numéro de l'ASP principal.
L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*ALL: La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Supprimer objets référencés (DLTREFOBJ)

Indique que le fichier écran, le fichier de messages ou les programmes auxquels le menu fait référence doivent être supprimés. Seuls les menus de type *DSPF peuvent faire référence à un fichier écran ou à un fichier de messages. Seuls les menus de type *PGM peuvent faire référence à un programme.

Remarque :La recherche des objets à supprimer ne s'effectue ni dans la bibliothèque en cours ni dans la bibliothèque de logiciel définie pour le menu.

Valeurs uniques

*NONE: Aucun des objets auxquels le menu fait référence ne sera supprimé.
*ALL: Tous les fichiers écran, les fichiers de messages et les objets programme auxquels le menu fait référence seront supprimés.

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

*DSPF: Le fichier écran auquel le menu fait référence sera supprimé.
*MSGF: Le fichier de messages auquel le menu fait référence sera supprimé.
*PGM: Le programme auquel le menu fait référence sera supprimé.

Exemples

Exemple 1 : Suppression du menu uniquement

DLTMNU   MENU(FINLIB/ARMENU)

Cette commande permet de supprimer le menu appelé ARMENU de la bibliothèque FINLIB.

Exemple 2 : Suppression du fichier d'écran et du fichier de messages

DLTMNU   MENU(EXLIB/TEST)  DLTREFOBJ(*DSPF *MSGF)

Cette commande permet de supprimer le menu appelé TEST de la bibliothèque EXLIB. Elle permet également de supprimer le fichier d'écran et le fichier de messages associés au menu TEST.

Messages d'erreur

Messages *ESCAPE

CPF2105: Objet &1 de &2 type *&3 non trouvé.
CPF2107: La bibliothèque n'est ni remise à blanc, ni supprimée. Opération interrompue.
CPF2110: Bibliothèque &1 non trouvée.
CPF2113: Impossible d'allouer la bibliothèque &1.
CPF2114: Impossible d'allouer objet &1 de &2 type *&3.
CPF2117: &4 objet(s) de type *&3 supprimé(s). &5 objet(s) non supprimé(s).
CPF2125: Aucun objet supprimé.
CPF2160: Objet de type *&1 incorrect pour la fonction demandée.
CPF2176: Bibliothèque &1 endommagée.
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2189: Utilisation de l'objet &1 de &2, type *&3 non autorisée.