WRKLIB

La commande WRKLIB (Gérer les bibliothèques) permet d'afficher une liste de bibliothèques à partir de laquelle vous pouvez copier, supprimer, afficher, imprimer, sauvegarder, restaurer, modifier et mettre à blanc les bibliothèques indiquées.

Restrictions :

• Seules les bibliothèques sur lesquelles vous disposez d'un droit s'affichent sur l'écran
• Si vous disposez de droits sur la fonction d'administrateur de la sécurité de la base de données d'IBM i (QIBM_DB_SECADM), toutes les bibliothèques s'afficheront à l'écran.
• Pour exécuter des opérations sur les bibliothèques, vous devez disposer du droit d'utilisation (*USE) sur la commande utilisée par l'opération et du droit approprié sur la bibliothèque sur laquelle l'opération est à effectuer.

Paramètres

Bibliothèque (LIB)

Indique les bibliothèques à afficher à l'écran Gestion des bibliothèques.

*LIBL

Toutes les bibliothèques de la liste de l'unité d'exécution sont affichées.

Remarque :Une bibliothèque peut figurer plusieurs fois dans la liste affichée à l'écran Gestion des bibliothèques si elle est présente à la fois dans la partie système et la liste des bibliothèques utilisateur et qu'elle est également une des bibliothèques du logiciel ou la bibliothèque en cours de l'unité d'exécution.

*USRLIBL

Si la liste des bibliothèques de l'unité d'exécution en cours comporte une entrée pour la bibliothèque en cours, cette dernière est affichée, ainsi que les bibliothèques de la liste des bibliothèques utilisateur. S'il n'y a pas d'entrée pour la bibliothèque en cours, seules les bibliothèques de la liste des bibliothèques utilisateur sont affichées.

Remarque :Une bibliothèque peut figurer plusieurs fois dans la liste affichée à l'écran Gestion des bibliothèques si elle est présente dans la liste des bibliothèques utilisateur et qu'il s'agit également de la bibliothèque en cours de l'unité d'exécution.

*CURLIB

La bibliothèque en cours de l'unité d'exécution est affichée. S'il n'y en a pas, c'est la bibliothèque QGPL qui est affichée.

*ALL

Toutes les bibliothèques des pools de mémoire secondaire (ASP) spécifiées par le paramètre Numéro d'ASP (ASP) ou le paramètre Unité ASP (ASPDEV) sont affichées.

*ALLUSR

Toutes les bibliothèques utilisateur sont affichées. Toutes les bibliothèques dont le nom ne commence pas par la lettre Q sont affichées à part les exceptions 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 faisant souvent l'objet de modifications. C'est pourquoi elles sont considérées comme des bibliothèques utilisateur et sont par conséquent affiché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

1. 'xxxxx' représente le numéro de l'ASP principal.
2. 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-générique

Indique le nom générique des bibliothèques à afficher. 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 spécifié, toutes les bibliothèques ayant le même préfixe que le nom générique sont affichées.

nom

Indique le nom de la bibliothèque à afficher.

Numéro d'ASP (ASP)

Indique le pool de mémoire secondaire (ASP) des bibliothèques devant être affichées à l'écran Gestion des bibliothèques. Ce paramètre est ignoré si la valeur *LIBL, *CURLIB ou *USRLIBL est indiquée pour le paramètre de bibliothèque. Si un nombre est spécifié pour ce paramètre, la valeur du paramètre Unité ASP (ASPDEV) doit être *.

*ALL

Tous les pools de mémoire secondaire (ASP) définis par la valeur attribuée au paramètre Unité ASP (ASPDEV) sont inclus dans la recherche.

1-32

Indiquez le numéro correspondant à l'ASP système ou utilisateur de base sur lequel doit porter la recherche. ASP 1 désigne l'ASP système qui est toujours configuré. Les valeurs admises pour les ASP utilisateur de base sont comprises entre 2 et 32 et doivent désigner un ASP configuré sur le système. Pour des informations sur la configuration d'un ASP, consultez le manuel Reprise du système, SC41-5304.

Unité ASP (ASPDEV)

Indique le nom de l'unité ASP contenant la mémoire allouée à la bibliothèque affichée. Si la bibliothèque est située dans un ASP qui ne fait pas partie du nom d'espace de bibliothèque de l'unité d'exécution, ce paramètre doit être indiqué pour être sûr que la bibliothèque affichée est correcte. Si un nombre est spécifié pour le paramètre Numéro d'ASP (ASP), la valeur du paramètre ASPDEV doit être *.

*

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.

*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.

*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.

nom

Indiquez le nom d'unité de l'ASP principal ou auxiliaire sur lequel doit porter la recherche. L'ASP principal ou auxiliaire doit être activé (en mettant en fonction l'unité ASP) et être à l'état 'Disponible'. L'ASP système (ASP 1) et les ASP utilisateur de base configurés (ASP 2-32) ne sont pas concernés par cette recherche.

Exemples

WRKLIB   LIB(QJ*)  ASP(2)

Cette commande vous permet de gérer la liste des bibliothèques du pool de mémoire secondaire (ASP 2) commençant par les lettres 'QJ'.

Messages d'erreur

Messages *ESCAPE

CPF218C

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

CPF2302

Unité &1 non trouvée dans le groupe ASP &2.

CPF9809

Accès à la bibliothèque &1 impossible.

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.

CPFB8ED

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