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

218 lines
8.5 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>Edit Object Authority (EDTOBJAUT)</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="EDTOBJAUT.Top_Of_Page"></a>
<h2>Edit Object Authority (EDTOBJAUT)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#EDTOBJAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#EDTOBJAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#EDTOBJAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="EDTOBJAUT"></a>
<p>The Edit Object Authority (EDTOBJAUT) command displays the list of authorized users of an object and their associated user authorities. If you own the object, or have *ALLOBJ special authority, you can add, change or remove authority for the object. If you have object management authority for the object, you can remove your specific authorities or grant or remove them for other users.
</p>
<p>The following are displayed 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's owner
</li>
<li>The object's 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 is displayed when the object is secured by an authorization list.
</li>
</ul>
<p>If an object does not have an owner name associated with it, no authorities for the object are shown.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>The user must have object management authority to the object to use this command.
</li>
<li>If the object is a file, the user must have object operational and object management authorities.
</li>
<li>You must have *USE authority to the auxiliary storage pool device if one is specified.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="EDTOBJAUT.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="#EDTOBJAUT.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="#EDTOBJAUT.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, *DTAARA, *DTADCT, *DTAQ, *EDTD, *FCT, *FILE, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCTBL, *IGCSRT, *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="#EDTOBJAUT.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="EDTOBJAUT.OBJ"></a>
<h3>Object (OBJ)</h3>
<p>Specifies the object for which the authorized users and their authorities are to be shown.
</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="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EDTOBJAUT.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>The object type, such as command (*CMD), file (*FILE), or program (*PGM), of the object whose authorized users and authorities are to be shown. 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="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EDTOBJAUT.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="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="EDTOBJAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
EDTOBJAUT OBJ(ARLIB/PROG1) OBJTYPE(*PGM)
</pre>
</p>
<p>This command causes the list of authorized users and their authorities for the object named PROG1 to be shown, but only if the user has object management authority for the object. PROG1 is a program (*PGM) located in the library named ARLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="EDTOBJAUT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF22B8</b></dt>
<dd>Not authorized to change authorities.
</dd>
<dt><b>CPF22B9</b></dt>
<dd>Not authorized to change authorities.
</dd>
<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>CPF2217</b></dt>
<dd>Not authorized to user profile &amp;1.
</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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTOBJAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>