292 lines
13 KiB
HTML
292 lines
13 KiB
HTML
|
|
||
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<title>Display Library (DSPLIB)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="DSPLIB.Top_Of_Page"></a>
|
||
|
|
<h2>Display Library (DSPLIB)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#DSPLIB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#DSPLIB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#DSPLIB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="DSPLIB"></a>
|
||
|
|
<p>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 other than *EXCLUDE authority for the object.
|
||
|
|
</p>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have read (*READ) authority for each library specified to display the contents of the library.
|
||
|
|
</li>
|
||
|
|
<li>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 must have some authority other than *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 other than *EXCLUDE authority for the object.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>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.
|
||
|
|
</li>
|
||
|
|
<li>If *ALL, *ALLUSR, *LIBL, or *USRLIBL is specified for the <b>Library (LIB)</b> 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.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="DSPLIB.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPLIB.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Library</td>
|
||
|
|
<td valign="top">Single values: <b><u>*LIBL</u></b>, *USRLIBL, *CURLIB, *ALLUSR, *ALL<br>Other values (up to 15 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPLIB.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
|
<td valign="top">ASP device</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*</u></b>, *ALLAVL, *CURASPGRP, *SYSBAS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPLIB.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="DSPLIB.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are displayed. If the <b>ASP device (ASPDEV)</b> parameter is specified when this value is used, ASPDEV(*) is the only valid value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USRLIBL</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All the libraries in the auxiliary storage pools (ASPs) defined by the ASPDEV parameter are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>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:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
#CGULIB #DSULIB #SEULIB
|
||
|
|
#COBLIB #RPGLIB
|
||
|
|
#DFULIB #SDALIB
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>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:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
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
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>'xxxxx' is the number of a primary auxiliary storage pool (ASP).
|
||
|
|
</li>
|
||
|
|
<li>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.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of one or more libraries whose objects are to be displayed. Up to 15 names can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPLIB.ASPDEV"></a>
|
||
|
|
<h3>ASP device (ASPDEV)</h3>
|
||
|
|
<p>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 <b>Library (LIB)</b> parameter, ASPDEV(*) is the only valid value.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALLAVL</b></dt>
|
||
|
|
<dd>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').
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURASPGRP</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SYSBAS</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To specify a specific auxiliary storage pool (ASP) device name, you must have use (*USE) authority for each ASP device in the ASP group.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPLIB.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="DSPLIB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Displaying a Library</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DSPLIB LIB(QGPL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Displaying a Library in an Independent Auxiliary Storage Pool (ASP)</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DSPLIB LIB(INVENTORY) ASPDEV(SALES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="DSPLIB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPFB8ED</b></dt>
|
||
|
|
<dd>Device description &1 not correct for operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF210E</b></dt>
|
||
|
|
<dd>Library &1 not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2110</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2113</b></dt>
|
||
|
|
<dd>Cannot allocate library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2148</b></dt>
|
||
|
|
<dd>Library marked *DELETED not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2150</b></dt>
|
||
|
|
<dd>Object information function failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2176</b></dt>
|
||
|
|
<dd>Library &1 damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2179</b></dt>
|
||
|
|
<dd>Cannot display library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF218C</b></dt>
|
||
|
|
<dd>&1 not a primary or secondary ASP.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2182</b></dt>
|
||
|
|
<dd>Not authorized to library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9814</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9825</b></dt>
|
||
|
|
<dd>Not authorized to device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9833</b></dt>
|
||
|
|
<dd>*CURASPGRP or *ASPGRPPRI specified and thread has no ASP group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9845</b></dt>
|
||
|
|
<dd>Error occurred while opening file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9846</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9847</b></dt>
|
||
|
|
<dd>Error occurred while closing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|