ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dltdstl.htm

202 lines
7.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Delete Distribution List (DLTDSTL)</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="DLTDSTL.Top_Of_Page"></a>
<h2>Delete Distribution List (DLTDSTL)</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="#DLTDSTL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DLTDSTL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DLTDSTL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DLTDSTL"></a>
<p>The Delete Distribution List (DLTDSTL) command deletes an existing distribution list from the system distribution directory.
</p>
<p><b>Restriction:</b> You must have security administrator authority to delete a distribution list owned by another user. No special authority is needed to delete a distribution list that you own.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DLTDSTL.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="#DLTDSTL.LSTID"><b>LSTID</b></a></td>
<td valign="top">List identifier</td>
<td valign="top">Values (up to 300 repetitions): <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="#DLTDSTL.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="#DLTDSTL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DLTDSTL.LSTID"></a>
<h3>List identifier (LSTID)</h3>
<p>Specifies the two-part list identifier of the distribution list being deleted. A maximum of 300 list IDs (both parts) can be specified. You can specify a maximum of 8 characters for each part of each list ID.
</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>You can enter multiple values for this parameter.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTDSTL.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>If the value for the <b>Distribution identifier (DSTID)</b> parameter and <b>User identifier (USRID)</b> parameter are being read from an output file created by the Query Distribution (QRYDST) command, use '930 500' for the value of this parameter.
</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>
<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="#DLTDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTDSTL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DLTDSTL LSTID((DEPT48K DLIST) (ISMGRS DSTLIST))
</pre>
</p>
<p>This command deletes the two distribution lists, DEPT48K DLIST and ISMGRS DSTLIST, if they exist.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTDSTL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9024</b></dt>
<dd>System cannot get correct record to finish operation.
</dd>
<dt><b>CPF905C</b></dt>
<dd>Error occurred trying to find a translation table.
</dd>
<dt><b>CPF9094</b></dt>
<dd>&amp;1 distribution lists deleted. &amp;2 lists not deleted.
</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 &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTDSTL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>