255 lines
9.3 KiB
HTML
255 lines
9.3 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>Remove Distribution List Entry (RMVDSTLE)</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="RMVDSTLE.Top_Of_Page"></a>
|
|
<h2>Remove Distribution List Entry (RMVDSTLE)</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="#RMVDSTLE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVDSTLE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVDSTLE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVDSTLE"></a>
|
|
<p>The Remove Distribution List Entry (RMVDSTLE) command allows you to remove entries from a distribution list. Up to 300 entries can be removed from the list at one time.
|
|
</p>
|
|
<p><b>Restriction:</b> You must have security administrator authority (*SECADM) to remove entries from a distribution list owned by someone else.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVDSTLE.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="#RMVDSTLE.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="4"><a href="#RMVDSTLE.USRID"><b>USRID</b></a></td>
|
|
<td valign="top">User identifier</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">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">Element 3: User description</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*FIRST</u></b>, *ALL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RMVDSTLE.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="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVDSTLE.LSTID"></a>
|
|
<h3>List identifier (LSTID)</h3>
|
|
<p>Specifies the two-part list identification (ID) of the distribution list that is to have entries removed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-identification</i></b></dt>
|
|
<dd>The list ID is entered in two parts separated by at least one space. If any lowercase characters are specified, the system changes them into uppercase letters.
|
|
</dd>
|
|
</dl>
|
|
<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="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDSTLE.USRID"></a>
|
|
<h3>User identifier (USRID)</h3>
|
|
<p>Specifies the user ID, address, and description of the user being removed from the distribution list. Both the user ID and address must be provided. The description can be entered to specify deletion of a specific description for a user ID.
|
|
</p>
|
|
<p>You can enter multiple values for this parameter.
|
|
</p>
|
|
<p>A two-part list ID (user-ID and address) can be used in place of the user ID and address to identify a remote distribution list being removed.
|
|
</p>
|
|
<p>Up to 300 sets of user IDs, addresses, and descriptions can be specified. Each valid set is removed from the distribution list.
|
|
</p>
|
|
<p>At least one set of user IDs is required.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>user-id and address</i></b></dt>
|
|
<dd>Specify the user ID and address being removed.
|
|
</dd>
|
|
</dl>
|
|
<p>If any lowercase characters are specified, the system changes them to, and stores them as, uppercase characters.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first entry in the distribution list for the specified user ID and address is removed. If only one entry exists, it is removed from the list.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All the entries with the specified user ID and address are removed from the distribution list.
|
|
</dd>
|
|
<dt><b><i>user-description</i></b></dt>
|
|
<dd>Specify the description of the user. If a list ID is specified, enter the list description. The description can have a maximum of 50 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVDSTLE.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>
|
|
<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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVDSTLE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
RMVDSTLE LSTID(CHICAGO DLIST)
|
|
USRID((HURST PAYROLL 'Manager of Payroll')
|
|
(LEE DEPT554 *FIRST)
|
|
(BOCA DLIST 'Remote Distribution List')
|
|
(BRYON WAREHSE *ALL))
|
|
</pre>
|
|
</p>
|
|
<p>In this example, four user IDs are removed from the distribution list CHICAGO DLIST. The third user ID is, in fact, a remote distribution list. All entries for BRYON WAREHSE are removed from the list.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVDSTLE.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>CPF9092</b></dt>
|
|
<dd>No entries removed from list &1 &2.
|
|
</dd>
|
|
<dt><b>CPF9093</b></dt>
|
|
<dd>&1 entries removed from list &2 &3.
|
|
</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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVDSTLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|