194 lines
6.5 KiB
HTML
194 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>Change Distribution List (CHGDSTL)</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="CHGDSTL.Top_Of_Page"></a>
|
|
<h2>Change Distribution List (CHGDSTL)</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="#CHGDSTL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGDSTL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGDSTL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGDSTL"></a>
|
|
<p>The Change Distribution List (CHGDSTL) command is used to change information about 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 users of work stations that are local, remote, indirect, and independent. It also can 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><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have security administrator (*SECADM) authority to change a distribution list that you do not own.
|
|
</li>
|
|
<li>No special authority is needed for you to change a distribution list that you own. However, to change the ownership of a distribution list that you own, you must have at least change (*CHANGE) authority to the user profile of the user to be named as the new owner.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGDSTL.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="#CHGDSTL.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, Key, 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"><a href="#CHGDSTL.LSTD"><b>LSTD</b></a></td>
|
|
<td valign="top">List description</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDSTL.OWNER"><b>OWNER</b></a></td>
|
|
<td valign="top">Owner</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGDSTL.LSTID"></a>
|
|
<h3>List identifier (LSTID)</h3>
|
|
<p>Specifies the two-part list identifier of the distribution list to be changed.
|
|
</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="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDSTL.LSTD"></a>
|
|
<h3>List description (LSTD)</h3>
|
|
<p>Specifies the description of the distribution list. The description further identifies the distribution list.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>'list-description'</i></b></dt>
|
|
<dd>Specify the changed description of the distribution list. A maximum of 50 characters can be specified and must be enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDSTL.OWNER"></a>
|
|
<h3>Owner (OWNER)</h3>
|
|
<p>Specifies the user profile name of the user who is to own the distribution list. The user profile named must exist on the system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>user-profile-name</i></b></dt>
|
|
<dd>Specify the name of the user profile for the user to whom the distribution list is being assigned.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDSTL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGDSTL LSTID(DEPTABC DLIST)
|
|
LSTD('Department ABC Distribution List')
|
|
OWNER(SECABC)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes a distribution list that contains the members of Department&rbl.ABC. The description and owner of the distribution list are both changed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDSTL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9A8A</b></dt>
|
|
<dd>Distribution list &1 &2 not changed.
|
|
</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="#CHGDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|