CL Command Reference - DSPLIB
CL Command List > DSPLIB Reference
Description:
The Display Library (DSPLIB) command displays the contents of one or more specified libraries; that is, it displays a list of the names and attributes of the objects in each library. For all object types except user profiles (*USRPRF), the object is shown in the list of objects regardless of the authorizations you have for the object. For user profile (*USRPRF) objects, the object is shown in the list of objects only if you have some authority (except exclude (*EXCLUDE) authority) for the object.
This command can also be used to display a list of libraries from which individual libraries may be selected for a display of their objects. The display lists the name, type, auxiliary storage pool device name, and the descriptive text for each library. If more than one library is to be displayed, they are displayed one at a time.
From the display of a library¡¯s objects, the full or service options can be specified to request displays that show more specific information about the objects in the library.
Restrictions:
1. To display the contents of a library, you must have read (*READ) authority for each library specified.
2. For all object types except user profiles (*USRPRF), the object is shown in the list of objects regardless of the authorizations you have for the object. You do need some authority (except exclude (*EXCLUDE) authority) for the object to display either the full or service attributes for the object. For user profile (*USRPRF) objects, the object is shown in the list of objects only if you have some authority (except *EXCLUDE authority) for the object.
Notes:
1. For printed output, the total-size field of the library includes the size of the objects in the library plus the size of the library object itself. If this value is followed by a plus (+) sign, objects in the library are locked, damaged or not authorized and the sizes of them have not been included in the total-size field. The plus sign indicates that the actual total of all objects is greater than the value displayed. If the library is QSYS, the user profiles for which you are not authorized are not shown in the list.
2. If *ALL, *ALLUSR, *LIBL, or *USRLIBL is specified for the Library (LIB) parameter and output is printed, the contents of the libraries are printed. If one of these values is specified and the output is displayed, a list of the libraries is displayed from which individual libraries may be selected for further display.
Examples:
Example 1: Displaying a Library
DSPLIB LIB(QGPL)
The names, types, and basic descriptions of all the objects located in the QGPL library are either shown on the work station from which the command was submitted, or printed on the system printer if the command was run in a batch job.
Example 2: Displaying a Library in an Independent Auxiliary Storage Pool (ASP)
DSPLIB LIB(INVENTORY) ASPDEV(SALES)
This command displays the names, types, and basic descriptions of all the objects located in the INVENTORY library in the independent auxiliary storage pool (ASP) named SALES regardless of the authorizations you have to the objects in the library. The SALES ASP must have been activated (by varying on the ASP device) and have a status of ¡¯Available¡¯. The information is either shown on the work station from which the command was submitted, or printed on the system printer if the command was run in a batch job.