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

223 lines
7.6 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 DLO Authority (EDTDLOAUT)</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="EDTDLOAUT.Top_Of_Page"></a>
<h2>Edit DLO Authority (EDTDLOAUT)</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="#EDTDLOAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#EDTDLOAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#EDTDLOAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="EDTDLOAUT"></a>
<p>The Edit Document Library Object Authority (EDTDLOAUT) command is used to change user authorization to a document or folder object.
</p>
<p>The following information is displayed for the specified document or folder:
</p>
<ul>
<li>The name of the document or folder
</li>
<li>The owner of the document or folder
</li>
<li>The name of the authorization list securing the document or folder (if there is one)
</li>
<li>Personal status of the document or folder
</li>
<li>A list of specific users authorized for the document or folder
</li>
<li>The authority given to the users with no specific authority (*PUBLIC), who are not on the authorization list, and whose group has no authority for the document or folder
</li>
</ul>
<p><b>Restrictions:</b>
</p>
<ol>
<li>A user must have all (*ALL) authority to the document or folder or all object (*ALLOBJ) special authority to change the authority.
</li>
<li>You must have authority to use the Add DLO Authority (ADDDLOAUT), Change DLO Authority (CHGDLOAUT) , and the Remove DLO Authority (RMVDLOAUT) commands to use this command.
</li>
<li>The user must have *ALLOBJ special authority to change the *ROOT folder public authority.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="EDTDLOAUT.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="#EDTDLOAUT.DLO"><b>DLO</b></a></td>
<td valign="top">Document library object</td>
<td valign="top"><i>Character value</i>, *SYSOBJNAM, *ROOT</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#EDTDLOAUT.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"><a href="#EDTDLOAUT.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="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="EDTDLOAUT.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the name of the document or folder for which user authority is being changed.
</p>
<dl>
<dt><b>*SYSOBJNAM</b></dt>
<dd>User authority is being changed for the document or folder with the system object name specified on the <b>System object name (SYSOBJNAM)</b> parameter.
</dd>
<dt><b>*ROOT</b></dt>
<dd>The public authority value of the *ROOT folder is changed.
</dd>
<dt><b><i>character</i></b></dt>
<dd>Specify the user-assigned name of the document or folder for which user authority is being changed. A maximum of 12 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EDTDLOAUT.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. If a name is specified on the DLO parameter, and the object is located in a folder, *NONE cannot be specified.
</dd>
<dt><b><i>character</i></b></dt>
<dd>Specify the name of the folder that contains the object. The name can consist of a series of folder names if the folder containing the object is located in another folder. A maximum of 63 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="EDTDLOAUT.SYSOBJNAM"></a>
<h3>System object name (SYSOBJNAM)</h3>
<p>Specifies the system object name of the folder or document. 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 for the folder or document for which user authority is being changed. You must specify 10 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="EDTDLOAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
EDTDLOAUT DLO(DOCA) FLR(MYFLR)
</pre>
</p>
<p>This command allows the user of this command to change the list of authorized users and their authorities to the document library object named DOCA in folder MYFLR. The user of this command must have *ALL authority to the object or be the owner of the object.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="EDTDLOAUT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>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>CPF89C0</b></dt>
<dd>You have specified an incorrect value.
</dd>
<dt><b>CPF90BA</b></dt>
<dd>Authority request for document library object failed.
</dd>
<dt><b>CPF90B6</b></dt>
<dd>You have specified an incorrect input value.
</dd>
<dt><b>CPF9073</b></dt>
<dd>No authority to view or change the security of document library object &amp;1.
</dd>
<dt><b>CPF9079</b></dt>
<dd>Request to get document description not successful for user profile &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>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>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#EDTDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>