ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dspobjaut.htm

373 lines
15 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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 Authority (DSPOBJAUT)</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="DSPOBJAUT.Top_Of_Page"></a>
<h2>Display Object Authority (DSPOBJAUT)</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="#DSPOBJAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPOBJAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPOBJAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPOBJAUT"></a>
<p>The Display Object Authority (DSPOBJAUT) command displays the list of authorized users of an object and their assigned authority. If the object is secured by an authorization list, the name of the authorization list is also displayed. The public authority and primary group authority are also shown.
</p>
<p>If the user entering the command does not have object management (*OBJMGT) authority to the object, only that user's name and authorities are shown. The names of the other users and their authorities for the object are not shown. If an object does not have an owner name associated with it, no authorities for the object are shown.
</p>
<p>The following are shown for the specified object:
</p>
<ul>
<li>The object name
</li>
<li>The name of the library containing the object
</li>
<li>The name of the object owner
</li>
<li>The object type
</li>
<li>A list of all the users who are authorized to use the object
</li>
<li>The authority that each user has for the object
</li>
<li>The authorization list name (if the object is secured by an authorization list)
</li>
</ul>
<p><b>Restrictions:</b> You must have use (*USE) authority to the auxiliary storage pool device if one is specified.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPOBJAUT.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="#DSPOBJAUT.OBJ"><b>OBJ</b></a></td>
<td valign="top">Object</td>
<td valign="top"><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>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"><a href="#DSPOBJAUT.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object type</td>
<td valign="top">*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, *M36, *M36CFG, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *S36, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPOBJAUT.ASPDEV"><b>ASPDEV</b></a></td>
<td valign="top">ASP device</td>
<td valign="top"><i>Name</i>, <b><u>*</u></b>, *SYSBAS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPOBJAUT.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, Positional 3</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPOBJAUT.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">File to receive output</td>
<td valign="top">Single values: *NONE<br>Other values: <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="#DSPOBJAUT.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>
<tr>
<td valign="top"><a href="#DSPOBJAUT.AUTTYPE"><b>AUTTYPE</b></a></td>
<td valign="top">Authority type</td>
<td valign="top"><b><u>*OBJECT</u></b>, *FIELD, *ALL</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPOBJAUT.OBJ"></a>
<h3>Object (OBJ)</h3>
<p>Specifies the object for which the authorized users and their authority are to be displayed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the object.
</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>
<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 used.
</dd>
<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="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPOBJAUT.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>Specifies the object type of the object whose authority is to be displayed, such as program (*PGM), file (*FILE), or library (*LIB). 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).
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPOBJAUT.ASPDEV"></a>
<h3>ASP device (ASPDEV)</h3>
<p>Specifies the auxiliary storage pool (ASP) device name where the library that contains the object (OBJ parameter) is located. If the object's library resides in an ASP that is not part of the library name space associated with the job, this parameter must be specified to ensure the correct object is used as the target of this command's operation.
</p>
<dl>
<dt><b>*</b></dt>
<dd>The ASPs that are currently part of the job's library name space will be searched to locate the object. This includes the system ASP (ASP number 1), all defined basic user ASPs (ASP numbers 2-32), and, if the job has an ASP group, all independent ASPs in the ASP group.
</dd>
<dt><b>*SYSBAS</b></dt>
<dd>The system ASP and all basic user ASPs will be searched to locate the object. No independent ASPs will be searched, even if the job has an ASP group.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the device name of the independent ASP to be searched to locate the object. The independent ASP must have been activated (by varying on the ASP device) and have a status of AVAILABLE. The system ASP and basic user ASPs will not be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPOBJAUT.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="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPOBJAUT.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. If the file is created, the public authority for the file 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.
</p>
<p><b>Qualifier 1: File to receive output</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the database file to which the command output is directed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<p>
<b>Note: </b>If a new file is created, the system uses QAOBJAUT in QSYS with a format name of QSYDSAUT as a model.
</p>
<p>If AUTTYPE(*FIELD) is specified for a *FILE object and a new outfile is created, the system uses QAFLDAUT in QSYS with a format name of QSYDSFLD as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPOBJAUT.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="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPOBJAUT.AUTTYPE"></a>
<h3>Authority type (AUTTYPE)</h3>
<p>Specifies whether object level authority, field level authority, or both object level and field level authority are displayed. Field level authority information only applies to *FILE objects.
</p>
<dl>
<dt><b><u>*OBJECT</u></b></dt>
<dd>The object level authority information is displayed, placed in a spooled file, or placed in an outfile.
<p>If OUTPUT(*) is requested and the object is a file with field level authorities, the F16 key, Display Field Authorities, will be enabled on the display.
</p>
</dd>
<dt><b>*FIELD</b></dt>
<dd>The field level authority information is displayed, placed in a spooled file, or placed in an outfile.
<p>This value is only valid if *FILE is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
</dd>
<dt><b>*ALL</b></dt>
<dd>If OUTPUT(*) is requested, the object level authority information is displayed. If there are field level authorities associated with the file, the F16 key, Display Field Authorities, will be enabled on the display. If OUTPUT(*PRINT) is requested, the object level and field level authority data are included in the spooled file. AUTTYPE(*ALL) is not valid with OUTPUT(*OUTFILE).
<p>This value is only valid if *FILE is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPOBJAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying Users and Authorities</b>
</p>
<p>
<pre>
DSPOBJAUT OBJ(ARLIB/PROG1) OBJTYPE(*PGM)
</pre>
</p>
<p>This command shows the authorized users and their authorities for the object named PROG1 to the user who entered the command, if that user has object management authority for the object. If the user does not have object management authority, only personal authorities are shown. PROG1 is a program (*PGM) located in the library named ARLIB. The system assumes * for the device that shows the output list. If the command was entered in the batch subsystem, the output is placed in the default output queue for the job. If the command was entered in the interactive subsystem, the output is shown on the device where the user entered the command.
</p>
<p><b>Example 2: Printing List of Users</b>
</p>
<p>
<pre>
DSPOBJAUT OBJ(ARLIB/PROG2) OBJTYPE(*PGM) OUTPUT(*PRINT)
</pre>
</p>
<p>This command causes the list of authorized users of the program named PROG2 in the ARLIB library to be printed. If the user who enters the command does not have object management authority for the program, only that user's name and authorities are printed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPOBJAUT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2204</b></dt>
<dd>User profile &amp;1 not found.
</dd>
<dt><b>CPF2207</b></dt>
<dd>Not authorized to use object &amp;1 in library &amp;3 type *&amp;2.
</dd>
<dt><b>CPF2208</b></dt>
<dd>Object &amp;1 in library &amp;3 type *&amp;2 not found.
</dd>
<dt><b>CPF2209</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF2211</b></dt>
<dd>Not able to allocate object &amp;1 in &amp;3 type *&amp;2.
</dd>
<dt><b>CPF2216</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF224E</b></dt>
<dd>The AUTTYPE value of *FIELD is not valid for file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</dd>
<dt><b>CPF9843</b></dt>
<dd>Object &amp;1 in library &amp;3 type &amp;2 cannot be accessed.
</dd>
<dt><b>CPF9860</b></dt>
<dd>Error occurred during output file processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>