DLTMSGF

Supprimer fichier message

En bref

La commande DLTMSGF (Supprimer un fichier message) permet de supprimer le fichier message indiqué ainsi que toutes les descriptions de message qu'il contient.

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

Syntaxe minimale

DLTMSGF MSGF(…)

Paramètres

MSGF Fichier de messages fichier message obligatoire

Astuce : dans une session 5250, tapez DLTMSGF 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 : Oui

La commande DLTMSGF (Supprimer un fichier message) permet de supprimer le fichier message indiqué ainsi que toutes les descriptions de message qu'il contient. Si des messages provenant de ce fichier se trouvent dans des files d'attente, aucun texte ne correspond plus à ces messages.

Restrictions : Pour supprimer le fichier message spécifié, vous devez disposer du droit d'existence sur l'objet correspondant à ce fichier (*OBJEXIST). Les fichiers message fournis par IBM, QCPFMSG (pour les messages IBM i) et les fichiers message de programme sous licence (QRPGMSG, par exemple) ne peuvent pas être supprimés (excepté si le responsable de la sécurité l'autorise).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MSGF	fichier message	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: fichier message	Nom générique, nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALL, *ALLUSR

fichier message (MSGF)

Indique une ou plusieurs files d'attente de messages à supprimer.

Ce paramètre est obligatoire.

Qualificatif 1 : fichier message

nom-fichier-messages: Indiquez le nom du fichier message que vous souhaitez supprimer.
Si le nom complet de l'objet est indiqué et si plusieurs bibliothèques sont explorées, il n'est possible de supprimer plusieurs objets que si *ALL ou *ALLUSR a été indiqué pour la bibliothèque.
nom-générique*-fichier-messages: Indiquez le nom générique du fichier message que vous souhaitez supprimer. Un nom générique est une chaîne d'un ou de plusieurs caractères suivie d'un astérisque (*), comme par exemple ABC*. L'astérisque peut se substituer à n'importe quel caractère admis. Un nom générique désigne tout objet dont le nom commence par le préfixe générique sur lequel l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom complet de l'objet. Lorsqu'un nom générique est indiqué, tous les fichiers message dont le nom comporte le même préfixe que celui du fichier indiqué sont supprimés. Si le nom complet de l'objet est indiqué et si plusieurs bibliothèques sont explorées, il n'est possible de supprimer plusieurs objets que si *ALL ou *ALLUSR a été indiqué pour la bibliothèque.

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 s'effectue dans la bibliothèque en cours du travail. Si la bibliothèque en cours ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

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

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

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

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

Exemples

DLTMSGF   MSGF(INV)

Cette commande supprime le fichier message appelé INV. Toutes les descriptions de messages stockées dans INV sont également supprimées.

Messages d'erreur

Messages *ESCAPE

CPF2105: Objet &1 de &2 type *&3 non trouvé.
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).
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2189: Utilisation de l'objet &1 de &2, type *&3 non autorisée.