185 lines
6.5 KiB
HTML
185 lines
6.5 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 Distribution List (RNMDSTL)</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="RNMDSTL.Top_Of_Page"></a>
|
|
<h2>Rename Distribution List (RNMDSTL)</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="#RNMDSTL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RNMDSTL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RNMDSTL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RNMDSTL"></a>
|
|
<p>The Rename Distribution List (RNMDSTL) command renames the list identifier (ID) of an existing distribution list.
|
|
</p>
|
|
<p>A <b>distribution list</b> is a list of entries from the distribution directory. The distribution list can include entries for local, remote, indirect, and independent work station users. It can also include remote distribution lists, but it cannot include local distribution lists. More information about distribution lists is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
<p>When renaming the distribution list, the new list ID must be unique to all local user IDs and other list IDs in the directory. If a new list ID is not unique, the list is not renamed and an error message is returned.
|
|
</p>
|
|
<p><b>Restriction:</b> You must have security administrator (*SECADM) authority to rename a distribution list that you do not own. No special authority is needed for you to rename a distribution list that you own.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RNMDSTL.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="#RNMDSTL.LSTID"><b>LSTID</b></a></td>
|
|
<td valign="top">List identifier</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: List ID</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: List ID qualifier</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RNMDSTL.NEWLSTID"><b>NEWLSTID</b></a></td>
|
|
<td valign="top">New list identifier</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: List ID</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: List ID qualifier</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RNMDSTL.LSTID"></a>
|
|
<h3>List identifier (LSTID)</h3>
|
|
<p>Specifies the two-part list identifier of the distribution list to be renamed.
|
|
</p>
|
|
<p>The possible list identifier value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-ID</i></b></dt>
|
|
<dd>Specify the list identifier (ID) of the distribution list.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible list qualifier value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-ID-qualifier</i></b></dt>
|
|
<dd>Specify the list ID qualifier of the distribution list.
|
|
<p>
|
|
<b>Note: </b>The distribution list identifier has two parts, the ID and the qualifier, separated by at least one space. If lowercase characters are specified, the system changes them to uppercase.
|
|
</p>
|
|
<p>The naming rules for the two-part list ID are identical to the rules for the user ID and address. A complete description of these rules is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RNMDSTL.NEWLSTID"></a>
|
|
<h3>New list identifier (NEWLSTID)</h3>
|
|
<p>Specifies the new two-part list identifier of the distribution list.
|
|
</p>
|
|
<p>The possible list identifier value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-ID</i></b></dt>
|
|
<dd>Specify the list identifier (ID) of the distribution list.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible list qualifier value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-ID-qualifier</i></b></dt>
|
|
<dd>Specify the list ID qualifier of the distribution list.
|
|
<p>
|
|
<b>Note: </b>The distribution list identifier has two parts, the ID and the qualifier, separated by at least one space. If lowercase characters are specified, the system changes them to uppercase.
|
|
</p>
|
|
<p>The naming rules for the two-part list ID are identical to the rules for the user ID and address. A complete description of these rules is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RNMDSTL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
RNMDSTL LSTID(DEPTABC DLIST) NEWLSTID(DEPTXYZ DLIST)
|
|
</pre>
|
|
</p>
|
|
<p>This command renames a distribution list that contains the members of Department&rbl.ABC. The list ID is being changed to correspond to a new department name, XYZ. If the new list ID is unique, the distribution list is changed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RNMDSTL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9A8B</b></dt>
|
|
<dd>Distribution list &1 &2 not renamed.
|
|
</dd>
|
|
<dt><b>CPF9024</b></dt>
|
|
<dd>System cannot get correct record to finish operation.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RNMDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|