DLTOBJ

Supprimer l'objet

En bref

La commande DLTOBJ (Supprimer l'objet) permet de supprimer les objets du type indiqué dans le paramètre OBJTYPE (Type d'objet).

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

Syntaxe minimale

DLTOBJ OBJ(…) OBJTYPE(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
ASPDEV Unité ASP
RMVMSG Suppression du message

Astuce : dans une session 5250, tapez DLTOBJ 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 : Sous conditions

La commande DLTOBJ (Supprimer l'objet) permet de supprimer les objets du type indiqué dans le paramètre OBJTYPE (Type d'objet). Un grand nombre, mais pas la totalité, des objets externes basés bibliothèque qui se trouvent sur le système peuvent être supprimés via cette commande. Quelques-unes des commandes DLTxxx utilisées pour les types d'objet pris en charge permettent de spécifier un paramètre supplémentaire en plus du nom d'objet et du nom de bibliothèque. Par exemple, les commandes DLTF, DLTIMGCLG et DLTJRNRCV prennent en charge des paramètres supplémentaires permettant de supprimer les types d'objet *FILE, *IMGCLG et *JRNRCV. Pour ces types d'objet, cette commande ne vous permet de spécifier ces paramètres supplémentaires. Par conséquent, la commande DLTxxx doit être utilisée lorsque des paramètres spécifiques d'objet sont nécessaires pour la suppression de l'objet.

La commande DLTOBJ présente un certain nombre d'avantages par rapport aux autres commandes DLTxxx :

Plusieurs bibliothèques (type *LIB) peuvent être supprimées en indiquant un nom générique.
Tous les objets d'un type particulier peuvent être supprimés d'une bibliothèque spécifique en indiquant *ALL pour le nom d'objet.
Un objet peut être supprimé d'un ASP (pool de mémoire secondaire) ou d'un groupe d'ASP en indiquant un nom d'unité ASP ou une valeur spéciale pour le paramètre Unité ASP (SPEDEV).

Pour tout détail concernant les droits et les verrouillages sur les objets et les bibliothèques, reportez-vous à l'API QLIDLTO (Suppression d'objet) dans le manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/). L'API QLIDLTO est le CPP (programme de traitement de commande) pour cette commande.

Restrictions :

Toutes les restrictions applicables à la commande DLTxxx (Supprimer un objet) pour chaque type d'objet pris en charge sont également applicables à cette commande.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Objet	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALL, *ALLUSR
OBJTYPE	Type d'objet	ALRTBL, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, COSD, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DTAARA, DTADCT, DTAQ, EDTD, FCT, FILE, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IGCSRT, IGCTBL, IMGCLG, IPXD, JOBD, JOBQ, JRN, JRNRCV, LIB, LIND, LOCALE, MEDDFN, MENU, MGTCOL, MODD, MODULE, MSGF, MSGQ, NODGRP, NODL, NTBD, NWID, NWSCFG, NWSD, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PSFCFG, QMFORM, QMQRY, QRYDFN, SBSD, SCHIDX, SPADCT, SQLPKG, SQLUDT, SQLXSR, SRVPGM, SSND, TBL, TIMZON, USRIDX, USRQ, USRSPC, VLDL, *WSCST	Obligatoire, positionnel 2
ASPDEV	Unité ASP	Nom, , ALLAVL, CURASPGRP, SYSBAS	Facultatif
RMVMSG	Suppression du message	NO, YES	Facultatif

Objet (OBJ)

Permet d'indiquer les objets à supprimer ainsi que la ou les bibliothèques contenant ces objets.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

*ALL: Tous les objets du type indiqué seront supprimés de la / des bibliothèques spécifiées. Lorsque vous indiquez *ALL pour le nom d'objet, le nom de bibliothèque doit être un nom spécifique (ce nom ne peut pas prendre une valeur spéciale).
Remarque :Les noms de bibliothèque système tels que QSYS sont admis, mais soyez très prudent lorsque vous indiquez un nom de bibliothèque tout en indiquant *ALL pour le nom d'objet.
nom-générique: Un nom générique est une chaîne de caractères comportant un ou plusieurs caractères (préfixe) suivis d'un astérisque (*). Lorsque vous entrez un nom générique, tous les types d'objet indiqués et dont le nom inclut le même préfixe que le nom générique sont supprimés de la / des bibliothèques indiquées.
nom: Indiquez le nom de l'objet à supprimer.

Qualificatif 2 : Biblio

*LIBL: La recherche s'effectue dans 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. Si un nom d'objet spécifique (non générique) est indiqué, seul le premier objet trouvé avec ce nom est supprimé. Si l'invite Unité ASP (paramètre ASPDEV) est indiquée lorsque cette valeur est utilisée, ASPDEV(*) est la seule valeur admise.

*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. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*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. Si un nom d'objet spécifique (non générique) est indiqué, seul le premier objet trouvé avec ce nom est supprimé. Si le paramètre Unité ASP (ASPDEV) est spécifié lorsque cette valeur est utilisée, ASPDEV(*) est la seule valeur admise.

*ALL: La recherche porte sur toutes les bibliothèques de pools de mémoire secondaire (ASP) indiquées à l'invite Unité ASP (paramètre ASPDEV). Tous les objets correspondant au nom et au type d'objet spécifiés dans toutes les bibliothèques sont supprimés.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur des pools de mémoire secondaire (ASP) définies à l'invite Unité ASP (paramètre ASPDEV).

Les bibliothèques utilisateur sont des bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception de celles qui suivent :

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

