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

431 lines
16 KiB
HTML
Raw Permalink 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>Change DLO Authority (CHGDLOAUT)</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="CHGDLOAUT.Top_Of_Page"></a>
<h2>Change DLO Authority (CHGDLOAUT)</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="#CHGDLOAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGDLOAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGDLOAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGDLOAUT"></a>
<p>The Change Document Library Object Authority (CHGDLOAUT) command allows you to change an existing user's authority to a document or folder. With this command, you can:
</p>
<ul>
<li>Change an existing user's specific authority
</li>
<li>Change authority for users with no specific authority (*PUBLIC)
</li>
<li>Change the authorization list that specifies the object's security
</li>
<li>Change the existing security level, or change the security to that of a reference object.
</li>
</ul>
<p><b>Restrictions:</b>
</p>
<p>You must have all (*ALL) authority to the object, all object (*ALLOBJ) special authority, or be the owner of the object.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDLOAUT.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="#CHGDLOAUT.DLO"><b>DLO</b></a></td>
<td valign="top">Document library object</td>
<td valign="top"><i>Character value</i>, *ALL, *SYSOBJNAM, *ROOT</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDLOAUT.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="#CHGDLOAUT.USRAUT"><b>USRAUT</b></a></td>
<td valign="top">User authority</td>
<td valign="top">Single values: <b><u>*SAME</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>, *PUBLIC</td>
</tr>
<tr>
<td valign="top">Element 2: Authority level</td>
<td valign="top">
*USE, *CHANGE, *EXCLUDE, *ALL, *AUTL</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDLOAUT.AUTL"><b>AUTL</b></a></td>
<td valign="top">Authorization list</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDLOAUT.SENSITIV"><b>SENSITIV</b></a></td>
<td valign="top">Sensitivity</td>
<td valign="top"><b><u>*SAME</u></b>, *NONE, *PERSONAL, *PRIVATE, *CONFIDENTIAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDLOAUT.REFDLO"><b>REFDLO</b></a></td>
<td valign="top">Reference DLO</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *REFSYSOBJ</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDLOAUT.REFFLR"><b>REFFLR</b></a></td>
<td valign="top">Reference 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"><a href="#CHGDLOAUT.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>
<tr>
<td valign="top"><a href="#CHGDLOAUT.REFSYSOBJ"><b>REFSYSOBJ</b></a></td>
<td valign="top">Reference system object</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDLOAUT.PERSONAL"><b>PERSONAL</b></a></td>
<td valign="top">Personal</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGDLOAUT.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the name of the document or folder for which user authority is changed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>User authority is changed for 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>The system object name specified on the <b>System object name (SYSOBJNAM)</b> parameter has user authority changed.
</dd>
<dt><b>*ROOT</b></dt>
<dd>The public authority value of the *ROOT folder is changed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-assigned name of the document or folder object. A maximum of 12 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.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.
</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 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="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.USRAUT"></a>
<h3>User authority (USRAUT)</h3>
<p>Specifies the name of an existing user and the new user authority level.
</p>
<p>When USRAUT((*PUBLIC *CHANGE)) is specified, all users can create first-level folders in the *ROOT folder. When USRAUT((*PUBLIC *USE)) is specified, only users with all object (*ALLOBJ) or security administrator (*SECADM) special authority can create first-level folders. Folder creation is the only function controlled by these values. Public authority is the only security value that can be specified for the *ROOT folder. Only change (*CHANGE) and use (*USE) public authorities can be specified for the *ROOT folder.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>Existing user authority does not change.
</dd>
</dl>
<p><b>Element 1: User profile</b>
</p>
<dl>
<dt><b>*PUBLIC</b></dt>
<dd>Users with no specific authority and who are not on the authorization list have their authority changed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile whose specific authority is changed.
</dd>
</dl>
<p><b>Element 2: Authority level</b>
</p>
<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>
<dl>
<dt><b>*AUTL</b></dt>
<dd>The authority of the authorization list specified on the <b>Authorization list (AUTL)</b> parameter is used for the document. The *AUTL value is valid only if *PUBLIC is also specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.AUTL"></a>
<h3>Authorization list (AUTL)</h3>
<p>Specifies whether the existing authorization list is replaced by a different authorization list or removed from the document library object.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The authorization list does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>The document library object will no longer be secured by an authorization list. If the public authority to the document library object is *AUTL, it is changed to *EXCLUDE.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the new authorization list whose authority determines the object's security.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.SENSITIV"></a>
<h3>Sensitivity (SENSITIV)</h3>
<p>Specifies one of four levels of sensitivity as defined by the X.400 standard. The four levels include no sensitivity, personal, private and company confidential. Any document marked as private is still available to users who are normally authorized to it, but is unavailable to users who are working on your behalf (even though it may be available to them when they are not working on your behalf).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>The document has no sensitivity restrictions.
</dd>
<dt><b>*PERSONAL</b></dt>
<dd>The document is intended for the user as an individual.
</dd>
<dt><b>*PRIVATE</b></dt>
<dd>The document contains information that should be accessed only by the owner. This value cannot be specified if the access code zero (0) is assigned to the object.
</dd>
<dt><b>*CONFIDENTIAL</b></dt>
<dd>The document contains information that should be handled according to company procedures.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.REFDLO"></a>
<h3>Reference DLO (REFDLO)</h3>
<p>Specifies that the user authorities to the existing document or folder are replaced by user authorities to the referred to document library object including specific authorities, authority given to users with no specific authorities, authorization list authority, access codes, and personal status.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A referred to object name is not specified.
</dd>
<dt><b>*REFSYSOBJ</b></dt>
<dd>A referred to object is specified on the <b>Reference system object (REFSYSOBJ)</b> parameter. This is the system object name of a document or folder.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the document or folder that is referred to.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.REFFLR"></a>
<h3>Reference folder (REFFLR)</h3>
<p>Specifies the folder in which the referred to object specified on the <b>Reference DLO (REFDLO)</b> parameter is located.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A folder name is not specified.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-specified name of the referred to folder. The folder name can consist of a series of folder names if the object is located in a folder that is contained in another folder.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.SYSOBJNAM"></a>
<h3>System object name (SYSOBJNAM)</h3>
<p>Specifies the system object name of the document or folder. This parameter is valid only when *SYSOBJNAM is specified on the <b>Document library object (DLO)</b> parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the system object name of the document or folder using 10 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.REFSYSOBJ"></a>
<h3>Reference system object (REFSYSOBJ)</h3>
<p>Specifies the system object name of the referred to document library object.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the system object name of the referred to document library object using the entire 10 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDLOAUT.PERSONAL"></a>
<h3>Personal (PERSONAL)</h3>
<p>Specifies whether the document being changed is a personal document. If it is, only the owner or an authorized user can access it. Any document marked as private is still available to users who are normally authorized to it, but is unavailable to users who are working on your behalf (even though it may be available to them when they are not working on your behalf). This parameter is replaced by SENSITIV but the PERSONAL parameter can still be used. However, because this parameter may be removed in a later release, whenever possible use the SENSITIV parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>Access is allowed when a user is working on behalf of another. This value will map to SENSITIV(*NONE).
</dd>
<dt><b>*YES</b></dt>
<dd>Access is not allowed when a user is working on behalf of another. PERSONAL(*YES) requires that USER(*PUBLIC) be *EXCLUDE. This value cannot be specified if the access code zero (0) is assigned to the object. This value will map to SENSITIV(*PRIVATE).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDLOAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGDLOAUT DLO(MYDOC) FLR(MYFLR) USRAUT((*PUBLIC *AUTL))
AUTL(MYAUTL)
</pre>
</p>
<p>This command changes the authority of user *PUBLIC for document MYDOC in folder MYFLR. The authority specified on the authorization list for public (users with no specific authority for MYDOC, who are not on the authorization list MYAUTL, and whose user's group has no specific authority to MYDOC) is used to determine the public authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDLOAUT.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 &amp;1.
</dd>
<dt><b>CPF8A77</b></dt>
<dd>Folder &amp;1 not found.
</dd>
<dt><b>CPF8A78</b></dt>
<dd>Folder &amp;1 in use.
</dd>
<dt><b>CPF8A79</b></dt>
<dd>Folder &amp;1 is logically damaged.
</dd>
<dt><b>CPF8A80</b></dt>
<dd>Document &amp;2 in use in folder &amp;1.
</dd>
<dt><b>CPF8A82</b></dt>
<dd>Document &amp;2 not found in folder &amp;1.
</dd>
<dt><b>CPF8A83</b></dt>
<dd>Not authorized to access document &amp;2 in folder &amp;1.
</dd>
<dt><b>CPF8A88</b></dt>
<dd>Operation not allowed on document &amp;2 in folder &amp;1.
</dd>
<dt><b>CPF8A89</b></dt>
<dd>Document &amp;2 in folder &amp;1 is logically damaged.
</dd>
<dt><b>CPF90BA</b></dt>
<dd>Authority request for document library object failed.
</dd>
<dt><b>CPF90B8</b></dt>
<dd>No authority to specify a reference object for document library object &amp;1.
</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 &amp;1.
</dd>
<dt><b>CPF908A</b></dt>
<dd>Requester &amp;1 not enrolled.
</dd>
<dt><b>CPF908B</b></dt>
<dd>Document library object not found.
</dd>
<dt><b>CPF908E</b></dt>
<dd>&amp;1 objects changed; &amp;2 objects not changed.
</dd>
<dt><b>CPF909A</b></dt>
<dd>Document &amp;2 in folder &amp;1 is damaged.
</dd>
<dt><b>CPF9095</b></dt>
<dd>Folder &amp;1 is damaged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>