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

243 lines
8.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>Display DLO Authority (DSPDLOAUT)</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="DSPDLOAUT.Top_Of_Page"></a>
<h2>Display DLO Authority (DSPDLOAUT)</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="#DSPDLOAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPDLOAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPDLOAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPDLOAUT"></a>
<p>The Display Document Library Object Authority (DSPDLOAUT) command allows you to view (only) the list of authorized users of an object and their assigned authorities.
</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 primary group (if there is one)
</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>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 user group has no authority for the document or folder
</li>
</ul>
<p><b>Restrictions:</b>
</p>
<ul>
<li>A user must have at least use (*USE) authority for the document or folder to display authority information about the document or folder.
</li>
<li>If the user has all (*ALL) authority to the object, or all object (*ALLOBJ) special authority, the user sees all authority information.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPDLOAUT.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="#DSPDLOAUT.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="#DSPDLOAUT.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="#DSPDLOAUT.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLOAUT.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="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPDLOAUT.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the name of the document or folder to be displayed.
</p>
<dl>
<dt><b>*SYSOBJNAM</b></dt>
<dd>The system object name specified on the <b>System object name (SYSOBJNAM)</b> parameter is displayed.
</dd>
<dt><b>*ROOT</b></dt>
<dd>The public authority value of the *ROOT folder is displayed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-assigned name of the document or folder to be displayed. A maximum of 12 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLOAUT.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 here.
</dd>
<dt><b><i>name</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="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLOAUT.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed at the requesting work station if requested by an interactive job. If this is not an interactive job, the output is printed with the job's spooled output.
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLOAUT.SYSOBJNAM"></a>
<h3>System object name (SYSOBJNAM)</h3>
<p>Specifies the system object name of the folder or document.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the system object name for the folder or document displayed. Ten characters must be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDLOAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPDLOAUT DLO(DOCA) FLR(MYFLR) OUTPUT(*PRINT)
</pre>
</p>
<p>This command prints for DOCA in folder MYFLR a list of all authorized users and their authorities if the user of this command has *ALL authority to DOCA in folder MYFLR. This command prints only the user's authorities if the user of this command has *USE authority. Access codes are also shown.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDLOAUT.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>CPF9009</b></dt>
<dd>System requires file &amp;1 in &amp;2 be journaled.
</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>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9850</b></dt>
<dd>Override of printer file &amp;1 not allowed.
</dd>
<dt><b>CPF9851</b></dt>
<dd>Overflow value for file &amp;1 in &amp;2 too small.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLOAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>