306 lines
11 KiB
HTML
306 lines
11 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>Add DLO Authority (ADDDLOAUT)</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="ADDDLOAUT.Top_Of_Page"></a>
|
||
|
|
<h2>Add DLO Authority (ADDDLOAUT)</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="#ADDDLOAUT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ADDDLOAUT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ADDDLOAUT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ADDDLOAUT"></a>
|
||
|
|
<p>The Add Document Library Object Authority (ADDDLOAUT) command allows you to give a user access to a document or folder. It allows you to specify authority for users in the following ways:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Give specific authority to a user.
|
||
|
|
</li>
|
||
|
|
<li>Give a set of users authority by specifying a previously defined authorization list.
|
||
|
|
</li>
|
||
|
|
<li>Give a group of users use (*USE) access by specifying an access code.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<p>The user of this command must have all (*ALL) authority to the objects, have all object (*ALLOBJ) special authority, or be the owner of the objects.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ADDDLOAUT.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="#ADDDLOAUT.DLO"><b>DLO</b></a></td>
|
||
|
|
<td valign="top">Document library object</td>
|
||
|
|
<td valign="top"><i>Character value</i>, *ALL, *SYSOBJNAM</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDDLOAUT.FLR"><b>FLR</b></a></td>
|
||
|
|
<td valign="top">Folder</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#ADDDLOAUT.USRAUT"><b>USRAUT</b></a></td>
|
||
|
|
<td valign="top">User authority</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: User profile</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Authority level</td>
|
||
|
|
<td valign="top">
|
||
|
|
*USE, *CHANGE, *EXCLUDE, *ALL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDDLOAUT.AUTL"><b>AUTL</b></a></td>
|
||
|
|
<td valign="top">Authorization list</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDDLOAUT.ACC"><b>ACC</b></a></td>
|
||
|
|
<td valign="top">Document access code</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): 0-2047</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDDLOAUT.SYSOBJNAM"><b>SYSOBJNAM</b></a></td>
|
||
|
|
<td valign="top">System object name</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ADDDLOAUT.DLO"></a>
|
||
|
|
<h3>Document library object (DLO)</h3>
|
||
|
|
<p>Specifies the name of the document or folder to which authority is added.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Authority is added to all objects in the specified folder. If *ALL is specified, a value must be specified on the <b>Folder (FLR)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSOBJNAM</b></dt>
|
||
|
|
<dd>A system object name is used to identify the folder or document to which authority is added. You will be requested to enter the name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-assigned name of the document or folder using a maximum of 12 characters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDDLOAUT.FLR"></a>
|
||
|
|
<h3>Folder (FLR)</h3>
|
||
|
|
<p>Specifies the folder where the object specified for the <b>Document library object (DLO)</b> parameter is located.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>A folder name is not specified. *NONE cannot be specified if either:
|
||
|
|
<ul>
|
||
|
|
<li>A document or folder name is specified on the <b>Document library object (DLO)</b> parameter and the object is located in a folder
|
||
|
|
</li>
|
||
|
|
<li>*ALL is specified on the <b>Document library object (DLO)</b> parameter
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-assigned name of the folder. The folder name can consist of a series of folder names if the object specified on the <b>Document library object (DLO)</b> parameter is located in a folder that is contained in another folder. A maximum of 63 characters can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDDLOAUT.USRAUT"></a>
|
||
|
|
<h3>User authority (USRAUT)</h3>
|
||
|
|
<p>Specifies the name of a specific user and the user's authority.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No additional user's authority is added.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the user profile for whom specific authority is added.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CHANGE</b></dt>
|
||
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USE</b></dt>
|
||
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDDLOAUT.AUTL"></a>
|
||
|
|
<h3>Authorization list (AUTL)</h3>
|
||
|
|
<p>Specifies the name of the authorization list, if any, used to secure the document or folder specified on the <b>Document library object (DLO)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>An authorization list is not specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of a predefined authorization list.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDDLOAUT.ACC"></a>
|
||
|
|
<h3>Document access code (ACC)</h3>
|
||
|
|
<p>Specifies the access codes that are added. The access code must be defined to the system before it can be used. An access code of zero (0) allows all users use (*USE) authority for the object. Access code zero (0) cannot be assigned to an object if the security level is personal.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No access code is added.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-2047</i></b></dt>
|
||
|
|
<dd>Specify the access code assigned to the object. All access codes except 0 must be predefined to the system using the Add Access Code (ADDACC) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDDLOAUT.SYSOBJNAM"></a>
|
||
|
|
<h3>System object name (SYSOBJNAM)</h3>
|
||
|
|
<p>Specifies the system object name of the document or folder. If a document or folder name or *ALL is specified on the <b>Document library object (DLO)</b> parameter, this parameter is ignored, and a folder name is required.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the system object name of the document or folder using the entire 10 characters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDDLOAUT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDDLOAUT DLO(*ALL) USER(MIKE (*CHANGE)) AUTL(*NONE)
|
||
|
|
FLR(MYFLR) ACC(1023)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command adds *CHANGE authority for user MIKE to all objects in the folder MYFLR. An access code of 1023 was also added to the object.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDDLOAUT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF8A75</b></dt>
|
||
|
|
<dd>Not authorized to access folder &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A77</b></dt>
|
||
|
|
<dd>Folder &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A78</b></dt>
|
||
|
|
<dd>Folder &1 in use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A79</b></dt>
|
||
|
|
<dd>Folder &1 is logically damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A80</b></dt>
|
||
|
|
<dd>Document &2 in use in folder &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A82</b></dt>
|
||
|
|
<dd>Document &2 not found in folder &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A83</b></dt>
|
||
|
|
<dd>Not authorized to access document &2 in folder &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A88</b></dt>
|
||
|
|
<dd>Operation not allowed on document &2 in folder &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF8A89</b></dt>
|
||
|
|
<dd>Document &2 in folder &1 is logically damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF90BA</b></dt>
|
||
|
|
<dd>Authority request for document library object failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF901F</b></dt>
|
||
|
|
<dd>*AUTL was specified for a user other than *PUBLIC.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9073</b></dt>
|
||
|
|
<dd>No authority to view or change the security of document library object &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF908A</b></dt>
|
||
|
|
<dd>Requester &1 not enrolled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF908B</b></dt>
|
||
|
|
<dd>Document library object not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF908E</b></dt>
|
||
|
|
<dd>&1 objects changed; &2 objects not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF909A</b></dt>
|
||
|
|
<dd>Document &2 in folder &1 is damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9095</b></dt>
|
||
|
|
<dd>Folder &1 is damaged.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDDLOAUT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|