| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Object Description (DSPOBJD) command shows the names and attributes of specified objects in the specified library or in the libraries of the library list for the current thread. The command can also show the names and attributes of libraries themselves.
Only the object attributes of each object are shown; the data attributes of data in the object, and the actual data in the object, are not shown. Also indicated is whether an object being shown has been damaged (possibly by a system failure) or is not able to be accessed because it is locked.
Any object for which you have some authority other than *EXCLUDE authority can be shown by this command. Libraries for which you do not have execute (*EXECUTE) authority cannot be shown, even if specified in the command. If only one object is to be shown, you can specify it by entering the object name, object type, the name of the library where it is located, and the auxiliary storage pool (ASP) device where the library is located. Depending on the specified library qualifier, either the first object found in the specified libraries is shown, or all objects in the specified libraries for which you have some authority are shown.
Notes:
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| OBJ | Object | Single values: *ALLUSR, *IBM Other values: Qualified object name |
Required, Positional 1 |
| Qualifier 1: Object | Generic name, name, *ALL | ||
| Qualifier 2: Library | Name, *LIBL, *USRLIBL, *CURLIB, *ALL, *ALLUSR | ||
| OBJTYPE | Object type | Single values: *ALL Other values (up to 92 repetitions): *ALRTBL, *AUTL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DOC, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODGRP, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST |
Required, Positional 2 |
| DETAIL | Detail | *BASIC, *FULL, *SERVICE | Optional, Positional 3 |
| ASPDEV | ASP device | Single values: *, *ALLAVL, *CURASPGRP, *SYSBAS Other values: Element list |
Optional |
| Element 1: Device | Name | ||
| Element 2: Search type | *ASP, *ASPGRP | ||
| OUTPUT | Output | *, *PRINT, *OUTFILE | Optional |
| OUTFILE | File to receive output | Qualified object name | Optional |
| Qualifier 1: File to receive output | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTMBR | Output member options | Element list | Optional |
| Element 1: Member to receive output | Name, *FIRST | ||
| Element 2: Replace or add records | *REPLACE, *ADD |
| Top |
Specifies which objects in the library or libraries are to have their object attributes shown. If library (qualifier 2) is not specified, *LIBL is assumed, and all libraries in the library list for the current thread are searched for the objects. Objects in a library for which you do not have some authority are not shown. This parameter can be specified as a single value or as a list of one or two qualifiers.
This is a required parameter.
Single values
Qualifier 1: Object
Qualifier 2: Library
User libraries are all libraries with names that do not begin with the letter Q except for the following:
#CGULIB #DSULIB #SEULIB #COBLIB #RPGLIB #DFULIB #SDALIB
Although the following libraries with names that begin with the letter Q are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are also considered user libraries:
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx QGPL QSRVAGT QUSRINFSKR QGPL38 QSYS2 QUSRNOTES QMGTC QSYS2xxxxx QUSROND QMGTC2 QS36F QUSRPOSGS QMPGDATA QUSER38 QUSRPOSSA QMQMDATA QUSRADSM QUSRPYMSVR QMQMPROC QUSRBRM QUSRRDARS QPFRDATA QUSRDIRCL QUSRSYS QRCL QUSRDIRDB QUSRVI
| Top |
Specifies which types of objects are shown. This parameter can be specified as a single value or as a list of one or more object types.
To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
This is a required parameter.
Single values
Other values
| Top |
Specifies which set of attributes is shown for each object.
Note: When the output is directed to a database file, this parameter is ignored and all object attribute information is written to the file.
| Top |
Specifies the auxiliary storage pool (ASP) device name where storage is allocated for the library containing the object. If the library resides in an ASP that is not part of the thread's library name space, this parameter must be specified to ensure the correct library is searched. If this parameter is used when the library qualifier specified for the Object (OBJ) parameter is *CURLIB, *LIBL, or *USRLIBL, ASPDEV(*) is the only valid value. This parameter can be specified as a single value or a list of one or two elements.
Single values
Element 1: Device
Specify the name of the primary or secondary ASP device to be searched. The primary or secondary ASP must have been activated (by varying on the ASP device) and have a status of 'Available'. The system ASP (ASP 1) and defined basic user ASPs (ASPs 2-32) will not be searched.
Note: To specify a specific auxiliary storage pool (ASP) device name when the search type specified for element 2 is *ASP, you must have execute (*EXECUTE) authority for the specific ASP device.
To specify a specific auxiliary storage pool (ASP) device name when the search type specified for element 2 is *ASPGRP, you must have execute (*EXECUTE) authority for each ASP device in the ASP group.
Element 2: Search type
Specifies whether the single ASP device or the entire ASP group named in element 1 is to be searched.
| Top |
Specifies where the output from the command is sent.
| Top |
Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library.
Note: If a new file is created, the text describing that file is "Output file for DSPOBJD" and the public authority is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority. The database format (QLIDOBJD) of the output file is the same as that used in the IBM-supplied database file QADSPOBJ.
Qualifier 1: File to receive output
Qualifier 2: Library
| Top |
Specifies the name of the database file member that receives the output of the command.
Element 1: Member to receive output
Element 2: Replace or add records
| Top |
Example 1: Displaying a Basic Description of Objects
DSPOBJD OBJ(X/PAY) OBJTYPE(*ALL)
A basic description of all the objects for which you have some authority (except exclude (*EXCLUDE) authority) that are named PAY in library X are shown. Objects in the library for which you have no authority are not shown.
Example 2: Displaying a Full Description of a Program
DSPOBJD OBJ(X/PAY) OBJTYPE(*PGM) DETAIL(*FULL)
A full description of the program named PAY in library X is shown. The display includes all the attributes of the program.
Example 3: Displaying Program Information
DSPOBJD OBJ(*USRLIBL/PAY) OBJTYPE(*PGM)
This command shows information about the first program named PAY that is found in the user portion of the library list for the current thread.
Example 4: Displaying a Basic Description of Files
DSPOBJD OBJ(Z/ABC*) OBJTYPE(*FILE)
A basic description of all of the files whose names begin with ABC (generic name) located in library Z for which you have some authority (except exclude (*EXCLUDE) authority) are shown.
| Top |
*ESCAPE Messages
| Top |