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

251 lines
7.6 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>End Mode (ENDMOD)</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="ENDMOD.Top_Of_Page"></a>
<h2>End Mode (ENDMOD)</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="#ENDMOD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDMOD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDMOD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDMOD"></a>
<p>The End Mode (ENDMOD) command ends (deactivates) a single mode or all active modes for a specific advanced program-to-program communications (APPC) remote location. The mode remains inactive until a Start Mode (STRMOD) command is run to start the mode. This command can be used to end all the sessions for a particular remote location and to cause an active switched connection to disconnect. The user can also specify how activities that have been requested on the remote system but have not yet been performed are to be handled.
</p>
<p>The APPC Programming book, SC41-5443 has more information on the ENDMOD command.
</p>
<p><b>Restriction:</b> This command cannot be used to end (deactivate) Client Access/400 mode (QPCSUPP) at a remote location.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDMOD.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"><a href="#ENDMOD.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location</td>
<td valign="top"><i>Communications name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ENDMOD.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i>, <b><u>*LOC</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ENDMOD.MODE"><b>MODE</b></a></td>
<td valign="top">Mode</td>
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b>, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ENDMOD.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
<td valign="top">Local location</td>
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ENDMOD.RMTNETID"><b>RMTNETID</b></a></td>
<td valign="top">Remote network identifier</td>
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ENDMOD.CPLPNDRQS"><b>CPLPNDRQS</b></a></td>
<td valign="top">Complete pended requests</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDMOD.RMTLOCNAME"></a>
<h3>Remote location (RMTLOCNAME)</h3>
<p>Specifies the remote location name for which one or more modes are to be ended.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDMOD.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the device description name.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The device description is determined by the system.
</dd>
<dt><b><i>device-name</i></b></dt>
<dd>Specify a device description name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDMOD.MODE"></a>
<h3>Mode (MODE)</h3>
<p>Specifies the mode that is to be ended.
</p>
<p>The possible values are:
</p>
<dl>
</dl>
<dl>
<dt><b><u>*NETATR</u></b></dt>
<dd>The mode in the network attributes is used.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>All modes currently in use by the remote location are ended.
</dd>
<dt><b>BLANK</b></dt>
<dd>The mode name (consisting of 8 blank characters) is used.
</dd>
<dt><b><i>mode-name</i></b></dt>
<dd>Specify a mode name.
<p>
<b>Note: </b>SNASVCMG and CPSVCMG are reserved names and cannot be specified.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDMOD.LCLLOCNAME"></a>
<h3>Local location (LCLLOCNAME)</h3>
<p>Specifies the local location name.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The local location name is determined by the system.
</dd>
</dl>
<dl>
<dt><b>*NETATR</b></dt>
<dd>The LCLLOCNAME value specified in the system network attributes is used.
</dd>
</dl>
<dl>
<dt><b><i>local-location-name</i></b></dt>
<dd>Specify the name of your location. The local location name is specified if you want to indicate a specific local location name for the remote location.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDMOD.RMTNETID"></a>
<h3>Remote network identifier (RMTNETID)</h3>
<p>Specifies the remote network ID used with the remote location.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The system selects the remote network ID.
</dd>
</dl>
<dl>
<dt><b>*NETATR</b></dt>
<dd>The remote network identifier specified in the network attributes is used.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*NONE</b></dt>
<dd>No remote network identifier (ID) is used.
</dd>
</dl>
<dl>
<dt><b><i>remote-network-id</i></b></dt>
<dd>Specify the name of the remote network ID used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDMOD.CPLPNDRQS"></a>
<h3>Complete pended requests (CPLPNDRQS)</h3>
<p>Specifies if the remote location can complete pending work, or if the pended work should be ended before being allowed to start.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The requested activities currently in progress at the remote location can complete. Activities that have been requested but not started at the remote location will not be performed.
</dd>
<dt><b>*YES</b></dt>
<dd>All requested activities are allowed to complete before the mode is ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDMOD.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ENDMOD RMTLOCNAME(APPCRLOC) MODE(APPCMOD)
</pre>
</p>
<p>This command ends a mode named APPCMOD for remote location APPCRLOC.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDMOD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF598B</b></dt>
<dd>The &amp;1 command failed for one or more modes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMOD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>