198 lines
7.1 KiB
HTML
198 lines
7.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>Create Distribution List (CRTDSTL)</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="CRTDSTL.Top_Of_Page"></a>
|
|
<h2>Create Distribution List (CRTDSTL)</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="#CRTDSTL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTDSTL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTDSTL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTDSTL"></a>
|
|
<p>The Create Distribution List (CRTDSTL) command allows you to create a new distribution list, which is a list of entries from the distribution directory. It can include entries for local users, remote users, indirect users, and programmable work station users. It can also include remote distribution lists, but not local distribution lists. The Create Distribution List (CRTDSTL) command creates the distribution list with no entries. The Add Distribution List Entry (ADDDSTLE) command is used to add entries to the distribution list.
|
|
</p>
|
|
<p><b>Restriction:</b> The list identifier (ID) must be unique to all local user IDs, as well as to other list IDs in the directory.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTDSTL.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="#CRTDSTL.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"><a href="#CRTDSTL.LSTD"><b>LSTD</b></a></td>
|
|
<td valign="top">List description</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTDSTL.CMDCHRID"><b>CMDCHRID</b></a></td>
|
|
<td valign="top">Command character identifier</td>
|
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Graphic character set</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Code page</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTDSTL.LSTID"></a>
|
|
<h3>List identifier (LSTID)</h3>
|
|
<p>Specifies the unique, two-part list identifier of the distribution list. The same rules and restrictions that apply to user ID and address also apply to the distribution list ID. A maximum of 8 characters can be specified for each part.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>If any lowercase characters are specified, the system changes them to, and stores them as, uppercase characters.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDSTL.LSTD"></a>
|
|
<h3>List description (LSTD)</h3>
|
|
<p>Specifies the description of the distribution list that further identifies the distribution list. A maximum of 50 characters can be specified.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDSTL.CMDCHRID"></a>
|
|
<h3>Command character identifier (CMDCHRID)</h3>
|
|
<p>Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values.
|
|
</p>
|
|
<p><b>Note:</b>
|
|
</p>
|
|
<ul>
|
|
<li>Only the user ID and address, system name and group, department, and the X.400 O/R parameters are translated to the graphic character set identifier (GCID) specified on this parameter. All other parameter values that you specify are stored exactly as they are entered; the GCID value is stored with them.
|
|
</li>
|
|
<li>If this command is run interactively, the default GCID value is taken from the display device description. If it is run in batch, the default GCID value is taken from the QCHRID system value. You can override these values by specifying a specific character set and code page on this parameter.
|
|
</li>
|
|
</ul>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
|
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DEVD</b></dt>
|
|
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Graphic character set</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-32767</i></b></dt>
|
|
<dd>Specify the graphic character set to use.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Code page</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-32767</i></b></dt>
|
|
<dd>Specify the code page to use.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTDSTL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CRTDSTL LSTID(DEPT48K DLIST)
|
|
LSTD('Department 48K Distribution List')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a distribution list that contains the members of Department&rbl.48K. If this list ID is unique, the distribution list is created.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTDSTL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9009</b></dt>
|
|
<dd>System requires file &1 in &2 be journaled.
|
|
</dd>
|
|
<dt><b>CPF905C</b></dt>
|
|
<dd>Error occurred trying to find a translation table.
|
|
</dd>
|
|
<dt><b>CPF9088</b></dt>
|
|
<dd>List &1 &2 not created in the directory.
|
|
</dd>
|
|
<dt><b>CPF9096</b></dt>
|
|
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
|
|
</dd>
|
|
<dt><b>CPF9838</b></dt>
|
|
<dd>User profile storage limit exceeded.
|
|
</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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDSTL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|