238 lines
8.2 KiB
HTML
238 lines
8.2 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 Communications Entry (RMVCMNE)</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="RMVCMNE.Top_Of_Page"></a>
|
||
|
<h2>Remove Communications Entry (RMVCMNE)</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="#RMVCMNE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#RMVCMNE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#RMVCMNE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="RMVCMNE"></a>
|
||
|
<p>The Remove Communications Entry (RMVCMNE) command removes a communications entry from an existing subsystem description.
|
||
|
</p>
|
||
|
<p><b>Restrictions:</b>
|
||
|
</p>
|
||
|
<ol>
|
||
|
<li>To use this command, you must have:
|
||
|
<ul>
|
||
|
<li>object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing the subsystem description.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</li>
|
||
|
<li>All jobs that are active through the communications entry being removed must be ended before this command can be run.
|
||
|
</li>
|
||
|
</ol>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="RMVCMNE.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="#RMVCMNE.SBSD"><b>SBSD</b></a></td>
|
||
|
<td valign="top">Subsystem description</td>
|
||
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Qualifier 1: Subsystem description</td>
|
||
|
<td valign="top"><i>Name</i></td>
|
||
|
</tr><tr>
|
||
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
</tr><tr>
|
||
|
<td valign="top"><a href="#RMVCMNE.DEV"><b>DEV</b></a></td>
|
||
|
<td valign="top">Device</td>
|
||
|
<td valign="top"><i>Generic name, name</i>, *ALL, *APPC, *ASYNC, *BSCEL, *INTRA, *RETAIL, *FINANCE, *SNUF</td>
|
||
|
<td valign="top">Optional, Positional 2</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#RMVCMNE.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
<td valign="top">Remote location</td>
|
||
|
<td valign="top"><i>Communications name</i></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#RMVCMNE.MODE"><b>MODE</b></a></td>
|
||
|
<td valign="top">Mode</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*ANY</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="RMVCMNE.SBSD"></a>
|
||
|
<h3>Subsystem description (SBSD)</h3>
|
||
|
<p>Specifies the name and library of the subsystem description from which the communications entry is being removed.
|
||
|
</p>
|
||
|
<p>This is a required parameter.
|
||
|
</p>
|
||
|
<p><b>Qualifier 1: Subsystem description</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the subsystem for the communications entry that is being removed.
|
||
|
<p><b>Note:</b> The following IBM-supplied objects are not valid on this parameter:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>QSYSSBSD
|
||
|
</li>
|
||
|
</ul>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Qualifier 2: Library</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
<dd>All libraries in the thread's library list are searched until a match is found.
|
||
|
</dd>
|
||
|
<dt><b>*CURLIB</b></dt>
|
||
|
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the subsystem description's library for the communications entry that is being removed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="RMVCMNE.DEV"></a>
|
||
|
<h3>Device (DEV)</h3>
|
||
|
<p>Specifies the name of the device description, or the type of the device, for which the communications entry is being removed.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>You must specify a value on either this parameter or the <b>Remote location (RMTLOCNAME)</b> parameter but not for both.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>The *ALL communications entry is removed.
|
||
|
</dd>
|
||
|
<dt><b>*APPC</b></dt>
|
||
|
<dd>The *APPC communications entry is removed.
|
||
|
</dd>
|
||
|
<dt><b>*ASYNC</b></dt>
|
||
|
<dd>The *ASYNC communications entry is removed. This value is valid only when *ANY is specified on the <b>Mode (MODE)</b> parameter.
|
||
|
</dd>
|
||
|
<dt><b>*BSCEL</b></dt>
|
||
|
<dd>The *BSCEL communications entry is removed. This value is valid only when *ANY is specified on the <b>Mode (MODE)</b> parameter.
|
||
|
</dd>
|
||
|
<dt><b>*FINANCE</b></dt>
|
||
|
<dd>The *FINANCE communications entry is removed. This value is valid only when *ANY is specified on the <b>Mode (MODE)</b> parameter.
|
||
|
</dd>
|
||
|
<dt><b>*INTRA</b></dt>
|
||
|
<dd>The *INTRA communications entry is removed. This value is valid only when *ANY is specified on the <b>Mode (MODE)</b> parameter.
|
||
|
</dd>
|
||
|
<dt><b>*RETAIL</b></dt>
|
||
|
<dd>The *RETAIL communications entry is removed. This value is valid only when *ANY is specified on the <b>Mode (MODE)</b> parameter.
|
||
|
</dd>
|
||
|
<dt><b>*SNUF</b></dt>
|
||
|
<dd>The *SNUF communications entry is removed. This value is valid only when *ANY is specified on the <b>Mode (MODE)</b> parameter.
|
||
|
</dd>
|
||
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
<dd>Specify the name of the generic communications entry being removed.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the device description for which the communications entry is being removed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="RMVCMNE.RMTLOCNAME"></a>
|
||
|
<h3>Remote location (RMTLOCNAME)</h3>
|
||
|
<p>Specifies the name of the remote location for which the communications entry is removed.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>You must specify either this parameter or the <b>Device (DEV)</b> parameter, but not both.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>communications-name</i></b></dt>
|
||
|
<dd>Specify the name of the remote location used with this communications entry.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="RMVCMNE.MODE"></a>
|
||
|
<h3>Mode (MODE)</h3>
|
||
|
<p>Specifies the name of the mode of the device specified on the <b>Device (DEV)</b> parameter or the remote location specified on the <b>Remote location (RMTLOCNAME)</b> parameter for which the communications entry is removed.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
<dd>The communications device or remote location name with a mode name of *ANY is to be removed.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the mode entry of the communications device or remote location name for which the communications entry is to be removed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="RMVCMNE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
<p>
|
||
|
<pre>
|
||
|
RMVCMNE SBSD(LIB2/SBS1) DEV(COMDEV)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command removes the communications device entry for the device COMDEV from the subsystem description SBS1 in library LIB2.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="RMVCMNE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>CPF1619</b></dt>
|
||
|
<dd>Subsystem description &1 in library &2 damaged.
|
||
|
</dd>
|
||
|
<dt><b>CPF1691</b></dt>
|
||
|
<dd>Active subsystem description may or may not have changed.
|
||
|
</dd>
|
||
|
<dt><b>CPF1697</b></dt>
|
||
|
<dd>Subsystem description &1 not changed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#RMVCMNE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|