263 lines
10 KiB
HTML
263 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>Rename Directory Entry (RNMDIRE)</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="RNMDIRE.Top_Of_Page"></a>
|
|
<h2>Rename Directory Entry (RNMDIRE)</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="#RNMDIRE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RNMDIRE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RNMDIRE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RNMDIRE"></a>
|
|
<p>The Rename Directory Entry (RNMDIRE) command renames a local or remote user identifier (ID) and user address to a new user ID and user address. A rename operation is not allowed for generic (*ANY) user IDs or default directory entries (QSYS, QDFTOWN, QLPAUTO, QLPINSTL). This command renames all occurrences of the specified user ID and address in all IBM-supplied files.
|
|
</p>
|
|
<p>It is recommended that this job be scheduled during low-use periods using the Submit Job (SBMJOB) command.
|
|
</p>
|
|
<p>Only one rename operation can be run on the system at one time. If the rename is submitted to batch, the job waits for an active rename to complete.
|
|
</p>
|
|
<p><b>Restriction:</b> You must have administrator (*SECADM) or all object (*ALLOBJ) authority to rename the user ID and user address.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RNMDIRE.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" rowspan="3"><a href="#RNMDIRE.OLDUSRID"><b>OLDUSRID</b></a></td>
|
|
<td valign="top">Old user identifier</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Key, Positional 1</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>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RNMDIRE.NEWUSRID"><b>NEWUSRID</b></a></td>
|
|
<td valign="top">New user identifier</td>
|
|
<td valign="top">Single values: *BACKOUT<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</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>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RNMDIRE.FWDFRM"><b>FWDFRM</b></a></td>
|
|
<td valign="top">Forward from user identifier</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *OLDUSRID<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>
|
|
<tr>
|
|
<td valign="top"><a href="#RNMDIRE.NETUSRID"><b>NETUSRID</b></a></td>
|
|
<td valign="top">Change network user identifier</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NEWUSRID</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RNMDIRE.OLDUSRID"></a>
|
|
<h3>Old user identifier (OLDUSRID)</h3>
|
|
<p>Specifies the user ID and address of the directory entry being renamed. Both elements must be specified. If lowercase characters are specified, the system stores them as uppercase characters. More information about specifying the user ID and address is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Element 1: User ID</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the current user ID for the directory entry. A maximum of 8 characters can be specified. If this value is specified, an address must be specified on Element 2.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the current address for the directory entry. A maximum of 8 characters can be specified. If this value is specified, a user ID must be specified on Element 1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RNMDIRE.NEWUSRID"></a>
|
|
<h3>New user identifier (NEWUSRID)</h3>
|
|
<p>Specifies the user ID and address to which the old user ID and address is being renamed. Both elements must be specified but only one element needs to be different from the user ID and address specified on the OLDUSRID parameter.
|
|
</p>
|
|
<p>The new user ID and address specified cannot be an existing user ID and address or exist as a forward-from value in the directory.
|
|
</p>
|
|
<p>If the entry being renamed is in error from a previous rename request, you can continue with the rename operation or back out the changes and reset the files to the old user ID and address. To back out the changes, specify *BACKOUT on this parameter. To continue with the rename operation, do not change the value of this parameter (if the value is changed to another user ID and address, this is an error).
|
|
</p>
|
|
<p>If lowercase characters are specified, the system stores them as uppercase characters.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*BACKOUT</b></dt>
|
|
<dd>Back out of the rename directory entry operation. This value is only allowed on a directory entry that is in error as the result of a previous rename. This value sets the user ID and address in all IBM-supplied files changed by a previous rename request to the values specified on the OLDUSRID parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: User ID</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the new user ID for the directory entry. A maximum of 8 characters can be specified. If this value is specified, an address must be specified on Element 2.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the new address for the directory entry. A maximum of 8 characters can be specified. If this value is specified, a user ID must be specified on Element 1.
|
|
<p>
|
|
<b>Note: </b>Changing the address element does not change the system name of the directory entry. If you want distributions for the user forwarded to a system other than what is specified by the directory entry, you must change the system name for the directory entry using the Change Directory Entry (CHGDIRE) command.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RNMDIRE.FWDFRM"></a>
|
|
<h3>Forward from user identifier (FWDFRM)</h3>
|
|
<p>Specifies whether distributions are automatically forwarded from the old user ID and address or a specified user ID and address. This value is valid only for local users.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Distributions are not forwarded.
|
|
</dd>
|
|
<dt><b>*OLDUSRID</b></dt>
|
|
<dd>All distributions are forwarded from the old user ID and address.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: User ID</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the user ID from which distributions are to be forwarded. A maximum of 8 characters can be specified. If this value is specified, an address must be specified on Element 2.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the address from which distributions are to be forwarded. A maximum of 8 characters can be specified. If this value is specified, a user ID must be specified on Element 1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RNMDIRE.NETUSRID"></a>
|
|
<h3>Change network user identifier (NETUSRID)</h3>
|
|
<p>Specifies whether the current network user ID and address are renamed to the new user ID and address. The network user ID is used in shadowing to uniquely identify a user in the network. The default is the user ID and address. If you are using directory shadowing with the user ID and address as the unique value in the network, you can also change this value to the new user ID and address specified on the NEWUSRID parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NEWUSRID</b></dt>
|
|
<dd>The network user ID and address are changed to the new user ID and address.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RNMDIRE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Renaming a User ID</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RNMDIRE OLDUSRID(HURST PAYROLL) NEWUSRID(HURST NEWYORK)
|
|
FWDFRM(*OLDUSRID)
|
|
</pre>
|
|
</p>
|
|
<p>This command renames the current user ID HURST PAYROLL to the new user ID HURST NEWYORK. Distributions sent to the old user ID and address are forwarded.
|
|
</p>
|
|
<p><b>Example 2: Renaming a User ID and Network User ID</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RNMDIRE OLDUSRID(HURST PAYROLL) NEWUSRID(HURST NEWYORK)
|
|
FWDFRM(*OLDUSRID) NETUSRID(*NEWUSRID)
|
|
</pre>
|
|
</p>
|
|
<p>This command renames the current user ID HURST PAYROLL and the current network user ID to the new user ID HURST NEWYORK. Distributions sent to the old user ID and address are forwarded.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RNMDIRE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF897F</b></dt>
|
|
<dd>Rename failed for user ID and address &1 &2.
|
|
</dd>
|
|
<dt><b>CPI90F1</b></dt>
|
|
<dd>Rename completed with errors. See previously listed messages.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|