244 lines
8.9 KiB
HTML
244 lines
8.9 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 Directory Entry (RMVDIRE)</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="RMVDIRE.Top_Of_Page"></a>
|
||
|
|
<h2>Remove Directory Entry (RMVDIRE)</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="#RMVDIRE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RMVDIRE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RMVDIRE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RMVDIRE"></a>
|
||
|
|
<p>The Remove Directory Entry (RMVDIRE) command allows you to remove a specific user entry from the system distribution directory. When a user ID and address is removed from the directory, it is also removed from any distribution lists. If a user ID and address has multiple descriptions associated with it, options exist to remove only a specific description or all descriptions.
|
||
|
|
</p>
|
||
|
|
<p>If an *ANY user is removed and an *ANY *ANY directory entry exists, the user is not removed from the distribution lists but the description is changed to the *ANY *ANY description.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have security administrator (*SECADM) special authority.
|
||
|
|
</li>
|
||
|
|
<li>The user entry being removed must not have ownership of documents or folders in the local Document Interchange Architecture (DIA) library.
|
||
|
|
</li>
|
||
|
|
<li>If the user entry being removed has incoming distributions on its distribution queue and the remove request was submitted interactively, an inquiry message appears asking whether the mail should be removed. If the answer is no, the user entry is not removed from the directory. If the command was submitted in a batch program, the mail is not cleared and the user entry is not removed from the directory.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RMVDIRE.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="#RMVDIRE.USRID"><b>USRID</b></a></td>
|
||
|
|
<td valign="top">User 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: 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"><a href="#RMVDIRE.USRD"><b>USRD</b></a></td>
|
||
|
|
<td valign="top">User description</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*FIRST</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#RMVDIRE.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="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RMVDIRE.USRID"></a>
|
||
|
|
<h3>User identifier (USRID)</h3>
|
||
|
|
<p>Specifies the user ID and address for the user entry being removed. Both parts must be provided. A maximum of 8 characters can be entered for each field.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RMVDIRE.USRD"></a>
|
||
|
|
<h3>User description (USRD)</h3>
|
||
|
|
<p>Specifies the description associated with the user ID and address. Since more than one entry can exist in the directory for a specific user ID and address, the description fully defines the user entry being removed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The first entry in the directory for the specified user ID and address is removed. If only one entry exists, it is removed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All descriptions for the given user ID and address are removed and the user ID and address is removed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>user-description</i></b></dt>
|
||
|
|
<dd>Specify a maximum of 50 characters for the description for the user. This must exactly match the description as it exists in the directory for this user ID and address to be removed, or an error message is returned.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RMVDIRE.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="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RMVDIRE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RMVDIRE USRID(HURST NEWYORK) USRD('Manager of Payroll')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>User ID and address HURST NEWYORK is removed if the following is true:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>An entry exists in the directory with the specified user ID, address, and description.
|
||
|
|
</li>
|
||
|
|
<li>The user does not own any documents or folders in the document interchange architecture (DIA) library.
|
||
|
|
</li>
|
||
|
|
<li>The user is not enrolled in the OfficeVision.
|
||
|
|
</li>
|
||
|
|
<li>The user has received all mail from the mail queue.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>In addition, the user is removed from all distribution lists.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RMVDIRE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF89A3</b></dt>
|
||
|
|
<dd>Operation not successful due to authority reasons.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF90A8</b></dt>
|
||
|
|
<dd>Operation not successful due to data validation reasons.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF90A8</b></dt>
|
||
|
|
<dd>*SECADM special authority required to do requested operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9005</b></dt>
|
||
|
|
<dd>System resource required to complete this request not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9009</b></dt>
|
||
|
|
<dd>System requires file &1 in &2 be journaled.
|
||
|
|
</dd>
|
||
|
|
<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>CPF9087</b></dt>
|
||
|
|
<dd>Directory entry not removed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9096</b></dt>
|
||
|
|
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9810</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</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="#RMVDIRE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|