Display Library (DSPLIB)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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, the object is shown in the list of objects only if you have some authority other than *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:
- You must have read (*READ) authority for each library specified to display the contents of the library.
- For all object types, the object is shown in the list of objects only if you have some authority other than *EXCLUDE authority for the object.
Notes:
- 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 (*LIB) object. 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. The objects for which you are not authorized are not shown in the list.
- 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.
Top |
Parameters
Keyword | Description | Choices | Notes |
---|---|---|---|
LIB | Library | Single values: *LIBL, *USRLIBL, *CURLIB, *ALLUSR, *ALL Other values (up to 15 repetitions): Name |
Optional, Positional 1 |
ASPDEV | ASP device | Name, *, *ALLAVL, *CURASPGRP, *SYSBAS | Optional |
OUTPUT | Output | Optional, Positional 2 |
Top |
Library (LIB)
Specifies one or more libraries to be displayed or printed. If you do not have read (*READ) authority for a specified library, that library is not displayed. This parameter can be specified as a single value or as a list of one or more names.
Single values
- *LIBL
- All libraries in the library list for the current thread are displayed. If the ASP device (ASPDEV) parameter is specified when this value is used, ASPDEV(*) is the only valid value.
- *USRLIBL
- If a current library entry exists in the library list for the current thread, the current library and the libraries in the user portion of the library list are displayed. If there is no current library entry, only the libraries in the user portion of the library list are displayed. If the ASPDEV parameter is specified when this value is used, ASPDEV(*) is the only valid value.
- *CURLIB
- The current library for the current thread is displayed. If no library is specified as the current library for the thread, the QGPL library is displayed. If the ASPDEV parameter is specified when this value is used, ASPDEV(*) is the only valid value.
- *ALL
- All the libraries in the auxiliary storage pools (ASPs) defined by the ASPDEV parameter are displayed.
- *ALLUSR
- All user libraries and libraries containing user data and having names starting with the letter Q in the auxiliary storage pools (ASPs) defined by the ASPDEV parameter are displayed. 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 Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also searched:
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
- 'xxxxx' is the number of a primary auxiliary storage pool (ASP).
- A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
Other values
- name
- Specify the name of one or more libraries whose objects are to be displayed. Up to 15 names can be specified.
Top |
ASP device (ASPDEV)
Specifies the auxiliary storage pool (ASP) device where storage is allocated for the library to be displayed. If the library is 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 displayed. If this parameter is used when *CURLIB, *LIBL, or *USRLIBL is specified for the Library (LIB) parameter, ASPDEV(*) is the only valid value.
- *
- The ASPs that are currently part of the thread's library name space will be searched to find the library. This includes the system ASP (ASP 1), all defined basic user ASPs (ASPs 2-32), and, if the thread has an ASP group, the primary and secondary ASPs in the thread's ASP group.
- *ALLAVL
- All available ASPs will be searched. This includes the system ASP (ASP 1), all defined basic user ASPs (ASPs 2-32), and all available primary and secondary ASPs (ASPs 33-255 with a status of 'Available'). The ASP groups are searched in alphabetical order by the primary ASP. The system ASP and all defined basic user ASPs are searched after the ASP groups. ASPs and libraries to which the user is not authorized are bypassed and no authority error messages are sent.
- *CURASPGRP
- If the thread has an ASP group, the primary and secondary ASPs in the thread's ASP group will be searched to find the library. The system ASP (ASP 1) and defined basic user ASPs (ASPs 2-32) will not be searched. If no ASP group is associated with the thread an error will be issued.
- *SYSBAS
- The system ASP (ASP 1) and all defined basic user ASPs (ASPs 2-32) will be searched to find the library. No primary or secondary ASPs will be searched, even if the thread has an ASP group.
- name
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, you must have execute (*EXECUTE) authority for the specific ASP device.
Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
- *
- The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
- The output is printed with the job's spooled output.
Top |
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. The SALES ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
Top |
Error messages
*ESCAPE Messages
- CPFB8ED
- Device description &1 not correct for operation.
- CPF210E
- Library &1 not available for reason code &2.
- CPF2110
- Library &1 not found.
- CPF2113
- Cannot allocate library &1.
- CPF2148
- Library marked *DELETED not found.
- CPF2150
- Object information function failed.
- CPF2176
- Library &1 damaged.
- CPF2179
- Cannot display library.
- CPF218C
- &1 not a primary or secondary ASP.
- CPF2182
- Not authorized to library &1.
- CPF9814
- Device &1 not found.
- CPF9825
- Not authorized to device &1.
- CPF9833
- *CURASPGRP or *ASPGRPPRI specified and thread has no ASP group.
- CPF9845
- Error occurred while opening file &1.
- CPF9846
- Error while processing file &1 in library &2.
- CPF9847
- Error occurred while closing file &1 in library &2.
Top |