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

167 lines
6.0 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>Grant User Authority (GRTUSRAUT)</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="GRTUSRAUT.Top_Of_Page"></a>
<h2>Grant User Authority (GRTUSRAUT)</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="#GRTUSRAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#GRTUSRAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#GRTUSRAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="GRTUSRAUT"></a>
<p>The Grant User Authority (GRTUSRAUT) command grants authority to a user by referring to another user profile.
</p>
<p>
<b>Note: </b>You should use group support or authorization lists instead of the Grant User Authority (GRTUSRAUT) command support whenever possible for better performance in granting authority and the subsequent SAVSYS or SAVSECDTA function.
</p>
<p>If a security officer issues this command, the authorities in the user profile are granted to the receiving user, including object management authority.
</p>
<p>If this command is run by the owner of the user profile, all authorities for each object owned are granted, including object management authority.
</p>
<p>For objects that the user profile being referred to does not own but is authorized to use, the user of this command must have object management authority and the authorities to be granted for the object, or must own the object. Otherwise, no authority is granted for the object.
</p>
<p>Ownership of objects or authorities held by a user profile cannot be changed by this command. Authorities to objects granted to a user profile are added to any authorities that the user profile already had.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>The following user profiles cannot be specified for either of the parameters on this command:
<p>QANZAGENT, QAUTPROF, QCLUMGT, QCLUSTER, QCOLSRV, QDBSHR, QDBSHRDO, QDFTOWN, QDIRSRV, QDLFM, QDOC, QDSNX, QEJB, QEJBSVR, QGATE, QIBMHELP, QIPP, QLPAUTO, QLPINSTALL, QMGTC, QMSF, QNETSPLF, QNFSANON, QNTP, QPEX, QPM400, QRJE, QSNADS, QSPL, QSRVAGT, QSYS, QTCM, QTCP, QTMHHTP1, QTMHHTTP, QTSTRQS, QYCMCIMOM, QYPSJSVR
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#GRTUSRAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="GRTUSRAUT.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="#GRTUSRAUT.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#GRTUSRAUT.REFUSER"><b>REFUSER</b></a></td>
<td valign="top">Referenced user</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#GRTUSRAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="GRTUSRAUT.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the user profile to whom authority is to be granted.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#GRTUSRAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="GRTUSRAUT.REFUSER"></a>
<h3>Referenced user (REFUSER)</h3>
<p>Specifies the user profile to be referred to for authority.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#GRTUSRAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="GRTUSRAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Running GRTUSRAUT under QSECOFR User Profile</b>
</p>
<p>
<pre>
GRTUSRAUT USER(USRB) REFUSER(USRA)
</pre>
</p>
<p>This command grants the user profile USRB the same authorities that USRA has for all objects that USRA owns (including object management authority) or has authority to.
</p>
<p><b>Example 2: Running GRTUSRAUT under User Profile USRA </b>
</p>
<p>
<pre>
GRTUSRAUT USER(USRB) REFUSER(USRC)
</pre>
</p>
<p>This command grants the user profile USRB the same authorities that USRC has for all objects that USRC has authorities to only if USRA, entering this command, has object management authority to the objects or is the owner of the objects being referred to.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#GRTUSRAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="GRTUSRAUT.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>CPF2211</b></dt>
<dd>Not able to allocate object &amp;1 in &amp;3 type *&amp;2.
</dd>
<dt><b>CPF2213</b></dt>
<dd>Not able to allocate user profile &amp;1.
</dd>
<dt><b>CPF2217</b></dt>
<dd>Not authorized to user profile &amp;1.
</dd>
<dt><b>CPF2222</b></dt>
<dd>Storage limit is greater than specified for user profile &amp;1.
</dd>
<dt><b>CPF2223</b></dt>
<dd>Not authorized to give authority to object &amp;1 in &amp;3 type *&amp;2.
</dd>
<dt><b>CPF2252</b></dt>
<dd>Authority given to &amp;2 objects. Authority not given to &amp;3 objects.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#GRTUSRAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>