255 lines
9.9 KiB
HTML
255 lines
9.9 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 Primary Group (CHGDLOPGP)</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="CHGDLOPGP.Top_Of_Page"></a>
|
|
<h2>Change DLO Primary Group (CHGDLOPGP)</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="#CHGDLOPGP.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGDLOPGP.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGDLOPGP.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGDLOPGP"></a>
|
|
<p>The Change Document Library Object Primary Group (CHGDLOPGP) command transfers documents or folders from one primary group to another primary group. The second group profile becomes the primary group. The new primary group must be in the system distribution directory. The authorities that other users have to the document or folder are not changed.
|
|
</p>
|
|
<p>The old primary group's authority to the object is revoked unless *NO is specified for the <b>Revoke old authority (RVKOLDAUT)</b> parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The system does not determine document or folder primary group by checking a group profile if one is specified in the user profile.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<p>To transfer the primary group of a document or folder, the user must have all object (*ALLOBJ) special authority or be the owner of the document or folder. The user must have delete authority (*DLT) to the old primary group profile and add (*ADD) authority to the new primary group profile.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGDLOPGP.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="#CHGDLOPGP.DLO"><b>DLO</b></a></td>
|
|
<td valign="top">Document library object, or</td>
|
|
<td valign="top"><i>Character value</i>, *SYSOBJNAM, *ALL</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOPGP.CURPGP"><b>CURPGP</b></a></td>
|
|
<td valign="top">Current primary group</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOPGP.NEWPGP"><b>NEWPGP</b></a></td>
|
|
<td valign="top">New primary group</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOPGP.NEWPGPAUT"><b>NEWPGPAUT</b></a></td>
|
|
<td valign="top">New primary group authority</td>
|
|
<td valign="top"><b><u>*OLDPGP</u></b>, *PRIVATE, *ALL, *CHANGE, *USE, *EXCLUDE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOPGP.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="#CHGDLOPGP.RVKOLDAUT"><b>RVKOLDAUT</b></a></td>
|
|
<td valign="top">Revoke old authority</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDLOPGP.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="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGDLOPGP.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 primary group. The DLO parameter and the <b>Current primary group (CURPGP)</b> parameter are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SYSOBJNAM</b></dt>
|
|
<dd>The object is identified using the system object name. Object name is specified by the <b>System object name (SYSOBJNAM)</b> parameter.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The objects specified by FLR have their primary group changed. The folder, its contents, as well as the contents of all of its subfolders, will have their primary group changed.
|
|
<p>If *ALL is specified, a value must be specified on the <b>Folder (FLR)</b> parameter.
|
|
</p>
|
|
</dd>
|
|
<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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOPGP.CURPGP"></a>
|
|
<h3>Current primary group (CURPGP)</h3>
|
|
<p>Specifies the primary group profile name of the current primary group from whom all documents or folders are transferred. All documents or folders assigned to this primary group are assigned a new primary group. The CURPGP parameter and the <b>Document library object, or (DLO)</b> parameter are mutually exclusive.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOPGP.NEWPGP"></a>
|
|
<h3>New primary group (NEWPGP)</h3>
|
|
<p>Specifies the primary group profile name of the new primary group to which the documents or folders are being transferred. The group profile must already exist and have a group ID number (gid) assigned to it.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The object does not have a primary group.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the new primary group name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOPGP.NEWPGPAUT"></a>
|
|
<h3>New primary group authority (NEWPGPAUT)</h3>
|
|
<p>Specifies what authority the new primary group has to the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OLDPGP</u></b></dt>
|
|
<dd>The new primary group has whatever authority the old primary group had to the object.
|
|
</dd>
|
|
<dt><b>*PRIVATE</b></dt>
|
|
<dd>The new primary group has the same private authority to the object. If the old primary group did not have a private authority to the object, the new primary group has no authority to the object.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The new primary group is given all (*ALL) authority to the object.
|
|
</dd>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>The new primary group is given change (*CHANGE) authority to the object.
|
|
</dd>
|
|
<dt><b>*USE</b></dt>
|
|
<dd>The new primary group is given use (*USE) authority to the object.
|
|
</dd>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The new primary group is given exclude (*EXCLUDE) authority to the object.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOPGP.FLR"></a>
|
|
<h3>Folder (FLR)</h3>
|
|
<p>Specifies the name of the folder that contains the document.
|
|
</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 specified in the DLO parameter 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="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOPGP.RVKOLDAUT"></a>
|
|
<h3>Revoke old authority (RVKOLDAUT)</h3>
|
|
<p>Specifies whether the current primary group's authority is revoked when the primary group is transferred to the new primary group specified on the NEWPGP parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The current primary group's authority is revoked when the object is transferred to the new primary group.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The authority for the current primary group is not revoked when the primary group is changed to the new primary group.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDLOPGP.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 DLO(*SYSOBJNAM) is specified. A full ten characters must be specified.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDLOPGP.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Transferring Folder Primary Group</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGDLOPGP DLO(MYFLR) NEWPGP(GROUP1)
|
|
</pre>
|
|
</p>
|
|
<p>This command assigns primary group of folder MYFLR to a new primary group named GROUP1. The authority is revoked from the current primary group.
|
|
</p>
|
|
<p><b>Example 2: Transferring Primary Group of All Documents and Folders</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGDLOPGP CURPGP(GROUP1) NEWPGP(GROUP2)
|
|
</pre>
|
|
</p>
|
|
<p>This command assigns a new primary group for all documents and folders assigned to primary group GROUP1 to the new primary group GROUP2. The authority is revoked from current primary group.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDLOPGP.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>CPF89C1</b></dt>
|
|
<dd>Primary group of &2 document library objects changed to primary group &1; &3 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDLOPGP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|