DLTMOD

Supprimer un module

En bref

La commande DLTMOD (Supprimer un module) permet de supprimer un module ou un groupe de modules compilés.

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

Syntaxe minimale

DLTMOD MODULE(…)

Paramètres

MODULE Module obligatoire

Astuce : dans une session 5250, tapez DLTMOD 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 DLTMOD (Supprimer un module) permet de supprimer un module ou un groupe de modules compilés. Si le module est associé à un répertoire de liage, le poste correspondant dans le répertoire n'est plus correct après la suppression.

Restrictions :

Vous devez disposer du droit d'existence sur l'objet (*OBJEXIST) module et du droit d'exécution (*EXECUTE) sur la bibliothèque dans laquelle il est stocké.

Paramètres

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

Module (MODULE)

Indique les modules à supprimer. Vous pouvez indiquer un nom de module spécifique ou générique ; l'un ou l'autre type peut être qualifié par un nom de bibliothèque.

Remarque :Pour enlever tous les objets modules pour une bibliothèque spécifique, vous pouvez utiliser RMVLNK OBJLNK('QSYS.LIB/libname.LIB/*.MODULE'), où libname correspond au nom de la bibliothèque dans laquelle tous les modules doivent être supprimés. Pour plus d'informations, consultez la commande RMVLNK.

Ce paramètre est obligatoire.

Qualificatif 1 : Module

nom-générique: Indiquez le nom générique des modules à supprimer. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) : ABC*, par exemple. Si un nom générique est indiqué, tous les modules dont le nom commence par ce nom générique, et sur lesquels l'utilisateur détient des droits, sont supprimés. Si le nom (ou le préfixe) générique n'inclut pas d'astérisque, le système suppose qu'il s'agit du nom complet du module.
nom: Indiquez le nom du module à 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 du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.
*USRLIBL: La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.

*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: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Exemples

DLTMOD   MODULE(XYZ/M*)

Cette commande supprime tous les modules de la bibliothèque XYZ qui commencent par la lettre M.

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).
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.
CPFA030: Objet déjà en cours d'utilisation.
CPFE007: Une erreur s'est produite lors du traitement de la commande. Error occurred processing command.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.