264 lines
9.1 KiB
HTML
264 lines
9.1 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>Change DLO Owner (CHGDLOOWN)</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="CHGDLOOWN.Top_Of_Page"></a>
|
|
<h2>Change DLO Owner (CHGDLOOWN)</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="#CHGDLOOWN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGDLOOWN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGDLOOWN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGDLOOWN"></a>
|
|
<p>The Change Document Library Object Owner (CHGDLOOWN) command allows you to transfer document or folder ownership from one user to another user. The first owner no longer owns the object and the second user becomes the owner. The new owner must be enrolled in the system distribution directory. The authorities of other users to the document or folder do not change.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<p>To transfer ownership of a document or folder, all object (*ALLOBJ) special authority is required or the requester must be the owner of the document or folder.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGDLOOWN.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="#CHGDLOOWN.DLO"><b>DLO</b></a></td>
|
|
<td valign="top">Document library object, or</td>
|
|
<td valign="top"><i>Character value</i>, *SYSOBJNAM</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="2"><a href="#CHGDLOOWN.OWNER"><b>OWNER</b></a></td>
|
|
<td valign="top">Current owner</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="2">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: User profile</td>
|
|
<td valign="top">
|
|
<i>Name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="2"><a href="#CHGDLOOWN.NEWOWN"><b>NEWOWN</b></a></td>
|
|
<td valign="top">New owner</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="2">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: User profile</td>
|
|
<td valign="top">
|
|
<i>Name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOOWN.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="#CHGDLOOWN.CUROWNAUT"><b>CUROWNAUT</b></a></td>
|
|
<td valign="top">Current owner authority</td>
|
|
<td valign="top"><b><u>*REVOKE</u></b>, *SAME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOOWN.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="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGDLOOWN.DLO"></a>
|
|
<h3>Document library object, or (DLO)</h3>
|
|
<p>Specifies the name of the document or folder object that is assigned to a new owner. When the <b>Current owner (OWNER)</b> parameter is specified, the DLO parameter cannot be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the document or folder assigned by the user. A maximum of 12 characters can be specified.
|
|
</dd>
|
|
<dt><b>*SYSOBJNAM</b></dt>
|
|
<dd>The object is identified using the system object name. The object name is specified on the <b>System object name (SYSOBJNAM)</b> parameter. If *SYSOBJNAM is specified, then FLR(*NONE) must also be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOOWN.OWNER"></a>
|
|
<h3>Current owner (OWNER)</h3>
|
|
<p>Specifies the user profile name of the current owner from whom all documents or folders are transferred. All documents or folders owned by this user are assigned a new owner. When the <b>Document library object, or (DLO)</b> parameter is specified, the <b>Current owner (OWNER)</b> parameter cannot be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the user profile by which the current owner is known on the system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOOWN.NEWOWN"></a>
|
|
<h3>New owner (NEWOWN)</h3>
|
|
<p>Specifies the user profile of the new owner to whom the documents or folders are transferred.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the user profile by which the new owner is known on the system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOOWN.FLR"></a>
|
|
<h3>Folder (FLR)</h3>
|
|
<p>Specifies the name of the folder where objects identified on the <b>Document library object, or (DLO)</b> parameter are located.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No folder name is 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="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOOWN.CUROWNAUT"></a>
|
|
<h3>Current owner authority (CUROWNAUT)</h3>
|
|
<p>Specifies whether the authorities for the current owner are revoked when ownership is changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REVOKE</u></b></dt>
|
|
<dd>The authority of the current owner is revoked when the object is changed to the new owner.
|
|
</dd>
|
|
<dt><b>*SAME</b></dt>
|
|
<dd>The authority of the current owner is not changed when the object is changed to the new owner.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOOWN.SYSOBJNAM"></a>
|
|
<h3>System object name (SYSOBJNAM)</h3>
|
|
<p>Specifies the system object name of the document or folder. This parameter is ignored if an object name is specified on the <b>Document library object, or (DLO)</b> parameter.
|
|
</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="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDLOOWN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Transferring Folder Ownership</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGDLOOWN DLO(MYFLR) NEWOWN(ANN)
|
|
</pre>
|
|
</p>
|
|
<p>This command assigns ownership of folder MYFLR to a new owner named ANN. The authority is revoked from the current owner.
|
|
</p>
|
|
<p><b>Example 2: Transferring Ownership of All Documents and Folders</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGDLOOWN OWNER(ANDERSON) NEWOWN(SMITH)
|
|
</pre>
|
|
</p>
|
|
<p>This command assigns ownership of all documents and folders owned by ANDERSON to the new owner SMITH. The authority is revoked from the current owner.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDLOOWN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2204</b></dt>
|
|
<dd>User profile &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2232</b></dt>
|
|
<dd>Not authorized to user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2233</b></dt>
|
|
<dd>No delete authority to user profile &1.
|
|
</dd>
|
|
<dt><b>CPF8A49</b></dt>
|
|
<dd>New owner &1 does not have a uid.
|
|
</dd>
|
|
<dt><b>CPF8360</b></dt>
|
|
<dd>Not enough storage for commitment control operation.
|
|
</dd>
|
|
<dt><b>CPF897E</b></dt>
|
|
<dd>Name &1 already exists for document list owned by &2 &3.
|
|
</dd>
|
|
<dt><b>CPF9005</b></dt>
|
|
<dd>System resource required to complete this request not available.
|
|
</dd>
|
|
<dt><b>CPF9006</b></dt>
|
|
<dd>User not enrolled in system distribution directory.
|
|
</dd>
|
|
<dt><b>CPF9009</b></dt>
|
|
<dd>System requires file &1 in &2 be journaled.
|
|
</dd>
|
|
<dt><b>CPF9012</b></dt>
|
|
<dd>Start of document interchange session not successful for &1.
|
|
</dd>
|
|
<dt><b>CPF9029</b></dt>
|
|
<dd>Not allowed to specify owner profile &1.
|
|
</dd>
|
|
<dt><b>CPF9032</b></dt>
|
|
<dd>Document interchange session not started.
|
|
</dd>
|
|
<dt><b>CPF9048</b></dt>
|
|
<dd>Ownership of &2 document library objects changed to profile &1; &3 not changed.
|
|
</dd>
|
|
<dt><b>CPF908A</b></dt>
|
|
<dd>Requester &1 not enrolled.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|