DSPLIB

La commande DSPLIB permet d'afficher le contenu d'une ou de plusieurs bibliothèques, c'est-à-dire la liste des noms et attributs des objets de chaque bibliothèque. Pour tous les types d'objet, l'objet ne s'affiche dans la liste des objets que si vous disposez de certains droits autres que *EXCLUDE sur l'objet.

Cette commande permet également d'afficher la liste des bibliothèques pouvant être sélectionnées séparément afin d'en afficher les objets. L'écran indique le nom, le type, le nom de l'unité ASP et le texte descriptif de chaque bibliothèque. Vous ne pouvez afficher qu'une bibliothèque à la fois.

A partir de l'écran affichant les objets d'une bibliothèque, vous pouvez indiquer les options d'affichage d'attributs complets ou de maintenance pour demander l'affichage d'écrans contenant des informations plus détaillées sur les objets de la bibliothèque.

Restrictions :

1. Vous devez disposer du droit *READ pour chaque bibliothèque indiquée afin d'en afficher le contenu.
2. Pour tous les types d'objet, l'objet ne s'affiche dans la liste des objets que si vous disposez de certains droits autres que *EXCLUDE sur l'objet.

Remarques :

1. Pour une sortie imprimée, la zone de taille totale de la bibliothèque indique la taille des objets de la bibliothèque plus celle de l'objet bibliothèque (*LIBL). Un signe plus (+) apparaît en regard de cette valeur si les objets de la bibliothèque sont verrouillés, endommagés ou inaccessibles et leurs tailles n'ont pas été incluses dans la zone de taille totale. Ce signe indique que le total réel de tous les objets est supérieur à la valeur affichée. Les objets auxquels vous n'avez pas accès ne s'affichent pas dans la liste.
2. Si *ALL, *ALLUSR, *LIBL ou *USRLIBL est indiqué pour le paramètre Bibliothèque (LIB) et qu'une sortie est imprimée, le contenu des bibliothèques est imprimé. Si une de ces valeurs est indiquée et qu'une sortie est affichée, une liste de bibliothèques apparaît ; vous pouvez en sélectionner une afin de l'afficher.

Paramètres

Bibliothèque (LIB)

Indique une ou plusieurs bibliothèques à afficher ou à imprimer. Si vous ne disposez pas du droit de lecture (*READ) sur la bibliothèque indiquée, celle-ci ne s'affichera pas. Ce paramètre peut être indiqué sous la forme d'une valeur unique ou d'une liste d'un ou de plusieurs noms.

Valeurs uniques

*LIBL

Toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours s'affichent. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*USRLIBL

Si la liste de bibliothèques de l'unité d'exécution en cours contient une bibliothèque en cours, cette dernière et les bibliothèques de la partie utilisateur de la liste s'affichent. Si la liste ne contient aucune bibliothèque en cours, seules les bibliothèques de la partie utilisateur de la liste des bibliothèques s'affichent. Si le paramètre ASPDEV est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*CURLIB

La bibliothèque en cours de l'unité d'exécution en cours est affichée. Si aucune bibliothèque n'est définie comme étant la bibliothèque en cours, la bibliothèque QGPL est affichée. Si le paramètre ASPDEV est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*ALL

Toutes les bibliothèques des ASP indiqués par le paramètre ASPDEV s'affichent.

*ALLUSR

Toutes les bibliothèques utilisateur et toutes celles contenant des données utilisateur, dont le nom commence par Q, présentes dans les ASP définis par le paramètre ASPDEV sont affichées. Les bibliothèques utilisateur sont toutes celles dont le nom ne commence pas par Q, excepté dans le cas suivant :

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

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.

Autres valeurs

nom

Indique le nom d'une ou plusieurs bibliothèques dont les objets doivent être affichés. Vous pouvez indiquer 15 noms au maximum.

Unité ASP (ASPDEV)

Indique l'unité ASP contenant la mémoire allouée à la bibliothèque à afficher. 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 ce paramètre est utilisé lorsque *CURLIB, *LIBL ou *USRLIBL 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. 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'exécution (*EXECUTE) sur l'ASP.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*

La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Exemples

Exemple 1 : Affichage d'une bibliothèque

DSPLIB   LIB(QGPL)

Le nom, le type et la description de base de tous les objets de la bibliothèque QGPL s'affichent sur le poste de travail à partir duquel la commande a été soumise ou s'impriment sur l'imprimante système si la commande a été exécutée dans un travail par lots.

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

DSPLIB   LIB(INVENTORY) ASPDEV(SALES)

Cette commande permet d'afficher le nom, le type et la description de base de tous les objets de la bibliothèque INVENTORY dans le pool de mémoire secondaire (ASP) indépendant SALES. 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.

CPF210E

Bibliothèque &1 non disponible pour le code raison &2.

CPF2110

Bibliothèque &1 non trouvée.

CPF2113

Impossible d'allouer la bibliothèque &1.

CPF2148

La bibliothèque marquée *SUPPRIMEE n'a pas été trouvée.

CPF2150

Erreur dans la fonction d'informations sur objet.

CPF2176

Bibliothèque &1 endommagée.

CPF2179

Affichage de la bibliothèque impossible.

CPF218C

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

CPF2182

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

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.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.