CLRLIB

La commande CLRLIB (Mettre à blanc une bibliothèque) permet de supprimer d'une bibliothèque indiquée tous les objets que vous avez le droit de supprimer. Cette commande ne supprime pas la bibliothèque indiquée, mais uniquement les objets que celle-ci contient et sur lesquels vous disposez de droits d'existence (*OBJEXIST). Les autres objets restent dans la bibliothèque. 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é.

Restrictions :

1. Vous devez disposer de droits d'existence (*OBJEXIST) sur tous les objets à supprimer et de droits d'utilisation (*USE) sur la bibliothèque.
2. Cette commande ne peut pas être utilisée pour supprimer les bibliothèques système IBM. Le message CPD2103 est envoyé si une bibliothèque système IBM est spécifiée et que la commande CLRLIB n'est pas exécutée.
3. 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 dans laquelle supprimer tous les objets sur lesquels vous disposez de droits d'existence (*OBJEXIST). Seuls seront supprimés les objets sur lesquels vous disposez du droit d'existence. Si QGPL est indiquée ou utilisée par défaut via la valeur *CURLIB, un message d'interrogation (CPA2129) vous invite à confirmer la mise à blanc de la bibliothèque QGPL.

Ce paramètre est obligatoire.

*CURLIB

La bibliothèque en cours de l'unité d'exécution doit être mise à blanc. Si la liste de bibliothèques de l'unité d'exécution en cours ne contient aucune bibliothèque en cours, la bibliothèque QGPL est mise à blanc.

nom

Indiquez le nom de la bibliothèque à mettre à blanc.

Unité ASP (ASPDEV)

Indique l'unité ASP contenant la mémoire allouée à la bibliothèque à mettre à blanc. Si cette dernière 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 mise à blanc est correcte.

Remarque :Si ce paramètre est indiqué lorsque *CURLIB est précisé pour le paramètre Bibliothèque (LIB), la valeur 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. 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 d'utilisation (*USE) sur chaque ASP du groupe d'ASP.

Exemples

Exemple 1 : Mise à blanc d'une bibliothèque

CLRLIB   LIB(A)

Cette commande permet de supprimer tous les objets de la bibliothèque A qui ne sont pas en cours d'utilisation et sur lesquels vous disposez de droits d'existence (*OBJEXIST).

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

CLRLIB   LIB(INVENTORY) ASPDEV(SALES)

Cette commande permet de supprimer tous les objets de la bibliothèque INVENTORY du pool de mémoire secondaire (ASP) indépendant SALES, qui ne sont pas en cours d'utilisation et sur lesquels vous disposez de droits d'existence (*OBJEXIST). L'ASP SALES doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'.

Messages d'erreur

Messages *ESCAPE

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.

CPF216B

La bibliothèque &1 ne peut pas être mise à blanc.

CPF2161

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

CPF2173

Valeur pour ASPDEV incorrecte avec valeur spéciale pour bibliothèque.

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.