194 lines
7.0 KiB
HTML
194 lines
7.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 Access Code Authority (GRTACCAUT)</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="GRTACCAUT.Top_Of_Page"></a>
|
||
|
|
<h2>Grant Access Code Authority (GRTACCAUT)</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="#GRTACCAUT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#GRTACCAUT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#GRTACCAUT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="GRTACCAUT"></a>
|
||
|
|
<p>The Grant Access Code Authority (GRTACCAUT) command allows you to give the specified users authority to access documents and folders associated with the access codes. Access is restricted to read only (*USE authority).
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The access code must be defined to the system before you can grant access code authority.
|
||
|
|
</li>
|
||
|
|
<li>The user being granted access code authority must be enrolled in the system distribution directory.
|
||
|
|
</li>
|
||
|
|
<li>To use this command, you must have all object (*ALLOBJ) or security administrator (*SECADM) special authority.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="GRTACCAUT.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="#GRTACCAUT.ACC"><b>ACC</b></a></td>
|
||
|
|
<td valign="top">Document access code</td>
|
||
|
|
<td valign="top">Single values: *REFUSER<br>Other values (up to 300 repetitions): 1-2047</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#GRTACCAUT.USER"><b>USER</b></a></td>
|
||
|
|
<td valign="top">User profile</td>
|
||
|
|
<td valign="top">Values (up to 300 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#GRTACCAUT.REFUSER"><b>REFUSER</b></a></td>
|
||
|
|
<td valign="top">Reference user profile</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="GRTACCAUT.ACC"></a>
|
||
|
|
<h3>Document access code (ACC)</h3>
|
||
|
|
<p>Specifies the access code being authorized for use by the user identified on the <b>User profile (USER)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*REFUSER</b></dt>
|
||
|
|
<dd>The access code authority being granted is based on the (referred to) user profile name; specified for the <b>Reference user profile (REFUSER)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-2047</i></b></dt>
|
||
|
|
<dd>Specify the access code to which you want authority to be granted. The access code must be defined to the system using the Add Access Code (ADDACC) command before being specified on this parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="GRTACCAUT.USER"></a>
|
||
|
|
<h3>User profile (USER)</h3>
|
||
|
|
<p>Specifies the user profile name of the users to whom you are granting access code authority. The users identified will have the access code added to their current list of authorized access codes; this access code is used to verify additional document and folder accesses from the document library. The user must be enrolled in the system distribution directory before being granted authority to use an access code.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>By granting an access code to a group user profile, that access code is granted (implicitly) to every user under that group.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p>You can specify 300 values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the user profile of a user to whom you are granting access code authority.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="GRTACCAUT.REFUSER"></a>
|
||
|
|
<h3>Reference user profile (REFUSER)</h3>
|
||
|
|
<p>Specifies the referred-to user profile on which the access code authority is based. If this parameter is used, then *REFUSER must be specified for the <b>Document access code (ACC)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No referred to user is used to grant access code authority.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the user profile that the access code authority is based on. This user must also be enrolled in the system distribution directory.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="GRTACCAUT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Granting Authority to Multiple Users</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
GRTACCAUT ACC(3 30 60) USER(SAM LARRY)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command gives authority to access codes 3, 30, and 60 to SAM and LARRY.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Granting Authority Based on Another User</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
GRTACCAUT ACC(*REFUSER) USER(JOE) REFUSER(TOM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command grants access code authority to JOE based on TOM's authority. For example, if JOE currently has authority to access codes 1, 12, and 50, and TOM currently has authority to access codes 8 and 9, the GRTACCAUT command authorizes JOE to access codes 1, 8, 9, 12, and 50.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="GRTACCAUT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF9009</b></dt>
|
||
|
|
<dd>System requires file &1 in &2 be journaled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9013</b></dt>
|
||
|
|
<dd>Access code authority given to &1 users, not granted to &2 users.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9024</b></dt>
|
||
|
|
<dd>System cannot get correct record to finish operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9065</b></dt>
|
||
|
|
<dd>Not allowed to give access code authority.
|
||
|
|
</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="#GRTACCAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|