DSPOBJD

La commande DSPOBJD (Afficher une description d'objet) permet d'afficher les noms et attributs des objets mentionnés dans la bibliothèque indiquée, ou dans les bibliothèques de la liste des bibliothèques de l'unité d'exécution. Cette commande permet également d'afficher les noms et attributs des bibliothèques elles-mêmes.

Seuls les attributs d'objet de chaque objet sont affichés. Les attributs des données de l'objet et les données elles-mêmes ne le sont pas. La commande indique également si un objet affiché est endommagé (probablement en raison d'un incident système) ou qu'il n'est pas accessible car il est verrouillé.

Tout objet sur lequel vous disposez de droits autres que *EXCLUDE peut être affiché à l'aide de cette commande. Les bibliothèques sur lesquelles vous ne disposez pas du droit *EXECUTE ne sont pas affichées, même si elles ont été indiquées dans la commande. Si un seul objet doit être affiché, vous pouvez préciser son nom, son type, ainsi que le nom de la bibliothèque et l'unité ASP dans lesquelles la bibliothèque se trouve. En fonction du qualificatif de bibliothèque indiqué, soit le premier objet détecté dans les bibliothèques voulues est affiché, soit tous les objets détectés dans les bibliothèques sur lesquels vous disposez de certains droits sont affichés.

La fonction de table QSYS2.OBJECT_STATISTICS renvoie des informations similaires.

Remarques :

• Pour les objets endommagés ou verrouillés, les informations affichées, imprimées ou écrites dans le fichier en sortie sont incomplètes. Si la description de l'objet est affichée ou imprimée, le texte associé à l'objet indique s'il est verrouillé ou endommagé. Si la description de l'objet est enregistrée dans un fichier en sortie, il est indiqué que l'objet est verrouillé ou endommagé.
• La taille de l'objet bibliothèque affiché n'inclut pas la taille des objets contenus dans la bibliothèque. Pour obtenir la taille de la bibliothèque, en incluant la taille des objets qu'elle contient, utilisez la commande DSPLIB (Afficher une bibliothèque) avec le paramètre OUTPUT(*PRINT) ou l'API QLIRLIBD (Extraire une description de bibliothèque).

Restrictions :

1. Vous devez disposer du droit d'exécution (*EXECUTE) sur les bibliothèques indiquées. Si vous ne disposez pas du droit *EXECUTE sur la bibliothèque, aucun de ses objets ne s'affiche.
2. Vous devez disposer de droits autre que *EXCLUDE pour un objet à afficher à moins qu'une valeur *NAME ne soit indiquée pour le paramètre Détail (DETAIL). Lorsque la valeur *NAME est spécifiée, les objets pour lesquels vous ne disposez d'aucun droit ne sont pas renvoyés sauf si vous disposez de droits sur la fonction QIBM_LIST_ALL_OBJS. Les objets de profil utilisateur pour lesquels vous ne disposez d'aucun droit ne sont pas renvoyés même si vous disposez de droits sur la fonction QIBM_LIST_ALL_OBJS.
3. Vous devez disposer du droit spécial *ALLOBJ ou *AUDIT pour afficher une valeur autre que *NOTAVL pour la zone d'audit d'objet.

Paramètres

Objet (OBJ)

Le nom des objets de la bibliothèque ou le nom des bibliothèques dont les attributs d'objet doivent être affichés. Si une bibliothèque (qualificatif 2) n'est pas indiquée, *LIBL est utilisée par défaut et les objets sont recherchés dans toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours.

Les objets d'une bibliothèque ne s'affichent que si vous disposez de certains droits autres que *EXCLUDE pour ces objets à moins qu'une valeur *NAME ne soit indiquée pour le paramètre Détail (DETAIL).

Remarque :Lorsque la valeur *NAME est spécifiée, les objets pour lesquels vous ne disposez d'aucun droit ne sont pas renvoyés sauf si vous disposez de droits sur la fonction QIBM_LIST_ALL_OBJS. Les objets de profil utilisateur pour lesquels vous ne disposez d'aucun droit ne sont pas renvoyés même si vous disposez de droits sur la fonction QIBM_LIST_ALL_OBJS.

Ce paramètre peut être indiqué sous la forme d'une valeur particulière ou d'une liste d'un ou deux qualificatifs.

Ce paramètre est obligatoire.

Valeurs uniques

*ALLUSR

Lorsque le nom d'objet a pour valeur *ALLUSR, le type d'objet doit être *LIB. Toutes les bibliothèques utilisateur des ASP indiqués pour le paramètre Unité ASP (ASPDEV) s'affichent. Reportez-vous à *ALLUSR dans la description de la bibliothèque (qualificatif 2) pour obtenir une définition des bibliothèques utilisateur.

*IBM

Lorsque le nom d'objet a pour valeur *IBM, le type d'objet doit être *LIB. Sont affichées toutes les bibliothèques des ASP définis par le paramètre Unité ASP (ASPDEV) qui sont sauvegardées et restaurées à l'aide des commandes CL SAVLIB et RSTLIB, la valeur *IBM étant indiquée pour le paramètre Bibliothèque (LIB).

Qualificatif 1 : Objet

*ALL

Tous les objets des bibliothèques identifiées dans la bibliothèque (qualificatif 2) des types indiqués pour le paramètre Type d'objet (OBJTYPE) pour lesquels vous disposez de droits s'affichent.

1. Si la bibliothèque (qualificatif 2) a pour valeur *ALL, *ALLUSR ou un nom de bibliothèque, tous les objets ayant l'un des types indiqués et appartenant aux bibliothèques précisées sont affichés.
2. Si la bibliothèque (qualificatif 2) a pour valeur *USRLIBL ou *LIBL et que le nom d'objet correspond à un nom spécifique (autre que *ALL et non un nom générique), un seul type d'objet (autre que *ALL) peut être précisé pour le paramètre OBJTYPE. Seul le premier objet détecté est affiché.

nom-générique

Indiquez le nom générique des objets à afficher. Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Tous les objets possédant les caractères spécifiques au début de leur nom et auxquels vous être autorisé s'affichent.

nom

Indiquez le nom de l'objet à afficher.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée. Si l'invite Unité ASP (paramètre ASPDEV) est indiquée lorsque cette valeur est utilisée, ASPDEV(*) est la seule valeur admise.

*CURLIB

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

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*ALL

La recherche porte sur toutes les bibliothèques de pools de mémoire secondaire (ASP) indiquées à l'invite Unité ASP (paramètre ASPDEV).

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur des pools de mémoire secondaire (ASP) définies à l'invite Unité ASP (paramètre ASPDEV).

Les bibliothèques utilisateur sont des bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception de celles qui suivent :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques ci-après dont le nom commence par la lettre Q soient fournies par IBM, elles contiennent des données utilisateur fréquemment modifiées. En conséquence, elles sont également considérées comme des bibliothèques utilisateur :

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

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Type d'objet (OBJTYPE)

Types d'objet qui sont affichés. Ce paramètre peut être indiqué sous la forme d'une valeur particulière ou d'une liste d'un ou plusieurs types d'objet.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

Valeurs uniques

*ALL

Tous les types d'objet portant le nom d'objet indiqué s'affichent.

Autres valeurs

type-objet

Indiquez une ou plusieurs valeurs pour les types d'objet affichés. Les attributs de tous les objets des bibliothèques indiquées et des bibliothèques elles-mêmes, correspondant aux types d'objet indiqués, sont affichés. Si le qualificatif de bibliothèque du paramètre Objet (OBJ) est *USRLIBL ou *LIBL et que le qualificatif de nom d'objet est un nom spécifique (autre que *ALL et non un nom générique), un seul type d'objet (autre que *ALL) peut être indiqué pour cette option.

Détail (DETAIL)

Les ensembles d'attributs à afficher pour chaque objet.

Remarque :Lorsque la sortie est dirigée vers un fichier de base de données et qu'une valeur *BASIC, *FULL ou *SERVICE est indiquée, toutes les informations relatives aux attributs d'objet sont écrites dans le fichier.

*BASIC

L'affichage ou la sortie imprimée comprend le nom et la série de base des attributs de chaque objet.

*FULL

L'affichage ou la sortie imprimée contient le nom et la série complète des attributs de chaque objet (y compris la série de base des attributs).

*SERVICE

L'affichage ou la sortie imprimée comprend les attributs d'objet relatifs à la maintenance.

*NAME

Cette valeur n'est autorisée que lorsque la sortie est dirigée vers un fichier de base de données. Le nom, le type et le pool de mémoire secondaire (ASP) sont renvoyés pour chaque objet. Pour les objets endommagés ou verrouillés, les zones correspondante dans le fichier de sortie ne sont pas définies.

*TEXTATR

Cette valeur n'est autorisée que lorsque la sortie est dirigée vers un fichier de base de données. Le nom, le type, le pool de mémoire secondaire (ASP), la description de texte et l'attribut d'objet sont renvoyés pour chaque objet.

Unité ASP (ASPDEV)

Indique le nom de l'unité de pool de mémoire secondaire (ASP) à laquelle le stockage de la bibliothèque contenant l'objet est attribué. Si la bibliothèque réside dans un ASP qui ne fait pas partie de l'espace de nom de bibliothèque de l'unité d'exécution en cours, ce paramètre doit être indiqué pour garantir que la recherche portera sur la bibliothèque appropriée. Si ce paramètre est utilisé lorsque le qualificatif de bibliothèque indiqué pour le paramètre Objet (OBJ) est *CURLIB, *LIBL ou *USRLIBL, ASPDEV(*) est la seule valeur admise. Ce paramètre peut être indiqué sous forme de valeur unique ou d'une liste d'un ou de deux éléments.

Valeurs uniques

*

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.

Elément 1 : Unité

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'unité ASP spécifique lorsque le type de recherche spécifié pour l'élément 2 est *ASP, vous devez disposer du droit *EXECUTE sur cette unité ASP spécifique.

Pour indiquer un nom d'unité ASP spécifique lorsque le type de recherche spécifié pour l'élément 2 est *ASPGRP, vous devez disposer du droit *EXECUTE sur chaque unité ASP du groupe d'ASP.

Elément 2 : Type de recherche

Permet d'indiquer si la recherche doit porter sur l'unité ASP uniquement ou l'ensemble du groupe d'ASP indiqué dans l'élément 1.

*ASP

La recherche portera seulement sur l'unité de pool de mémoire secondaire (ASP) unique baptisée dans l'élément 1.

*ASPGRP

La recherche portera sur l'ensemble du groupe de l'unité de pool de mémoire secondaire (ASP) baptisée dans l'élément 1.

Sortie (OUTPUT)

Indique la destination de la sortie générée par la commande.

*

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.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données destiné à recevoir le résultat. Si le fichier base de données n'existe pas, cette commande en crée un dans la bibliothèque indiquée.

Remarque :Si un nouveau fichier est créé, le descriptif correspondant est "Sortie de DSPOBJD" et les droits publics sont identiques aux droits pour objets créés de la bibliothèque dans laquelle le fichier a été créé. Affichez ce droit par défaut à l'aide de la commande DSPLIBD (Afficher description de bibliothèque). Le format base de données (QLIDOBJD) du fichier en sortie est celui du fichier base de données QADSPOBJ fourni par IBM.

Qualificatif 1 : Fichier recevant la sortie

nom

Indiquez le fichier base de données destiné à recevoir le résultat.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle rechercher le fichier.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

Exemple 1 : Affichage d'une description de base des objets

DSPOBJD   OBJ(X/PAY)  OBJTYPE(*ALL)

Une description de base de tous les objets sur lesquels vous disposez de certains droits (à l'exception du droit d'exclusion (*EXCLUDE)) et qui sont désignés par PAY dans la bibliothèque X s'affiche. Les objets de la bibliothèque sur lesquels vous ne disposez pas de droits ne sont pas affichés.

Exemple 2 : Affichage d'une description complète d'un programme

DSPOBJD   OBJ(X/PAY)  OBJTYPE(*PGM)  DETAIL(*FULL)

Une description complète du programme PAY de la bibliothèque X est affichée. L'écran contient tous les attributs du programme.

Exemple 3 : Affichage des informations relatives à un programme

DSPOBJD   OBJ(*USRLIBL/PAY)  OBJTYPE(*PGM)

Cette commande permet d'afficher des informations relatives au premier programme appelé PAY qui est trouvé dans la partie utilisateur de la liste des bibliothèques pour l'unité d'exécution en cours.

Exemple 4 : Affichage d'une description de base des fichiers

DSPOBJD   OBJ(Z/ABC*)  OBJTYPE(*FILE)

Une description de base de tous les fichiers dont le nom commence par ABC (nom générique) et situés dans la bibliothèque Z sur laquelle vous disposez de certains droits (à l'exception du droit *EXCLUDE) s'affiche.

Exemple 5: Affichage des noms et types d'objet dans une bibliothèque

DSPOBJD   OBJ(Z/*ALL)  OBJTYPE(*ALL) DETAIL(*NAME)
          OUTPUT(*OUTFILE) OUTFILE(QGPL/OUTF1)

Les informations relatives au nom, au type et au pool de mémoire secondaire (ASP) sont renvoyées pour tous les objets situés dans la bibliothèque Z sur laquelle vous disposez de certains droits (à l'exception du droit *EXCLUDE). La sortie est dirigée vers le fichier base de données OUTF1 dans la bibliothèque QGPL.

Messages d'erreur

Messages *ESCAPE

CPFB8ED

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

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.

CPF2115

Objet &1 de &2 type *&3 endommagé.

CPF2121

Accès impossible pour une ou plusieurs bibliothèques.

CPF2123

Aucun objet du nom ou du type indiqué dans la bibliothèque &2.

CPF2124

Aucun objet indiqué affichable dans bibliothèque &2.

CPF2150

Erreur dans la fonction d'informations sur objet.

CPF2176

Bibliothèque &1 endommagée.

CPF2177

Valeur OBJTYPE incompatible avec valeur OBJ.

CPF218C

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

CPF218D

&1 n'est pas un ASP principal alors que *ASPGRP est indiqué.

CPF2182

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

CPF2189

Utilisation de l'objet &1 de &2, type *&3 non autorisée.

CPF326B

Fichier &1 de la bibliothèque &2 endommagé.

CPF9809

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

CPF9814

Unité &1 non trouvée.

CPF9825

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

CPF9827

L'objet &1 ne peut pas être créé ou déplacé dans la bibliothèque &2.

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.

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.

CPF9860

Erreur lors du traitement du fichier de sortie.

CPF9899

Erreur lors du traitement de la commande.