CL Command Reference - DSPOBJD
CL Command List > DSPOBJD Reference
Description:
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 OS/400 system object for which you have some authority (except exclude (*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:
. For objects that are damaged or locked, the information shown, printed, or written to the output file is incomplete. If the description of the object is shown or printed, the text for the damaged or locked object indicates either the damaged or locked status. If the description of the object is written to an output file, an indication that the object is locked or damaged is included in the output file.
. The size of the library object shown does not include the sizes of the objects in the library. The total size of the library, including the sizes of the objects in the library, can be obtained using the Display Library (DSPLIB) command with OUTPUT(*PRINT) or the Retrieve Library Description (QLIRLIBD) API.
Restrictions:
1. You must have execute (*EXECUTE) authority for the specified libraries. If you do not have *EXECUTE authority for a library, none of its objects are shown.
2. You must have some authority (except exclude (*EXCLUDE) authority) for each of the objects to be shown.
Examples:
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.