Bien que les bibliothèques ci-après dont le nom commence par la lettre Q soient fournies par IBM, elles contiennent des données utilisateur fréquemment modifiées. En conséquence, elles sont également considérées comme des bibliothèques utilisateur :

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 la bibliothèque contenant le ou les objets.

Type d'objet (OBJTYPE)

Permet d'indiquer le type de l'objet à supprimer.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

type-objet: Indiquez le type de l'objet à supprimer.

Unité ASP (ASPDEV)

Indique le nom de l'unité de pool de mémoire secondaire (ASP) à laquelle le stockage de la bibliothèque contenant l'objet est attribué. Si la bibliothèque réside dans un ASP qui ne fait pas partie de l'espace de nom de bibliothèque de l'unité d'exécution en cours, ce paramètre doit être indiqué pour garantir que la recherche portera sur la bibliothèque appropriée. Si ce paramètre est utilisé lorsque le qualificatif de bibliothèque indiqué pour le paramètre Objet (OBJ) est *CURLIB, *LIBL ou *USRLIBL, ASPDEV(*) est la seule valeur admise.

*: La recherche de la bibliothèque s'effectue dans tous les ASP présents dans l'espace de nom de bibliothèque de l'unité d'exécution. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis(ASP 2 à 32) et, si l'unité d'exécution dispose d'un groupe d'ASP, des ASP principaux et secondaires du groupe d'ASP de l'unité d'exécution.

*ALLAVL: La recherche va porter sur tous les ASP disponibles. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis (ASP 2 à 32) et de tous les ASP principaux et secondaires disponibles (ASP 33 à 255 à l'état 'Disponible'). L'ASP principal recherche les groupes d'ASP par ordre alphabétique. L'ASP système et tous les ASP utilisateur de base définis sont recherchés après les groupes d'ASP. Les ASP et les bibliothèques sur lesquels l'utilisateur ne dispose pas de droits sont ignorés et aucun message d'erreur de droits n'est envoyé.

*CURASPGRP: Si l'unité d'exécution dispose d'un groupe ASP, la recherche portera sur les ASP primaire et secondaire du groupe ASP de l'unité pour trouver la bibliothèque. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32). Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.

*SYSBAS: La bibliothèque est recherchée dans l'ASP système (ASP 1) et dans tous les ASP utilisateur de base définis (ASP 2-32). Les ASP principaux et secondaires ne sont pas concernés par cette recherche, même si l'unité d'exécution possède un groupe d'ASP.

nom: Indiquez le nom de l'unité ASP primaire ou secondaire sur laquelle les recherches doivent porter. L'ASP principal ou secondaire doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32).

Remarque :Pour indiquer un nom d'ASP spécifique, vous devez disposer du droit d'utilisation (*USE) sur chaque ASP du groupe d'ASP.

Suppression du message (RMVMSG)

Permet d'indiquer s'il faut ou non supprimer les messages d'achèvement et d'information relatifs à la suppression d'objets de l'historique du travail. Ces messages ne sont supprimés que si la suppression des objets s'est correctement effectuée. Les messages de diagnostic et d'arrêt programme ne sont pas supprimés pour les objets qui n'ont pas pu être supprimés.

*NO: Les messages d'achèvement et d'information relatifs à la suppression d'objets de l'historique du travail ne doivent pas être supprimés.
*YES: Les messages d'achèvement et d'information relatifs à la suppression d'objets de l'historique du travail doivent être supprimés, sous réserve que la suppression des objets se soit correctement effectuée.

Exemples

Exemple 1 : Suppression de tous les espaces utilisateur dans une bibliothèque

DLTOBJ OBJ(MYLIB/*ALL) OBJTYPE(*USRSPC) ASPDEV(*) RMVMSG(*NO)

Cette commande permet de supprimer tous les espaces utilisateur de la bibliothèque MYLIB, sous réserve que l'utilisateur dispose des droits appropriés pour l'accès à ces espaces et à la bibliothèque.

Exemple 2 : Suppression de toutes les bibliothèques du système dont le nom correspond à un nom générique

DLTOBJ OBJ(QSYS/TESTLIBXY*) OBJTYPE(*LIB) ASPDEV(*ALLAVL)

Sous réserve que l'utilisateur dispose des droits appropriés, cette commande permet de supprimer toutes les bibliothèques dont le nom commence par TESTLIBXY, ceci sur tous les pools de mémoire secondaire disponibles.

Messages d'erreur

CPFA030: Objet déjà en cours d'utilisation.
CPFB8ED: La description d'unité &1 est incorrecte pour l'opération.
CPF210F: L'opération n'a pas abouti pour &1, &2, type *&3.
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).
CPF211A: Objet *ALL non admis pour la bibliothèque &1.
CPF2125: Aucun objet supprimé.
CPF2166: Le nom de bibliothèque &1 n'est pas valide. Library name &1 not valid.
CPF2173: Valeur pour ASPDEV incorrecte avec valeur spéciale pour bibliothèque.
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.
CPF21B7: Tous les objets de type *&3 n'ont pas été supprimés
CPF21B8: &4 *&3 objets du groupe d'ASP &6 supprimés ; &5 non supprimé.
CPF21B9: Aucun objet du groupe d'ASP &4 supprimé.
CPF218C: &1 n'est pas un ASP principal ou secondaire.
CPF24B4: Severe error while addressing parameter list.
CPF2605: Impossible d'allouer &1.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9814: Unité &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9825: Accès non autorisé à l'unité &1.
CPF9833: *CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.