659 lines
29 KiB
HTML
659 lines
29 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>Change TCP/IP Interface (CHGTCPIFC)</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="CHGTCPIFC.Top_Of_Page"></a>
|
|
<h2>Change TCP/IP Interface (CHGTCPIFC)</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="#CHGTCPIFC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGTCPIFC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGTCPIFC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGTCPIFC"></a>
|
|
<p>The Change TCP/IP Interface (CHGTCPIFC) command is used to change an existing interface in the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration. The interfaces defined by the CHGTCPIFC command are logical interfaces. They are not physical interfaces. Each interface is associated with a line description. The line description is the physical connection from the system to the TCP/IP network.
|
|
</p>
|
|
<p>The i5/OS TCP/IP implementation supports <i>multihoming</i>. This allows you to specify either a single interface or multiple interfaces per line description. You can have your system appear as any one or combination of the following:
|
|
</p>
|
|
<ul>
|
|
<li>A single host on a network over a communications line
|
|
</li>
|
|
<li>Multiple hosts on the <u> same</u> network over the same communications line
|
|
</li>
|
|
<li>Multiple hosts on <u> different</u> networks over the same communications line
|
|
</li>
|
|
<li>Multiple hosts on the same network over multiple communications lines
|
|
</li>
|
|
<li>Multiple hosts on different networks over multiple communications lines
|
|
</li>
|
|
</ul>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>If you attempt to change a value for an interface that will invalidate a route or remote system information (RSI) associated with the interface, the change will not be allowed.
|
|
</li>
|
|
<li>In SNMP, an interface is a physical interface. The physical interface relates directly to an input/output processor (IOP).
|
|
</li>
|
|
<li>The interface table is shipped with a default interface of 127.0.0.1. The line description value associated with the 127.0.0.1 interface is *LOOPBACK. The host table is also shipped with an entry that has an internet address of 127.0.0.1 and host names of LOOPBACK and LOCALHOST.
|
|
</li>
|
|
</ol>
|
|
<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>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
|
|
</li>
|
|
<li>Only certain values can be changed using this command. The values that can be changed depend on the status of the interface, the status of the dependent routes, and the remote system information configured.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGTCPIFC.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="#CHGTCPIFC.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="#CHGTCPIFC.ALIASNAME"><b>ALIASNAME</b></a></td>
|
|
<td valign="top">Alias name</td>
|
|
<td valign="top"><i>Simple name</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.LIND"><b>LIND</b></a></td>
|
|
<td valign="top">Line description</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *VIRTUALIP, *LOOPBACK, *OPC</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.SUBNETMASK"><b>SUBNETMASK</b></a></td>
|
|
<td valign="top">Subnet mask</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *HOST</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.LCLIFC"><b>LCLIFC</b></a></td>
|
|
<td valign="top">Associated local interface</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.TOS"><b>TOS</b></a></td>
|
|
<td valign="top">Type of service</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *MINDELAY, *MAXTHRPUT, *MAXRLB, *MINCOST, *NORMAL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.MTU"><b>MTU</b></a></td>
|
|
<td valign="top">Maximum transmission unit</td>
|
|
<td valign="top">576-16388, <b><u>*SAME</u></b>, *LIND</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.AUTOSTART"><b>AUTOSTART</b></a></td>
|
|
<td valign="top">Autostart</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.PVCLGLCHLI"><b>PVCLGLCHLI</b></a></td>
|
|
<td valign="top">PVC logical channel identifier</td>
|
|
<td valign="top">Values (up to 64 repetitions): <i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.IDLVCTTIMO"><b>IDLVCTTIMO</b></a></td>
|
|
<td valign="top">X.25 idle circuit timeout</td>
|
|
<td valign="top">1-600, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.MAXSVC"><b>MAXSVC</b></a></td>
|
|
<td valign="top">X.25 maximum virtual circuits</td>
|
|
<td valign="top">0-64, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.DDN"><b>DDN</b></a></td>
|
|
<td valign="top">X.25 DDN interface</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPIFC.BITSEQ"><b>BITSEQ</b></a></td>
|
|
<td valign="top">TRLAN bit sequencing</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *MSB, *LSB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGTCPIFC.INTNETADR"></a>
|
|
<h3>Internet address (INTNETADR)</h3>
|
|
<p>Specifies the internet address. 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>If an internet address is not provided with the command, the alias name must be provided and it will be used as the key value for the command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.ALIASNAME"></a>
|
|
<h3>Alias name (ALIASNAME)</h3>
|
|
<p>Specifies a name that can be used in place of the internet address. The name must be unique among all of the interfaces on the system.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If an internet address is not provided with the command, the alias name will be the key for the command. If an internet address is provided, the alias name can be changed from its current value.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current alias name is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No alias name is associated with the TCP/IP interface you are currently defining.
|
|
</dd>
|
|
<dt><b><i>simple-name</i></b></dt>
|
|
<dd>Specify a name for the interface. The alias name must be 25 characters or less.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.LIND"></a>
|
|
<h3>Line description (LIND)</h3>
|
|
<p>Specifies the name of the line description associated with the to be changed interface. The following conditions are based on the interface type that the user defines:
|
|
</p>
|
|
<dl>
|
|
<dt><b>Token-ring</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (Token-Ring Network) (CRTLINTRN) command.
|
|
</dd>
|
|
<dt><b>X.25</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (X.25) (CRTLINX25) command.
|
|
</dd>
|
|
<dt><b>Ethernet</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (Ethernet) (CRTLINETH) command.
|
|
</dd>
|
|
<dt><b>DDI</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (DDI Network) (CRTLINDDI) command.
|
|
</dd>
|
|
<dt><b>Frame relay</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (Frame Relay Network) (CRTLINFR) command.
|
|
</dd>
|
|
<dt><b>Wireless</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (Wireless Network) (CRTLINWLS) command.
|
|
</dd>
|
|
<dt><b>Twinax (TDLC)</b></dt>
|
|
<dd>The name must be previously defined on the Create Line Description (TDLC) (CRTLINTDLC) command.
|
|
</dd>
|
|
</dl>
|
|
<p>TCP/IP can also be used on certain line descriptions attached to these network interfaces (NWI):
|
|
</p>
|
|
<ul>
|
|
<li>A frame relay NWI using a frame relay, token ring, Ethernet, or DDI line description.
|
|
<ul>
|
|
<li>The frame relay NWI is created using the Create Network Interface Frame Relay Network (CRTNWIFR) command.
|
|
</li>
|
|
<li>The line description is created using the appropriate Create Line command and attached to the frame relay NWI by specifying the NWI and NWIDLCI parameters.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The same line description existing for this interface is used.
|
|
</dd>
|
|
<dt><b>*VIRTUALIP</b></dt>
|
|
<dd>The virtual interface is a circuitless interface. It is used in conjunction with the associated local interface (LCLIFC) when adding standard interfaces. This special value is used to accommodate any of the following cases:
|
|
<ol>
|
|
<li>Load balancing. This is the means of having a fixed source IP address regardless of which interface the traffic is being distributed.
|
|
</li>
|
|
<li>Frame-relay multi-access network to define the local network IP address. This allows for multiple virtual circuits to share the same IP network.
|
|
</li>
|
|
<li>Alternate method of network access translation (NAT). This eliminates the need for a NAT box by assigning a globally unique single IP address directly to the box without the need to define an entire network.
|
|
</li>
|
|
<li>Unnumbered networks. This provides a means of associating a local source IP address for an unnumbered point-to-point network.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
<dt><b>*OPC</b></dt>
|
|
<dd>This special value is used if you are adding an OptiConnect interface over TCP/IP. This interface is attached to the optical bus (OptiConnect).
|
|
</dd>
|
|
<dt><b>*LOOPBACK</b></dt>
|
|
<dd>The interface being changed by this command is the loopback or LOCALHOST interface. Because processing associated with loopback does not extend to a physical line, there is no line description associated with a loopback address. This special value must be used for any internet address that has a first octet value of 127.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the line description to be used for this interface.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.SUBNETMASK"></a>
|
|
<h3>Subnet mask (SUBNETMASK)</h3>
|
|
<p>Specifies the subnet mask, which is a bit mask that defines the part of the network where this interface attaches. The mask is a 32-bit combination that is logically ANDed with the internet address to determine a particular subnetwork. The bits of the mask set to the value one (1) determine the network and subnetwork portions of the address. The bits set to the value zero (0) determine the host portion of the address.
|
|
</p>
|
|
<p>The bits that identify the subnetwork are not required to be adjacent in the address. However, if this subnet mask value is changed, it might invalidate or affect the routes using this interface. To prevent this, keep the subnet bits contiguous and located in the most significant bits of the host address.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The network portion must be equal to one bits in the subnetmask. The host portion of an address must be at least two bits wide.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The same subnetmask existing for this interface is used.
|
|
</dd>
|
|
<dt><b>*HOST</b></dt>
|
|
<dd>The subnet mask value used will be 255.255.255.255. Specify this value for use with Proxy ARP (Address Resolution Protocol).
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the subnet mask for the network field and host address field of the internet address that defines a subnetwork. The subnet mask is in the form <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. For more detailed information on subnet masks and an example, see the help for the Add TCP/IP Interface (ADDTCPIFC) command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.LCLIFC"></a>
|
|
<h3>Associated local interface (LCLIFC)</h3>
|
|
<p>Use this parameter to associate the interface you are currently defining with an existing local TCP/IP interface.
|
|
</p>
|
|
<p>The associated local interface (LCLIFC) is used to allow 'transparent subnetting' (also known as 'Proxy Arp') between the associated interfaces, to define Frame Relay unnumbered networks or for load balancing.
|
|
</p>
|
|
<p>Condition for using the LCLIFC for unnumbered networks:
|
|
</p>
|
|
<ul>
|
|
<li>The line type of the interface you are changing MUST be Frame Relay.
|
|
</li>
|
|
</ul>
|
|
<p>Conditions for using LCLIFC for transparent subnetting:
|
|
</p>
|
|
<ul>
|
|
<li>The network of the associated local interface must be broadcast capable.
|
|
</li>
|
|
<li>The interface you are changing must be defined as a subnet of the network you are associating it with (using LCLIFC).
|
|
</li>
|
|
</ul>
|
|
<p>Condition for using the LCLIFC for load balancing:
|
|
</p>
|
|
<ul>
|
|
<li>This is the means of having a fixed source IP address regardless of which interface the traffic is being distributed.
|
|
</li>
|
|
<li>The line type of the associated local interface must be *VIRTUALIP.
|
|
</li>
|
|
</ul>
|
|
<p>
|
|
<b>Note: </b>You can only use LCLIFC to associate this interface to another interface that is already defined. Once associated, the interface defined in LCLIFC must always be started prior to starting this interface.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The current associated local interface is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No TCP/IP interface is associated with the interface you are currently defining.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the internet address of the interface you want to associate with the interface you are currently defining.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.TOS"></a>
|
|
<h3>Type of service (TOS)</h3>
|
|
<p>Specifies the type of service to be used. The type of service defines how the internet hosts and routers should make trade-offs between throughput, delay, reliability, and cost.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The type of service does not change.
|
|
<p>*NORMAL: Normal service is used for delivery of data.
|
|
</p>
|
|
<p>*MINDELAY: Minimize delay means that prompt delivery is important for data on this connection.
|
|
</p>
|
|
<p>*MAXTHRPUT: Maximize throughput means that a high data rate is important for data on this connection.
|
|
</p>
|
|
<p>*MAXRLB: Maximize reliability means that a higher level of effort to ensure
|
|
</p>
|
|
<p>*MINCOST: Minimize monetary cost means that lower cost is important for data on this connection.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.MTU"></a>
|
|
<h3>Maximum transmission unit (MTU)</h3>
|
|
<p>Specifies the maximum size (in bytes) of IP datagrams that can be transmitted through this interface. A datagram is a basic unit of information passed over an internet network. The minimum size of any maximum transmission unit value is 576 bytes. If this value is changed it affects the MTUs of routes using this interface.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing maximum transmission unit value for this interface is used.
|
|
</dd>
|
|
<dt><b>*LIND</b></dt>
|
|
<dd>The MTU is determined by the information specified in the line description. If *LIND is specified, the MTU is equal to the largest amount of data that can be transmitted on the line.
|
|
</dd>
|
|
<dt><b><i>maximum-transmission-unit</i></b></dt>
|
|
<dd>Specify a value for the maximum transmission unit in bytes. The maximum MTU that can be specified for this interface depends on the type of physical connection to the network. The following table lists the maximum MTU values that can be specified based on the line type:
|
|
<dl>
|
|
<dt><b>X.25</b></dt>
|
|
<dd>4096
|
|
</dd>
|
|
<dt><b>Token ring (4 meg)</b></dt>
|
|
<dd>4060
|
|
</dd>
|
|
<dt><b>Token ring (16 meg)</b></dt>
|
|
<dd>16388
|
|
</dd>
|
|
<dt><b>Ethernet 802.3</b></dt>
|
|
<dd>1492
|
|
</dd>
|
|
<dt><b>Ethernet Version 2</b></dt>
|
|
<dd>1500
|
|
</dd>
|
|
<dt><b>DDI</b></dt>
|
|
<dd>4352
|
|
</dd>
|
|
<dt><b>Frame relay</b></dt>
|
|
<dd>8177
|
|
</dd>
|
|
<dt><b>Wireless 802.3</b></dt>
|
|
<dd>1492
|
|
</dd>
|
|
<dt><b>Wireless Version 2</b></dt>
|
|
<dd>1500
|
|
</dd>
|
|
<dt><b>Twinax (TDLC)</b></dt>
|
|
<dd>4105
|
|
</dd>
|
|
</dl>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>It is suggested that the same MTU values be used for all interfaces on the same network.
|
|
</li>
|
|
<li>The actual MTU value used for an interface is resolved during interface activation. This value is the minimum of either the specified MTU value for the interface or the largest amount of data that can be transmitted on the line.
|
|
</li>
|
|
<li>The same MTU value does not need to be specified for all interfaces defined on the same subnet. However, all interfaces must have an MTU that does not exceed the value used when *LIND is specified for the interface MTU.
|
|
</li>
|
|
<li>To view the MTU value actually used for an interface, do the following:
|
|
<ol>
|
|
<li>Use the ADDTCPIFC command to add the interface.
|
|
</li>
|
|
<li>Use the Start TCP/IP Interface (STRTCPIFC) command to activate the interface.
|
|
</li>
|
|
<li>Use the Work with TCP/IP Status (WRKTCPSTS or NETSTAT) command to view the actual MTU value of the interface in bytes.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.AUTOSTART"></a>
|
|
<h3>Autostart (AUTOSTART)</h3>
|
|
<p>Specifies whether the interface is automatically started when the TCP/IP stack is activated by using the Start TCP/IP (STRTCP) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing autostart value for this interface is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The interface is automatically started by the STRTCP command. time.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The interface is not started by the STRTCP command.
|
|
<p>
|
|
<b>Note: </b>The Start TCP/IP Interface (STRTCPIFC) command can be used to start an interface any time after TCP/IP has been activated (STRTCP).
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.PVCLGLCHLI"></a>
|
|
<h3>PVC logical channel identifier (PVCLGLCHLI)</h3>
|
|
<p>Specifies the permanent virtual circuit (PVC) logical channel identifiers that can be established on an X.25 interface by the TCP/IP protocol stack. Up to 64 unique channel identifiers may be specified. These logical channel identifiers must exist in the X.25 line description.
|
|
</p>
|
|
<p>With this parameter you can share the line with other communications software, such as Systems Network Architecture (SNA). It prevents the TCP/IP protocol stack from monopolizing the PVCs defined for the line.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This parameter is valid only for an interface defined on an X.25 line description.
|
|
</li>
|
|
<li>PVCs cannot be used in a DDN network.
|
|
</li>
|
|
<li>When specifying PVCs for an X.25 interface, all interfaces on the same X.25 network must have this same set of PVC logical channel identifiers specified. This is especially important if one or more remote system information (RSI) entries will use a PVC to connect to the RSI entry's remote system on the X.25 network.
|
|
</li>
|
|
<li>If the RSI entries are defined such that two or more remote internet addresses can be reached across the same PVC, that PVC is shared.
|
|
</li>
|
|
<li>The sum of the maximum switched virtual circuits (MAXSVC) and the number of PVCs cannot exceed 64.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing PVC logical channel identifier values for this interface are used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>All existing PVC logical channel identifier values for this interface are removed. If no PVC values are defined, *NONE is shown.
|
|
</dd>
|
|
<dt><b><i>001-FFF</i></b></dt>
|
|
<dd>Specify the PVC logical channel identifier value. Up to 64 PVC logical channel identifiers can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.IDLVCTTIMO"></a>
|
|
<h3>X.25 idle circuit timeout (IDLVCTTIMO)</h3>
|
|
<p>Specifies the duration (in seconds) that the TCP/IP Network Access Manager (NAM) waits before clearing an idle virtual circuit established on an X.25 link. Clearing an idle virtual circuit frees resources on the network. TCP/IP automatically reestablishes virtual circuits when required to send or receive data. Virtual circuits are transparent to a TCP/IP client and have no noticeable effect on TCP connections.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only for switched virtual circuits (SVCs) on an interface defined on an X.25 line description. It is not valid for permanent virtual circuits (PVCs).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing idle virtual circuit timeout value for this interface is used.
|
|
</dd>
|
|
<dt><b><i>1-600</i></b></dt>
|
|
<dd>Specify the number of seconds to be used for the idle virtual circuit timeout.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.MAXSVC"></a>
|
|
<h3>X.25 maximum virtual circuits (MAXSVC)</h3>
|
|
<p>Specifies the maximum number of concurrent switched virtual circuits (SVC) that can be established on an X.25 interface by the TCP/IP protocol stack.
|
|
</p>
|
|
<p>With this parameter you can share the line with other communications software, such as Systems Network Architecture (SNA). It prevents the TCP/IP protocol stack from monopolizing the SVCs defined for the line. This parameter is valid only for an interface defined on an X.25 line description.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The sum of the maximum switched virtual circuits (MAXSVC) and the number of PVCs cannot exceed 64.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing maximum SVC value for this interface is used.
|
|
</dd>
|
|
<dt><b><i>0-64</i></b></dt>
|
|
<dd>Specify the number of SVCs that the TCP/IP protocol stack can use simultaneously. If 64 is specified, the number of SVCs that are configured is calculated by adding the number of *SVCIN, *SVCOUT and *SVCBOTH SVCs defined for the line description (LIND) being used by this interface. This is the maximum number of SVCs that can be authorized for processing by the TCP/IP protocol stack.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.DDN"></a>
|
|
<h3>X.25 DDN interface (DDN)</h3>
|
|
<p>Specifies whether the X.25 interface is connected to the Defense Data Network. The DDN network is a special type of X.25 network used by TCP/IP customers with special security needs.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only for switched virtual circuits (SVCs) on an interface defined on an X.25 line description. It is not valid for permanent virtual circuits (PVCs).
|
|
</p>
|
|
<p><b>Warning:</b>
|
|
</p>
|
|
<p>If you specify multiple interfaces to the same X.25 network, the DDN value should be equal for all of those interfaces. This is not enforced by the ADDTCPIFC or CHGTCPIFC commands.
|
|
</p>
|
|
<p>If the X.25 network is the DDN network, do not define the remote system information for any of the remote systems on the network. The remote system information for the DDN X.25 network is determined from the destination IP address.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing DDN value for this interface is used.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The X.25 interface is not connected to the Defense Data Network.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The X.25 interface is connected to the Defense Data Network.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPIFC.BITSEQ"></a>
|
|
<h3>TRLAN bit sequencing (BITSEQ)</h3>
|
|
<p>Specifies the order, most or least significant bit first, in which the Address Resolution Protocol (ARP) places the bits in the hardware address. This parameter is valid only for a token-ring local area network (TRLAN) line.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>All interfaces defined to a single token-ring line must have the same BITSEQ value. This is checked by the CHGTCPIFC code to ensure consistent values.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing bit sequence value for this interface is used.
|
|
</dd>
|
|
<dt><b>*MSB</b></dt>
|
|
<dd>The most significant bit is placed first.
|
|
</dd>
|
|
<dt><b>*LSB</b></dt>
|
|
<dd>The least significant bit is placed first.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGTCPIFC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing Autostart Value</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPIFC INTNETADR('130.14.3.5') AUTOSTART(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>Assuming that an interface identified by 130.14.3.5 exists, this command changes the autostart value from *YES to *NO. The interface is not automatically started when the STRTCP command is entered.
|
|
</p>
|
|
<p><b>Example 2: Changing MAXSVC and IDLVCTTIMO</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPIFC INTNETADR('8.77.0.21') INDLVCTTIMO(45) MAXSVC(15)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the idle virtual circuit time-out to 45 seconds and the maximum number of concurrent SVCs allowed to be used by TCP/IP on this interface to 15.
|
|
</p>
|
|
<p><b>Example 3: Change an Interface for a Twinax Line that is Using an Associated Local Interface</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPIFC INTNETADR('199.1.1.99') LCLIFC('199.1.1.1')
|
|
</pre>
|
|
</p>
|
|
<p>This command will change the TCP/IP interface for the twinax line named TDLCLINE. This interface will be associated with local interface 199.1.1.1. This means that the devices attached to twinax line 199.1.1.99 can take advantage of 'appearing' to be on the same network as the local 199.1.1.1 interface (transparent subnetting). No special routing is required to ensure packets from the twinax connnected hosts can travel to the local 199.1.1.0 network. Also, hosts on the 199.1.1.0 network can also reach the twinax hosts without any additional routing on the host systems.
|
|
</p>
|
|
<p><b>Example 4: Changing ALIASNAME</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPIFC INTNETADR('132.15.7.32') ALIASNAME(TEST_NETWORK)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the alias name for this interface to TEST_NETWORK.
|
|
</p>
|
|
<p><b>Example 5: Changing the interface using the ALIASNAME</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPIFC ALIASNAME(TEST_NETWORK) AUTOSTART(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the auto start value for the interface named TEST_NETWORK.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGTCPIFC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP1D03</b></dt>
|
|
<dd>&1 member record length not correct.
|
|
</dd>
|
|
<dt><b>TCP1D04</b></dt>
|
|
<dd>Error occurred processing member &1 of &2/&3.
|
|
</dd>
|
|
<dt><b>TCP1901</b></dt>
|
|
<dd>Internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP1902</b></dt>
|
|
<dd>Internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP1908</b></dt>
|
|
<dd>Internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP8050</b></dt>
|
|
<dd>*IOSYSCFG authority required to use &1.
|
|
</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="#CHGTCPIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|