DLTLIB

La commande DLTLIB (Supprimer une bibliothèque) permet de supprimer une bibliothèque du système après avoir supprimé tous ses objets. Si la bibliothèque contient des objets, ceux-ci sont d'abord supprimés, puis la bibliothèque elle-même.

Si vous ne possédez pas les droits pour pouvoir supprimer tous les objets de la bibliothèque, uniquement ceux pour lesquels vous disposez des droits sont supprimés. La bibliothèque, ainsi que les autres objets, sont conservés. Si un objet de la bibliothèque est en cours d'utilisation (verrouillé par une autre unité d'exécution ou un autre travail) l'objet ne peut pas être supprimé.

Lorsqu'une bibliothèque a été endommagée, vous ne devez pas la supprimer avant d'avoir tenté de remédier aux dommages. Dans la plupart des cas, il suffit de commencer une séquence d'IPL (procédure de chargement initial) afin de reconstruire une bibliothèque utilisateur (y compris la bibliothèque QGPL). Puis, si la bibliothèque est toujours endommagée, elle doit être supprimée. Vous pouvez ensuite restaurer une version sauvegardée de cette bibliothèque ou la recréer.

Si la bibliothèque en cours de suppression est journalisée, un poste est consigné dans le journal qui enregistre les modifications.

Utilisez la commande DSPLIBD (Afficher la description de la bibliothèque) pour afficher les informations journalisées sur la bibliothèque. Pour plus d'informations sur le lancement de la journalisation d'une bibliothèque, reportez-vous à la commande (STRJRNLIB) .

Remarque :Pour en savoir plus sur la journalisation, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

1. Pour supprimer une bibliothèque, vous devez disposer des droits d'utilisation (*USE) et d'existence (*OBJEXIST) sur l'objet pour la bibliothèque spécifiée, ainsi que du droit *OBJEXIST pour tous les objets qu'elle contient. Si vous ne disposez pas de ce droit sur la bibliothèque, aucun élément n'est supprimé. S'il ne dispose pas de ce droit sur un ou plusieurs objets, ceux-ci ainsi que la bibliothèque ne sont pas supprimés.
2. Il est impossible de supprimer une bibliothèque figurant dans la liste des bibliothèques de l'unité d'exécution en cours.
3. Il est impossible de supprimer une bibliothèque figurant dans la liste des bibliothèques d'une unité d'exécution principale active sur le système lorsque la valeur du système QLIBLCKLVL est définie dans le but de verrouiller les bibliothèques de la liste.
4. Cette commande ne peut pas être utilisée pour supprimer des bibliothèques système IBM. Le message CPD2165 est envoyé si une bibliothèque système IBM est spécifiée et que la commande DLTLIB n'est pas exécutée.
5. Si la bibliothèque QDOC est supprimée, elle est recréée lors de l'IPL suivant.
6. Cette commande est à unités d'exécution protégées sous certaines conditions. La restriction suivante s'applique :
   • Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution multiples pour les fichiers répartis. Elle échoue dans le cas de fichiers répartis utilisant une base de données relationnelle de type *SNA.

Paramètres

Bibliothèque (LIB)

Indique la bibliothèque à supprimer.

Ce paramètre est obligatoire.

nom

Indiquez le nom de la bibliothèque à supprimer.

Unité ASP (ASPDEV)

Indique l'unité ASP contenant la mémoire allouée à la bibliothèque à supprimer. Si la bibliothèque ne fait pas partie de l'espace de nom de la bibliothèque de l'unité d'exécution, ce paramètre doit être indiqué pour être sûr que la bibliothèque concernée par la suppression est correcte.

*

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. Sont inclus l'ASP système (ASP 1), tous les ASP utilisateur de base définis (ASP 2-32) et, si l'unité d'exécution possède un groupe d'ASP, tous les ASP principaux et secondaires de ce groupe d'ASP.

*CURASPGRP

Si l'unité d'exécution possède un groupe d'ASP, la bibliothèque est recherchée dans les ASP principaux et secondaires de ce groupe. 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).

*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'ASP principal ou secondaire dans lequel rechercher la bibliothèque. 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 *USE sur chaque ASP du groupe d'ASP.

Exemples

Exemple 1 : Suppression d'une bibliothèque

DLTLIB   LIB(W)

Cette commande permet de supprimer la bibliothèque W une fois que tous ses objets ont été supprimés. Si la bibliothèque W contient des objets et que vous avez le droit de supprimer tous ces objets, la bibliothèque W et tous les objets sont supprimés. Si vous n'avez pas le droit de supprimer tous les objets, seuls ceux sur lesquels vous disposez des droits sont supprimés. La bibliothèque n'est pas supprimée.

Exemple 2 : Suppression d'une bibliothèque d'un pool de mémoire secondaire (ASP) indépendant

DLTLIB   LIB(INVENTORY) ASPDEV(SALES)

Cette commande permet de supprimer la bibliothèque INVENTORY du pool de mémoire secondaire indépendant (ASP) SALES, une fois que tous ses objets ont été supprimés. L'ASP SALES doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'. Si la bibliothèque INVENTORY contient des objets et que vous avez le droit de supprimer tous ces objets, la bibliothèque INVENTORY et tous les objets sont supprimés. Si vous n'avez pas le droit de supprimer tous les objets, seuls ceux sur lesquels vous disposez des droits sont supprimés. La bibliothèque n'est pas supprimée.

Messages d'erreur

Messages *ESCAPE

CPFA030

Objet déjà en cours d'utilisation.

CPFB8ED

La description d'unité &1 est incorrecte pour l'opération.

CPF210D

Bibliothèque &1 en cours d'utilisation.

CPF2110

Bibliothèque &1 non trouvée.

CPF2113

Impossible d'allouer la bibliothèque &1.

CPF2129

Mise à blanc ou suppression de la bibliothèque système &1 annulée.

CPF2161

Suppression impossible pour certains objets de la bibliothèque &1.

CPF2166

Le nom de bibliothèque &1 n'est pas valide. Library name &1 not valid.

CPF2167

&1 figure dans liste des bibliothèques et ne peut être supprimée.

CPF2168

Bibliothèque &1 non supprimée.

CPF218C

&1 n'est pas un ASP principal ou secondaire.

CPF2182

Non autorisé à utiliser la bibliothèque &1.

CPF8122

Dommage &8 sur bibliothèque &4.

CPF9814

Unité &1 non trouvée.

CPF9825

Accès non autorisé à l'unité &1.

CPF9833

*CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.