183 lines
7.5 KiB
HTML
183 lines
7.5 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>End TCP/IP Interface (ENDTCPIFC)</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="ENDTCPIFC.Top_Of_Page"></a>
|
|
<h2>End TCP/IP Interface (ENDTCPIFC)</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="#ENDTCPIFC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDTCPIFC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDTCPIFC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDTCPIFC"></a>
|
|
<p>The End TCP/IP Interface (ENDTCPIFC) command is used to end a Transmission Control Protocol/Internet Protocol (TCP/IP) interface. When an interface is ended with this command, datagrams addressed to the IP addresses associated with this interface will no longer be accepted. However, the operation of any other TCP/IP or IP over SNA interface that is using the same line description as the the interface being ended is not affected.
|
|
</p>
|
|
<p>This command can be used to end an interface that was previously started by the Start TCP/IP Interface (STRTCPIFC) or Start TCP (STRTCP) command.
|
|
</p>
|
|
<p>Use this command to end all TCP/IP interfaces prior to ending TCP/IP. Also, use this command to end all TCP/IP interfaces prior to varying off a device, controller, or line associated with TCP/IP. Failure to do so may cause unpredictable results.
|
|
</p>
|
|
<h5>Notes on Route to Interface Binding</h5>
|
|
<p>Interfaces define direct routes to networks or subnetworks that this system is directly attached to. Routes define the indirect routes. An indirect route defines the next hop on the path to a network or subnetwork that this system is not directly attached to.
|
|
</p>
|
|
<p>Indirect routes are bound to interfaces using a best match first algorithm. This algorithm is based on the state of the interface and on the type of service (TOS) specified for the route and interface. When ending an interface, the routes associated with the interface can move to another existing active interface. This provides the widest available level of connectivity.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDTCPIFC.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="#ENDTCPIFC.INTNETADR"><b>INTNETADR</b></a></td>
|
|
<td valign="top">Internet address</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDTCPIFC.ALIASNAME"><b>ALIASNAME</b></a></td>
|
|
<td valign="top">Alias name</td>
|
|
<td valign="top"><i>Simple name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDTCPIFC.INTNETADR"></a>
|
|
<h3>Internet address (INTNETADR)</h3>
|
|
<p>Specifies the internet address of an interface that had previously been added to the TCP/IP configuration with the Add TCP/IP Interface (ADDTCPIFC) command and which had been previously started by the STRTCPIFC or STRTCP command. The internet address is specified in the form <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Either the INTNETADR or the ALIASNAME parameter should be specified for the command, but not both of them.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the internet address associated with the interface to be ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDTCPIFC.ALIASNAME"></a>
|
|
<h3>Alias name (ALIASNAME)</h3>
|
|
<p>Specifies the name of an interface that had previously been added to the TCP/IP configuration with the Add TCP/IP Interface (ADDTCPIFC) command and which had been previously started by the STRTCPIFC or STRTCP command. The alias name specified must be for an IPv4 interface. If the alias name is for an IPv6 interface, an error message will be returned.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Either the INTNETADR or the ALIASNAME parameter should be specified for the command, but not both of them.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>simple-name</i></b></dt>
|
|
<dd>Specify the name of the interface to be ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDTCPIFC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Ending an X.25 Interface</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDTCPIFC INTNETADR('9.5.11.125')
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to deactivate (end) the interface associated with the internet address 9.5.11.125.
|
|
</p>
|
|
<p><b>Example 2: Ending a Token-Ring Interface</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDTCPIFC INTNETADR('156.93.81.7')
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to deactivate (end) the interface associated with the internet address 156.93.81.7.
|
|
</p>
|
|
<p><b>Example 3: Ending a Token-Ring Interface using an Alias Name</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDTPCIFC ALIASNAME(TEST_NETWORK)
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to deactivate (end) the interface associated with the alias name TEST_NETWORK.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDTCPIFC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP1B15</b></dt>
|
|
<dd>Line description &2 unusable. Internal errors encountered.
|
|
</dd>
|
|
<dt><b>TCP1B61</b></dt>
|
|
<dd>Unable to determine if &1 interface ended.
|
|
</dd>
|
|
<dt><b>TCP1B62</b></dt>
|
|
<dd>Cannot determine if &1 interface ended.
|
|
</dd>
|
|
<dt><b>TCP1B65</b></dt>
|
|
<dd>&2 interface not ended. Reason &1.
|
|
</dd>
|
|
<dt><b>TCP1B71</b></dt>
|
|
<dd>&1 interface not ended.
|
|
</dd>
|
|
<dt><b>TCP1B72</b></dt>
|
|
<dd>&1 interface not ended. &1 interface is not active.
|
|
</dd>
|
|
<dt><b>TCP1B73</b></dt>
|
|
<dd>&1 interface not ended. &1 interface not defined in the TCP/IP configuration.
|
|
</dd>
|
|
<dt><b>TCP1B74</b></dt>
|
|
<dd>&1 interface not ended. Line description &2 not found.
|
|
</dd>
|
|
<dt><b>TCP1B85</b></dt>
|
|
<dd>Unable to submit request to end interface &1.
|
|
</dd>
|
|
<dt><b>TCP265F</b></dt>
|
|
<dd>INTNETADR parameter value &2 not valid.
|
|
</dd>
|
|
<dt><b>TCP265F</b></dt>
|
|
<dd>INTNETADR parameter value &2 not valid.
|
|
</dd>
|
|
<dt><b>TCP9999</b></dt>
|
|
<dd>Internal system error in program &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|