207 lines
7.8 KiB
HTML
207 lines
7.8 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>Start TCP/IP Interface (STRTCPIFC)</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="STRTCPIFC.Top_Of_Page"></a>
|
|
<h2>Start TCP/IP Interface (STRTCPIFC)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Conditional
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#STRTCPIFC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRTCPIFC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRTCPIFC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRTCPIFC"></a>
|
|
<p>The Start TCP/IP Interface (STRTCPIFC) command starts a Transmission Control Protocol/Internet Protocol (TCP/IP) interface. The line associated with the interface is varied on, if required.
|
|
</p>
|
|
<p>This command can be used to:
|
|
</p>
|
|
<ul>
|
|
<li>Start interfaces that have been specified with the AUTOSTART(*NO) value on the Add TCP/IP Interface (ADDTCPIFC) and Change TCP/IP Interface (CHGTCPIFC) commands.
|
|
</li>
|
|
<li>Start an interface that was previously ended by the End TCP/IP Interface (ENDTCPIFC) command.
|
|
</li>
|
|
</ul>
|
|
<p>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 starting an interface, routes associated with an inactive interface can move to the interface started provided that interface can be used to reach the next hop gateway of the route for the requested TOS.
|
|
</p>
|
|
<p><b>Attention:</b> Before attempting to start an X.25 interface, ensure that the remote system information (RSI) for non-DDN X.25 interfaces that use a permanent virtual circuit (PVC) is configured. Use the Add TCP/IP Remote System Information (ADDTCPRSI) command to do this. Incoming data from a remote system on the X.25 network is not processed unless an RSI entry for the PVC is configured on the X.25 interface before the interface is started.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRTCPIFC.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="#STRTCPIFC.INTNETADR"><b>INTNETADR</b></a></td>
|
|
<td valign="top">Internet address</td>
|
|
<td valign="top"><i>Character value</i>, *AUTOSTART</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRTCPIFC.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="#STRTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRTCPIFC.INTNETADR"></a>
|
|
<h3>Internet address (INTNETADR)</h3>
|
|
<p>Specifies the interface to be started.
|
|
</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>Specifies the internet address of an interface that had previously been added to the TCP/IP configuration with the ADDTCPIFC 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.
|
|
</dd>
|
|
<dt><b>*AUTOSTART</b></dt>
|
|
<dd>The TCP/IP interfaces that are started are those that have set the AUTOSTART parameter to a value of *YES using the Add TCP/IP Interface (ADDTCPIFC) or the Change TCP/IP Interface (CHGTCPIFC) commands.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRTCPIFC.ALIASNAME"></a>
|
|
<h3>Alias name (ALIASNAME)</h3>
|
|
<p>Specifies the name of the interface to be started. 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 associated with the interface to be started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRTCPIFC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Starting an Interface</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPIFC INTNETADR('9.5.11.125')
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to activate the interface associated with the internet address 9.5.11.125.
|
|
</p>
|
|
<p><b>Example 2: Starting another Interface</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPIFC INTNETADR('156.93.81.7')
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to activate the interface associated with the internet address 156.93.81.7.
|
|
</p>
|
|
<p><b>Example 3: Starting AUTOSTART(*YES) Interfaces</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPIFC INTNETADR(*AUTOSTART)
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to activate all interfaces that have the AUTOSTART parameter set to *YES using the Add TCP/IP Interface (ADDTCPIFC) or Change TCP/IP Interface (CHGTCPIFC) commands.
|
|
</p>
|
|
<p><b>Example 4: Starting an Interface with the Alias Name</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTCPIFC ALIASNAME(TEST_NETWORK)
|
|
</pre>
|
|
</p>
|
|
<p>This command causes the TCP/IP protocol stack to activate the interface associated with the alias name TEST_NETWORK.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRTCPIFC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP1B01</b></dt>
|
|
<dd>Unable to determine if &1 interface started.
|
|
</dd>
|
|
<dt><b>TCP1B02</b></dt>
|
|
<dd>Cannot determine if &1 interface started.
|
|
</dd>
|
|
<dt><b>TCP1B05</b></dt>
|
|
<dd>&2 interface not started. Reason &1.
|
|
</dd>
|
|
<dt><b>TCP1B10</b></dt>
|
|
<dd>&2 interface not started.
|
|
</dd>
|
|
<dt><b>TCP1B11</b></dt>
|
|
<dd>Interface &1 line &2 not started. Maximum &7 active interfaces allowed.
|
|
</dd>
|
|
<dt><b>TCP1B12</b></dt>
|
|
<dd>&1 interface not started. &1 interface already active.
|
|
</dd>
|
|
<dt><b>TCP1B13</b></dt>
|
|
<dd>&1 interface not started. &1 interface not defined in the TCP/IP configuration.
|
|
</dd>
|
|
<dt><b>TCP1B14</b></dt>
|
|
<dd>&1 interface not started. Line description &2 not found.
|
|
</dd>
|
|
<dt><b>TCP1B15</b></dt>
|
|
<dd>Line description &2 unusable. Internal errors encountered.
|
|
</dd>
|
|
<dt><b>TCP1B16</b></dt>
|
|
<dd>&2 interface not started.
|
|
</dd>
|
|
<dt><b>TCP1B25</b></dt>
|
|
<dd>&1 interface not started.
|
|
</dd>
|
|
<dt><b>TCP1B26</b></dt>
|
|
<dd>&1 interface not started
|
|
</dd>
|
|
<dt><b>TCP1B27</b></dt>
|
|
<dd>&1 interface not started for *TDLC line description &2.
|
|
</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="#STRTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|