DLTCLS

Supprimer une classe

En bref

La commande DLTCLS (Supprimer une classe) permet à l'utilisateur de supprimer un objet de classe ou un groupe d'objets de classe du système.

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

Syntaxe minimale

DLTCLS CLS(…)

Paramètres

CLS Classe obligatoire

Astuce : dans une session 5250, tapez DLTCLS 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 DLTCLS (Supprimer une classe) permet à l'utilisateur de supprimer un objet de classe ou un groupe d'objets de classe du système. La suppression n'affecte pas les phases d'activation en cours d'exécution utilisant cette classe. Par contre, toute nouvelle phase d'activation ne peut être démarrée. Lorsqu'un poste de routage existant fait référence à la classe supprimée, ce poste doit être modifié (de manière à faire référence à une autre classe) ou bien une classe de même nom devra être créée. Si la classe supprimée est indiquée dans un poste de routage de sous-système, le lancement d'un travail utilisant ce poste de routage par le sous-système est impossible.

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit d'existence sur l'objet (*OBJEXIST) pour cette classe et du droit d'exécution (*EXECUTE) sur la bibliothèque.

Paramètres

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

Classe (CLS)

Indique le nom et la bibliothèque de la classe à supprimer. Vous pouvez indiquer un nom de classe spécifique ou générique, ou bien qualifier le type à l'aide d'un nom de bibliothèque.

Ce paramètre est obligatoire.

Qualificatif 1 : Classe

nom-générique: Indiquez le nom générique de la classe à supprimer. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est indiqué, toutes les classes dont le préfixe est identique à celui de la classe générique sont supprimées.
nom: Indiquez le nom de la classe.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée. Si un nom d'objet spécifique est indiqué (à la place d'un nom générique), seul le premier objet trouvé portant ce nom est supprimé.
*CURLIB: La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.
*USRLIBL: La recherche s'effectue uniquement dans les bibliothèques utilisateur de la liste des bibliothèques. Si un nom d'objet spécifique est indiqué (à la place d'un nom générique), seul le premier objet trouvé portant ce nom est supprimé.
*ALL: Toutes les bibliothèques des pools de mémoire secondaire (ASP) qui font actuellement partie de l'espace de nom de bibliothèque de l'unité d'exécution sont recherchées. Les ASP concernés sont l'ASP système (ASP 1), tous les ASP utilisateur de base définis (ASP 2 à 32) et, si l'unité d'exécution est dotée d'un groupe ASP, tous les ASP principaux et secondaires du groupe d'ASP. Seule votre bibliothèque QTEMP fait l'objet d'une recherche. Tous les objets correspondant au nom et au type d'objet spécifiés dans toutes les bibliothèques de l'espace de nom de l'unité d'exécution sont supprimés.

*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 où se trouve la classe.

Exemples

DLTCLS  CLS(CLASS1)

Cette commande permet de supprimer la classe CLASS1 du système.

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).
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.
CPF5702: Ce fichier n'est pas un fichier DDM ou est introuvable.