580 lines
24 KiB
HTML
580 lines
24 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 Object Description (DSPOBJD)</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="DSPOBJD.Top_Of_Page"></a>
|
||
|
<h2>Display Object Description (DSPOBJD)</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="#DSPOBJD.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#DSPOBJD.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#DSPOBJD.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="DSPOBJD"></a>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p><b>Notes:</b>
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>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.
|
||
|
</li>
|
||
|
<li>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.
|
||
|
</li>
|
||
|
</ul>
|
||
|
<p><b>Restrictions:</b>
|
||
|
</p>
|
||
|
<ol>
|
||
|
<li>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.
|
||
|
</li>
|
||
|
<li>You must have some authority other than *EXCLUDE authority for each of the objects to be shown.
|
||
|
</li>
|
||
|
<li>You must have either all object (*ALLOBJ) or audit (*AUDIT) special authority to see a value other than *NOTAVL for the object auditing field.
|
||
|
</li>
|
||
|
</ol>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="DSPOBJD.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" rowspan="3"><a href="#DSPOBJD.OBJ"><b>OBJ</b></a></td>
|
||
|
<td valign="top">Object</td>
|
||
|
<td valign="top">Single values: *ALLUSR, *IBM<br>Other values: <i>Qualified object name</i></td>
|
||
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Qualifier 1: Object</td>
|
||
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
||
|
</tr><tr>
|
||
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *USRLIBL, *CURLIB, *ALL, *ALLUSR</td>
|
||
|
</tr><tr>
|
||
|
<td valign="top"><a href="#DSPOBJD.OBJTYPE"><b>OBJTYPE</b></a></td>
|
||
|
<td valign="top">Object type</td>
|
||
|
<td valign="top">Single values: *ALL<br>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</td>
|
||
|
<td valign="top">Required, Positional 2</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#DSPOBJD.DETAIL"><b>DETAIL</b></a></td>
|
||
|
<td valign="top">Detail</td>
|
||
|
<td valign="top"><b><u>*BASIC</u></b>, *FULL, *SERVICE</td>
|
||
|
<td valign="top">Optional, Positional 3</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="3"><a href="#DSPOBJD.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
<td valign="top">ASP device</td>
|
||
|
<td valign="top">Single values: <b><u>*</u></b>, *ALLAVL, *CURASPGRP, *SYSBAS<br>Other values: <i>Element list</i></td>
|
||
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 1: Device</td>
|
||
|
<td valign="top">
|
||
|
<i>Name</i></td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 2: Search type</td>
|
||
|
<td valign="top">
|
||
|
<b><u>*ASP</u></b>, *ASPGRP</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#DSPOBJD.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
<td valign="top">Output</td>
|
||
|
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="3"><a href="#DSPOBJD.OUTFILE"><b>OUTFILE</b></a></td>
|
||
|
<td valign="top">File to receive output</td>
|
||
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Qualifier 1: File to receive output</td>
|
||
|
<td valign="top"><i>Name</i></td>
|
||
|
</tr><tr>
|
||
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
</tr><tr>
|
||
|
<td valign="top" rowspan="3"><a href="#DSPOBJD.OUTMBR"><b>OUTMBR</b></a></td>
|
||
|
<td valign="top">Output member options</td>
|
||
|
<td valign="top"><i>Element list</i></td>
|
||
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 1: Member to receive output</td>
|
||
|
<td valign="top">
|
||
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 2: Replace or add records</td>
|
||
|
<td valign="top">
|
||
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="DSPOBJD.OBJ"></a>
|
||
|
<h3>Object (OBJ)</h3>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p>This is a required parameter.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>*ALLUSR</b></dt>
|
||
|
<dd>When the object name has a value of *ALLUSR, the object type must be *LIB. All user libraries in the auxiliary storage pools (ASPs) specified for the <b>ASP device (ASPDEV)</b> parameter are shown. Refer to *ALLUSR in the description of library (qualifier 2) for a definition of user libraries.
|
||
|
</dd>
|
||
|
<dt><b>*IBM</b></dt>
|
||
|
<dd>When the object name has a value of *IBM, the object type must be *LIB. All libraries in the auxiliary storage pools (ASPs) defined by the <b>ASP device (ASPDEV)</b> parameter which are saved and restored using the SAVLIB and RSTLIB CL commands with *IBM specified for the <b>Library (LIB)</b> parameter are shown.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Qualifier 1: Object</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>All objects in the libraries identified in library (qualifier 2) that are of the types specified for the <b>Object type (OBJTYPE)</b> parameter and for which you have some authority other than *EXCLUDE authority are shown.
|
||
|
<ol>
|
||
|
<li>If the library (qualifier 2) is *ALL, *ALLUSR, or a library name, all objects of the specified type and that are in the specified libraries are shown.
|
||
|
</li>
|
||
|
<li>If the library (qualifier 2) is *USRLIBL or *LIBL and the object name is a specific name (not *ALL and not a generic name), only one object type (and not *ALL) can be specified for the OBJTYPE parameter and only the first object found is shown.
|
||
|
</li>
|
||
|
</ol>
|
||
|
</dd>
|
||
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
<dd>Specify the generic name of the objects to be shown. A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). A generic name specifies all objects that have names with the same prefix as the generic object name for which you have some authority other than *EXCLUDE authority.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the object to be shown.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Qualifier 2: Library</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
<dd>All libraries in the library list for the current thread are searched until the first match is found. If the <b>ASP device (ASPDEV)</b> parameter is specified when this value is used, ASPDEV(*) is the only valid value.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*CURLIB</b></dt>
|
||
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched. If the <b>ASP device (ASPDEV)</b> parameter is specified when this value is used, ASPDEV(*) is the only valid value.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<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 searched. If there is no current library entry, only the libraries in the user portion of the library list are searched. If the <b>ASP device (ASPDEV)</b> parameter is specified when this value is used, ASPDEV(*) is the only valid value.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>All the libraries in the auxiliary storage pools (ASPs) specified for the <b>ASP device (ASPDEV)</b> parameter are searched.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*ALLUSR</b></dt>
|
||
|
<dd>All user libraries in the auxiliary storage pools (ASPs) defined by the <b>ASP device (ASPDEV)</b> parameter are searched.
|
||
|
<p>User libraries are all libraries with names that do not begin with the letter Q except for the following:
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
#CGULIB #DSULIB #SEULIB
|
||
|
#COBLIB #RPGLIB
|
||
|
#DFULIB #SDALIB
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>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:
|
||
|
</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>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the library to be searched.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="DSPOBJD.OBJTYPE"></a>
|
||
|
<h3>Object type (OBJTYPE)</h3>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p>This is a required parameter.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>All types of objects with the specified object name are shown.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Other values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>object-type</i></b></dt>
|
||
|
<dd>Specify one or more values for the types of objects that are shown. All objects in the specified libraries, as well as libraries themselves, that have the object type(s) specified have their object attributes shown. If the library qualifier for the <b>Object (OBJ)</b> parameter is *USRLIBL or *LIBL and the object name qualifier is a specific name (not *ALL and not a generic name), only one object type (and not *ALL) can be specified here.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="DSPOBJD.DETAIL"></a>
|
||
|
<h3>Detail (DETAIL)</h3>
|
||
|
<p>Specifies which set of attributes is shown for each object.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>When the output is directed to a database file, this parameter is ignored and all object attribute information is written to the file.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*BASIC</u></b></dt>
|
||
|
<dd>The display or listing contains the name and a basic set of object attributes for each object.
|
||
|
</dd>
|
||
|
<dt><b>*FULL</b></dt>
|
||
|
<dd>The display or listing contains the name and a full set of object attributes for each object (which includes the basic set of attributes).
|
||
|
</dd>
|
||
|
<dt><b>*SERVICE</b></dt>
|
||
|
<dd>The display or listing contains the service-related attributes for each object.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="DSPOBJD.ASPDEV"></a>
|
||
|
<h3>ASP device (ASPDEV)</h3>
|
||
|
<p>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 <b>Object (OBJ)</b> 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.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</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>
|
||
|
<p><b>Element 1: Device</b>
|
||
|
</p>
|
||
|
<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 when the search type specified for element 2 is *ASP, you must have execute (*EXECUTE) authority for the specific ASP device.
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p><b>Element 2: Search type</b>
|
||
|
</p>
|
||
|
<p>Specifies whether the single ASP device or the entire ASP group named in element 1 is to be searched.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*ASP</u></b></dt>
|
||
|
<dd>Only the single auxiliary storage pool (ASP) device named in element 1 is to be searched.
|
||
|
</dd>
|
||
|
<dt><b>*ASPGRP</b></dt>
|
||
|
<dd>The entire group of the primary auxiliary storage pool (ASP) device named in element 1 is to be searched.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="DSPOBJD.OUTPUT"></a>
|
||
|
<h3>Output (OUTPUT)</h3>
|
||
|
<p>Specifies where the output from the command is sent.
|
||
|
</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>
|
||
|
<dt><b>*OUTFILE</b></dt>
|
||
|
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="DSPOBJD.OUTFILE"></a>
|
||
|
<h3>File to receive output (OUTFILE)</h3>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>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.
|
||
|
</p>
|
||
|
<p><b>Qualifier 1: File to receive output</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>name</b></dt>
|
||
|
<dd>Specify the name of the file to which the output of the command is directed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Qualifier 2: Library</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*CURLIB</b></dt>
|
||
|
<dd>The current library for the job is searched to find the file. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the library to be searched to find the file.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="DSPOBJD.OUTMBR"></a>
|
||
|
<h3>Output member options (OUTMBR)</h3>
|
||
|
<p>Specifies the name of the database file member that receives the output of the command.
|
||
|
</p>
|
||
|
<p><b>Element 1: Member to receive output</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the file member that receives the output. If it does not exist, the system creates it.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 2: Replace or add records</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*REPLACE</u></b></dt>
|
||
|
<dd>The system clears the existing member and adds the new records.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*ADD</b></dt>
|
||
|
<dd>The system adds the new records to the end of the existing records.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="DSPOBJD.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
<p><b>Example 1: Displaying a Basic Description of Objects</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
DSPOBJD OBJ(X/PAY) OBJTYPE(*ALL)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p><b>Example 2: Displaying a Full Description of a Program</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
DSPOBJD OBJ(X/PAY) OBJTYPE(*PGM) DETAIL(*FULL)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>A full description of the program named PAY in library X is shown. The display includes all the attributes of the program.
|
||
|
</p>
|
||
|
<p><b>Example 3: Displaying Program Information</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
DSPOBJD OBJ(*USRLIBL/PAY) OBJTYPE(*PGM)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
<p><b>Example 4: Displaying a Basic Description of Files</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
DSPOBJD OBJ(Z/ABC*) OBJTYPE(*FILE)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>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.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="DSPOBJD.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>CPF2105</b></dt>
|
||
|
<dd>Object &1 in &2 type *&3 not found.
|
||
|
</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>CPF2114</b></dt>
|
||
|
<dd>Cannot allocate object &1 in &2 type *&3.
|
||
|
</dd>
|
||
|
<dt><b>CPF2115</b></dt>
|
||
|
<dd>Object &1 in &2 type *&3 damaged.
|
||
|
</dd>
|
||
|
<dt><b>CPF2121</b></dt>
|
||
|
<dd>One or more libraries cannot be accessed.
|
||
|
</dd>
|
||
|
<dt><b>CPF2123</b></dt>
|
||
|
<dd>No objects of specified name or type exist in library &2.
|
||
|
</dd>
|
||
|
<dt><b>CPF2124</b></dt>
|
||
|
<dd>No specified objects can be displayed from library &2.
|
||
|
</dd>
|
||
|
<dt><b>CPF2150</b></dt>
|
||
|
<dd>Object information function failed.
|
||
|
</dd>
|
||
|
<dt><b>CPF2176</b></dt>
|
||
|
<dd>Library &1 damaged.
|
||
|
</dd>
|
||
|
<dt><b>CPF2177</b></dt>
|
||
|
<dd>OBJTYPE value not compatible with OBJ value.
|
||
|
</dd>
|
||
|
<dt><b>CPF218C</b></dt>
|
||
|
<dd>&1 not a primary or secondary ASP.
|
||
|
</dd>
|
||
|
<dt><b>CPF218D</b></dt>
|
||
|
<dd>&1 not a primary ASP when *ASPGRP specified.
|
||
|
</dd>
|
||
|
<dt><b>CPF2182</b></dt>
|
||
|
<dd>Not authorized to library &1.
|
||
|
</dd>
|
||
|
<dt><b>CPF2189</b></dt>
|
||
|
<dd>Not authorized to object &1 in &2 type *&3.
|
||
|
</dd>
|
||
|
<dt><b>CPF326B</b></dt>
|
||
|
<dd>Damage to file &1 in library &2.
|
||
|
</dd>
|
||
|
<dt><b>CPF9809</b></dt>
|
||
|
<dd>Library &1 cannot be accessed.
|
||
|
</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>CPF9827</b></dt>
|
||
|
<dd>Object &1 cannot be created or moved into &2.
|
||
|
</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>
|
||
|
<dt><b>CPF9850</b></dt>
|
||
|
<dd>Override of printer file &1 not allowed.
|
||
|
</dd>
|
||
|
<dt><b>CPF9851</b></dt>
|
||
|
<dd>Overflow value for file &1 in &2 too small.
|
||
|
</dd>
|
||
|
<dt><b>CPF9860</b></dt>
|
||
|
<dd>Error occurred during output file processing.
|
||
|
</dd>
|
||
|
<dt><b>CPF9899</b></dt>
|
||
|
<dd>Error occurred during processing of command.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#DSPOBJD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|