281 lines
10 KiB
HTML
281 lines
10 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>Check Document Library Object (CHKDLO)</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="CHKDLO.Top_Of_Page"></a>
|
|
<h2>Check Document Library Object (CHKDLO)</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="#CHKDLO.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHKDLO.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHKDLO.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHKDLO"></a>
|
|
<p>The Check Document Library Object (CHKDLO) command verifies that an object exists and that a user has authority to the object before trying to access it.
|
|
</p>
|
|
<p>These checks can be particularly useful before the user tries to access several objects simultaneously. The CHKDLO command is also used to check the validity of object names contained in CL variables and to verify object authorizations under program control.
|
|
</p>
|
|
<p>When the command runs, the system searches for the specified object. If the object is found, the system verifies that the user is authorized to that object as specified on the CHKDLO command. If the object is not found or the user does not have the authority specified on the CHKDLO command, an escape message is sent to the user.
|
|
</p>
|
|
<p>When the CHKDLO command is used in a CL program, the Monitor Message (MONMSG) command follows the CHKDLO command to monitor for messages that result from running this command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHKDLO.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="#CHKDLO.DLO"><b>DLO</b></a></td>
|
|
<td valign="top">Document library object</td>
|
|
<td valign="top"><i>Character value</i>, *SYSOBJNAM</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHKDLO.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, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHKDLO.SYSOBJNAM"><b>SYSOBJNAM</b></a></td>
|
|
<td valign="top">System object name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHKDLO.OBJTYPE"><b>OBJTYPE</b></a></td>
|
|
<td valign="top">Object type</td>
|
|
<td valign="top"><b><u>*ANY</u></b>, *DOC, *FLR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHKDLO.AUT"><b>AUT</b></a></td>
|
|
<td valign="top">Authority</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL, *CHANGE, *USE, *EXCLUDE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHKDLO.USRID"><b>USRID</b></a></td>
|
|
<td valign="top">User identifier</td>
|
|
<td valign="top">Single values: <b><u>*CURRENT</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: User ID</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Address</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHKDLO.DLO"></a>
|
|
<h3>Document library object (DLO)</h3>
|
|
<p>Specifies the document library object that is checked.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library document or folder that is checked.
|
|
</dd>
|
|
<dt><b>*SYSOBJNAM</b></dt>
|
|
<dd>The system object name is used to identify the document or folder that is checked. This parameter must be used to check a document that is not in a folder and may be used instead of a folder name or document name when the system object name is known. The SYSOBJNAM parameter and DLO(*SYSOBJNAM) must be specified together.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHKDLO.FLR"></a>
|
|
<h3>Folder (FLR)</h3>
|
|
<p>Specifies the name of the folder containing the document or folder being checked.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The object that is checked is not contained in a folder.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the folder that contains the document or folder that is checked. A folder name can be specified only if a folder or document name is specified on the DLO parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHKDLO.SYSOBJNAM"></a>
|
|
<h3>System object name (SYSOBJNAM)</h3>
|
|
<p>Specifies the system object name of the object that is checked.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the system object name of the document or folder that is checked. A system object name must be specified if DLO(*SYSOBJNAM) is specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHKDLO.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies the type of Document Library Object being checked. OBJTYPE(*DOC) cannot be specified when a document or a folder name is specified on the DLO parameter and FLR(*NONE) is also specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ANY</u></b></dt>
|
|
<dd>The object that is checked can be either a document or a folder.
|
|
</dd>
|
|
<dt><b>*DOC</b></dt>
|
|
<dd>The object that is checked is a document.
|
|
</dd>
|
|
<dt><b>*FLR</b></dt>
|
|
<dd>The object that is checked is a folder.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHKDLO.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies the type or kind of authority that is checked.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Authority is not checked.
|
|
</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>
|
|
</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>
|
|
</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>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The user cannot access the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHKDLO.USRID"></a>
|
|
<h3>User identifier (USRID)</h3>
|
|
<p>Specifies the user ID and address of the user for whom the object is being checked. If a user ID and address of someone other than the user who is signed on is specified, the user must have all object (*ALLOBJ) special authority or both users must be enrolled in the system directory and the user who is signed on must be granted permission (using the GRTUSRPMN command) to work on behalf of the specified user. Specifies the user ID and address of the user checking the object.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The object is checked on the behalf of the user who is signed on the system. The user must be enrolled in the system directory or have *ALLOBJ special authority.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: User ID</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>user-ID</i></b></dt>
|
|
<dd>Specify the user ID of the user on whose behalf the object is checked.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>address</i></b></dt>
|
|
<dd>Specify the address of the user on whose behalf the object is checked.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>If a user ID and address for someone other than the user who is signed on the system is specified, the user must have *ALLOBJ special authority, or both users must be enrolled in the system directory and the user who is signed on the system must be granted permission (by using the GRTUSRPMN command) to work on behalf of the specified user. This parameter is useful only when an AUT value other than *NONE is specified.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHKDLO.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHKDLO DLO(FLR1) OBJTYPE(*ANY) AUT(*NONE)
|
|
USERID(USER1 ADDR1)
|
|
</pre>
|
|
</p>
|
|
<p>This command checks for the existence of a folder named FLR1 on behalf of a user whose user ID is USER1 and whose address is ADDR1. The user's authority to FLR1 is not checked.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHKDLO.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8A11</b></dt>
|
|
<dd>CHKDLO command failed.
|
|
</dd>
|
|
<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>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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHKDLO.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|