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

1026 lines
36 KiB
HTML
Raw Permalink 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>Change TCP/IP Attributes (CHGTCPA)</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="CHGTCPA.Top_Of_Page"></a>
<h2>Change TCP/IP Attributes (CHGTCPA)</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="#CHGTCPA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGTCPA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGTCPA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGTCPA"></a>
<p>The Change TCP/IP Attributes (CHGTCPA) command is used to change the TCP, UDP, IP, and ARP protocol layer attributes. The changes take effect immediately.
</p>
<p>The default values for the keywords follow. These values are also used if *DFT is specified for the keyword.
</p>
<dl>
<dt><b>Keyword</b></dt>
<dd><b> Default Value
</b></dd>
<dt><b>TCPKEEPALV</b></dt>
<dd>120 minutes
</dd>
<dt><b>TCPURGPTR</b></dt>
<dd>*BSD
</dd>
<dt><b>TCPRCVBUF</b></dt>
<dd>8192 bytes
</dd>
<dt><b>TCPSNDBUF</b></dt>
<dd>8192 bytes
</dd>
<dt><b>TCPR1CNT</b></dt>
<dd>3
</dd>
<dt><b>TCPR2CNT</b></dt>
<dd>16
</dd>
<dt><b>TCPMINRTM</b></dt>
<dd>250 milliseconds
</dd>
<dt><b>TCPCLOTIMO</b></dt>
<dd>120 seconds
</dd>
<dt><b>TCPCNNMSG</b></dt>
<dd>*THRESHOLD
</dd>
<dt><b>UDPCKS</b></dt>
<dd>*YES
</dd>
<dt><b>IPPATHMTU</b></dt>
<dd>*YES, 10 minutes
</dd>
<dt><b>IPDTGFWD</b></dt>
<dd>*NO
</dd>
<dt><b>IPSRCRTG</b></dt>
<dd>*YES
</dd>
<dt><b>IPRSBTIMO</b></dt>
<dd>10 seconds
</dd>
<dt><b>IPTTL</b></dt>
<dd>64
</dd>
<dt><b>IPQOSENB</b></dt>
<dd>*NO
</dd>
<dt><b>IPDEADGATE</b></dt>
<dd>*YES, 2 minutes
</dd>
<dt><b>ARPTIMO</b></dt>
<dd>15 minutes
</dd>
<dt><b>ECN</b></dt>
<dd>*NO
</dd>
<dt><b>NFC</b></dt>
<dd>*YES, 300 seconds, 10MB
</dd>
<dt><b>LOGPCLERR</b></dt>
<dd>*NO
</dd>
</dl>
<p><b>Restriction:</b>
</p>
<ul>
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGTCPA.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="#CHGTCPA.TCPKEEPALV"><b>TCPKEEPALV</b></a></td>
<td valign="top">TCP keep alive</td>
<td valign="top">1-40320, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPURGPTR"><b>TCPURGPTR</b></a></td>
<td valign="top">TCP urgent pointer</td>
<td valign="top"><b><u>*SAME</u></b>, *BSD, *RFC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPRCVBUF"><b>TCPRCVBUF</b></a></td>
<td valign="top">TCP receive buffer size</td>
<td valign="top">512-8388608, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPSNDBUF"><b>TCPSNDBUF</b></a></td>
<td valign="top">TCP send buffer size</td>
<td valign="top">512-8388608, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPR1CNT"><b>TCPR1CNT</b></a></td>
<td valign="top">TCP R1 retransmission count</td>
<td valign="top">1-15, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPR2CNT"><b>TCPR2CNT</b></a></td>
<td valign="top">TCP R2 retransmission count</td>
<td valign="top">2-16, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPMINRTM"><b>TCPMINRTM</b></a></td>
<td valign="top">TCP minimum retransmit time</td>
<td valign="top">100-1000, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPCLOTIMO"><b>TCPCLOTIMO</b></a></td>
<td valign="top">TCP time-wait timeout</td>
<td valign="top">0-14400, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.TCPCNNMSG"><b>TCPCNNMSG</b></a></td>
<td valign="top">TCP close connection message</td>
<td valign="top"><b><u>*SAME</u></b>, *THRESHOLD, *ALL, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.UDPCKS"><b>UDPCKS</b></a></td>
<td valign="top">UDP checksum</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGTCPA.IPPATHMTU"><b>IPPATHMTU</b></a></td>
<td valign="top">Path MTU discovery</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *DFT, *NO<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enablement</td>
<td valign="top">
*YES</td>
</tr>
<tr>
<td valign="top">Element 2: Interval</td>
<td valign="top">
5-40320, *ONCE</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPDTGFWD"><b>IPDTGFWD</b></a></td>
<td valign="top">IP datagram forwarding</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPSRCRTG"><b>IPSRCRTG</b></a></td>
<td valign="top">IP source routing</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPRSBTIMO"><b>IPRSBTIMO</b></a></td>
<td valign="top">IP reassembly time-out</td>
<td valign="top">5-120, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPTTL"><b>IPTTL</b></a></td>
<td valign="top">IP time to live (hop limit)</td>
<td valign="top">1-255, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPQOSENB"><b>IPQOSENB</b></a></td>
<td valign="top">IP QoS enablement</td>
<td valign="top"><b><u>*SAME</u></b>, *TOS, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGTCPA.IPDEADGATE"><b>IPDEADGATE</b></a></td>
<td valign="top">IP dead gateway detection</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *DFT, *NO<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enablement</td>
<td valign="top">
*YES</td>
</tr>
<tr>
<td valign="top">Element 2: Interval</td>
<td valign="top">
1-60</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.ARPTIMO"><b>ARPTIMO</b></a></td>
<td valign="top">ARP cache timeout</td>
<td valign="top">1-1440, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.ECN"><b>ECN</b></a></td>
<td valign="top">Enable ECN</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGTCPA.NFC"><b>NFC</b></a></td>
<td valign="top">Network file cache</td>
<td valign="top">Single values: *DFT, *CLEAR<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enablement</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top">Element 2: Cached file timeout</td>
<td valign="top">
30-604800, <b><u>*SAME</u></b>, *NOMAX</td>
</tr>
<tr>
<td valign="top">Element 3: Cache size</td>
<td valign="top">
10-100000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.LOGPCLERR"><b>LOGPCLERR</b></a></td>
<td valign="top">Log protocol errors</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPQOSBCH"><b>IPQOSBCH</b></a></td>
<td valign="top">IP QoS datagram batching</td>
<td valign="top"><b><u>*SAME</u></b>, *NORMAL, *MINDELAY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPA.IPQOSTMR"><b>IPQOSTMR</b></a></td>
<td valign="top">IP QoS timer resolution</td>
<td valign="top">5-5000, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGTCPA.TCPKEEPALV"></a>
<h3>TCP keep alive (TCPKEEPALV)</h3>
<p>Specifies the amount of time, in minutes, that TCP waits before sending out a probe to the other side of a connection. The probe is sent when the connection is otherwise idle, even when there is no data to be sent.
</p>
<p>The transmission of keep-alive packets is controlled by individual sockets applications through use of the SO_KEEPALIVE socket option. For more information see the Sockets Programming information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The keep-alive time interval value does not change from its current setting.
</dd>
<dt><b>*DFT</b></dt>
<dd>The keep-alive time interval value of 120 minutes is used.
</dd>
<dt><b><i>1-40320</i></b></dt>
<dd>Specify a keep-alive time interval in minutes. Valid values range from 1 through 40320 minutes (28 days).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPURGPTR"></a>
<h3>TCP urgent pointer (TCPURGPTR)</h3>
<p>Specifies which convention to follow when interpreting which byte the urgent pointer in the TCP header points to. The urgent pointer in the TCP header points to either the byte immediately following the last byte of urgent data (BSD convention) or the last byte of the urgent data (RFC convention).
</p>
<p>
<b>Note: </b>This value must be consistent between the local and remote ends of a TCP connection. Socket applications that use this value must use it consistently between the client and server applications. This value is set on a system basis. All applications using this system will use this value.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The urgent pointer value does not change from its current setting.
</dd>
<dt><b>*BSD</b></dt>
<dd>Use the BSD defined convention. The TCP urgent pointer points to the byte immediately following the last byte of urgent data. This is the initial value.
</dd>
<dt><b>*RFC</b></dt>
<dd>Use the RFC defined convention. The TCP urgent pointer points to the last byte of the urgent data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPRCVBUF"></a>
<h3>TCP receive buffer size (TCPRCVBUF)</h3>
<p>Specifies what to allocate for the default receive buffer size. The TCP receive window size is based on this value. Decreasing this value decreases the amount of data that the remote system can send before being read by the local application. Decreasing this value may improve performance in situations where many retransmissions occur due to the overrunning of a network adapter.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>This value is also used by the User Datagram Protocol (UDP) as its default receive buffer size.
</li>
<li>This value is also used as the default receive buffer size by IP over SNA processing.
</li>
<li>Setting this parameter does not guarantee the size of the TCP receive buffer. This is the default buffer size that is used for initial TCP connection negotiations. An individual application can override this value by using the SO_RCVBUF socket option. For more information see the Sockets Programming information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</li>
</ol>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP receive buffer size does not change from its current value.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default TCP receive buffer size of 8192 (8K) is used.
</dd>
<dt><b><i>512-8388608</i></b></dt>
<dd>Specify the number of bytes to be used for the TCP receive buffer size.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPSNDBUF"></a>
<h3>TCP send buffer size (TCPSNDBUF)</h3>
<p>Specifies the TCP send buffer size. This parameter informs TCP what to use for the default send buffer size. The TCP send buffer size provides a limit on the number of outgoing bytes that are buffered by TCP. Once this limit is reached, attempts to send additional bytes may result in the application blocking until the number of outgoing bytes buffered drops below this limit. The number of outgoing bytes buffered is decremented when the remote system acknowledges the data sent.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>This value is used also as the default send buffer size by IP over SNA processing.
</li>
<li>UDP does not have a configurable send buffer size.
</li>
<li>Setting this parameter does not guarantee the size of the TCP send buffer. This is the default buffer size that is used for initial TCP connection negotiations. An individual application can override this value by using the SO_SNDBUF socket option. For more information see the Sockets Programming information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</li>
</ol>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP send buffer size does not change from its current value.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default TCP send buffer size of 8192 (8K) is used.
</dd>
<dt><b><i>512-8388608</i></b></dt>
<dd>Specify the number of bytes to be used for the TCP send buffer size.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPR1CNT"></a>
<h3>TCP R1 retransmission count (TCPR1CNT)</h3>
<p>Specifies the TCP R1 retransmission count value. This parameter is a counter that specifies the number of TCP retransmissions that will be attempted before TCP requests a different network route from IP.
</p>
<p>
<b>Note: </b>The R1 retransmission count value must be less than the R2 retransmission count value.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP R1 retransmission count does not change from its current setting.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default TCP R1 retransmission count value of 3 is used.
</dd>
<dt><b><i>1-15</i></b></dt>
<dd>Specify the TCP R1 retransmission count value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPR2CNT"></a>
<h3>TCP R2 retransmission count (TCPR2CNT)</h3>
<p>Specifies the TCP R2 retransmission count value. This parameter is a counter that specifies the number of TCP retransmissions that will be attempted before TCP assumes that the connection has been lost and stops retransmitting.
</p>
<p>
<b>Note: </b>The R2 retransmission count value must be greater than the R1 retransmission count value.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP R2 retransmission count does not change from its current setting.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default TCP R2 retransmission count value of 16 is used.
</dd>
<dt><b><i>2-16</i></b></dt>
<dd>Specify the TCP R2 retransmission count value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPMINRTM"></a>
<h3>TCP minimum retransmit time (TCPMINRTM)</h3>
<p>Specifies the TCP minimum retransmit time value which is the lowest amount of time (expressed in milliseconds) to elapse before TCP decides that a transmitted packet is lost and needs to be sent again. After each unsuccessful attempt to transmit a packet, this value will be doubled until it reaches a maximum value of 2 minutes.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP minimum retransmit time value does not change from its current value.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default TCP minimum retransmit time value of 250 milliseconds is used.
</dd>
<dt><b><i>100-1000</i></b></dt>
<dd>Specify the number of milliseconds to be used for the TCP minimum retransmit time value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPCLOTIMO"></a>
<h3>TCP time-wait timeout (TCPCLOTIMO)</h3>
<p>This parameter indicates the amount of time, in seconds, for which a socket pair (client IP address and port, server IP address and port) cannot be reused after a connection is closed.
</p>
<p>
<b>Note: </b>Setting the TCP time wait timeout value to 0 means that a timer will not be used.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP time wait timeout value does not change from its current setting.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default TCP time wait timeout value of 120 seconds is used.
</dd>
<dt><b><i>0-14400</i></b></dt>
<dd>Specify the number of seconds to be used for the TCP time wait timeout value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.TCPCNNMSG"></a>
<h3>TCP close connection message (TCPCNNMSG)</h3>
<p>Specifies whether abnormally closed TCP connections will be logged via messages to the QTCP message queue. TCP connections could be abnormally closed for the following reasons:
</p>
<ul>
<li>TCP connection closed due to the 10 minute Close_Wait_timeout.
</li>
<li>TCP connection closed due to the R2 retry threshold being exceeded.
</li>
<li>TCP connection closed due to the keepalive time-out value being exceeded.
</li>
</ul>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The closed TCP connection message value does not change from its current value.
</dd>
<dt><b>*THRESHOLD</b></dt>
<dd>At most, one abnormally closed TCP connection message per minute will be logged. TCPCNNMSG(*THRESHOLD) is the initial value.
</dd>
<dt><b>*ALL</b></dt>
<dd>All abnormally closed TCP connections will be logged. Note that there are some conditions that could cause MANY closed connection messages to be logged at the same time.
</dd>
<dt><b>*NONE</b></dt>
<dd>Abnormally closed TCP connections will not be logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.UDPCKS"></a>
<h3>UDP checksum (UDPCKS)</h3>
<p>Specifies whether UDP processing should generate and validate checksums. It is strongly recommended that you specify UDPCKS(*YES) to use UDP checksum processing. If you are concerned about obtaining the best possible performance and are not concerned with the protection provided by UDP checksum processing, specify UDPCKS(*NO).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The status of checksum protection for UDP data does not change from its current value.
</dd>
<dt><b>*YES</b></dt>
<dd>Checksum protection is provided for UDP data. UDPCKS(*YES) is the initial value.
</dd>
<dt><b>*NO</b></dt>
<dd>Checksum protection is not provided for UDP data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPPATHMTU"></a>
<h3>Path MTU discovery (IPPATHMTU)</h3>
<p>Specifies whether the Path Maximum Transmission Unit (MTU) discovery function will be enabled on this system. Path MTU discovery allows for dynamic MTU adjustment, on a per connection basis, in order to maximize network throughput.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The path MTU discovery enablement status and path MTU discovery time interval do not change from their current values.
</dd>
<dt><b>*NO</b></dt>
<dd>Path MTU discovery is not enabled for this system.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default path MTU discovery enablement status is *YES and the default path MTU discovery time interval is 10 minutes.
</dd>
</dl>
<p><b>Element 1: Enablement</b>
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>Path MTU discovery is enabled for this system.
</dd>
</dl>
<p><b>Element 2: Interval</b>
</p>
<p>Specifies the amount of time, in minutes, that the TCP/IP protocol stack will cache the results of a path MTU discovery. When the time interval is exceeded, the path MTU is rediscovered.
</p>
<dl>
<dt><b>*ONCE</b></dt>
<dd>Once a path MTU is discovered, it is not recalculated.
</dd>
<dt><b><i>5-40320</i></b></dt>
<dd>Specify a path MTU discovery interval in minutes. Valid values range from 5 through 40320 minutes (28 days).
<p><b>Notes:</b>
</p>
<ol>
<li>In order for the path MTU discovery interval element to be specified, the first element must be set to *YES.
</li>
<li>Path MTU discovery, if enabled, is only done over routes with a MTU value of *IFC.
</li>
<li>The use of Path MTU discovery for UDP applications is controlled by individual sockets applications through the use of the SO_PATHMTU socket option.
</li>
</ol>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPDTGFWD"></a>
<h3>IP datagram forwarding (IPDTGFWD)</h3>
<p>Specifies whether the IP layer forwards Internet Protocol (IP) datagrams between different networks. It specifies whether the IP layer is acting as a gateway.
</p>
<p>
<b>Note: </b>IP does not forward datagrams between interfaces on the same subnet.
</p>
<p>The i5/OS implementation of TCP/IP does not include full gateway function as defined in RFC1009. A subset of the gateway functions are supported. One of the gateway functions supported is IP datagram forwarding capabilities.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The IP datagram forwarding status does not change from its current value.
</dd>
<dt><b>*NO</b></dt>
<dd>IP datagrams are not forwarded. IPDTGFWD(*NO) is the initial value.
</dd>
<dt><b>*YES</b></dt>
<dd>IP datagrams are forwarded.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPSRCRTG"></a>
<h3>IP source routing (IPSRCRTG)</h3>
<p>The default setting for IP Source Routing (IPSRCRTG) is *YES or on. Some firewalls will not pass datagrams that have IP Source Routing switched on. This parameter allows you to switch IP Source Routing on or off as required for your situation.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If the IP Source Routing value was previously set, that setting will remain in effect. If the IP Source Routing parameter was not previously set, use of the *SAME value will default to the *YES or on value.
</dd>
<dt><b>*NO</b></dt>
<dd>The value *NO switches IP Source Routing off.
</dd>
<dt><b>*YES</b></dt>
<dd>The value *YES switches IP Source Routing on. IPSRCRTG(*YES) is the initial value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPRSBTIMO"></a>
<h3>IP reassembly time-out (IPRSBTIMO)</h3>
<p>Specifies, in seconds, the IP datagram reassembly time. If this time is exceeded, a partially reassembled datagram is discarded and an ICMP time exceeded message is sent to the source host.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The assembly time does not change from its current setting.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default assembly time of 10 seconds is used.
</dd>
<dt><b><i>5-120</i></b></dt>
<dd>Specify the number of seconds to be used for an IP reassembly time.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPTTL"></a>
<h3>IP time to live (hop limit) (IPTTL)</h3>
<p>Specifies the default TTL value. The IP datagram time-to-live value specifies a relative limit on the number of hops across which an IP datagram remains active. The time-to-live value acts as a "hop count" that is decremented by each gateway to prevent internet routing loops.
</p>
<p>
<b>Note: </b>Even though this parameter is specified as a time-to-live value, it is not used as a time value. It is used as a counter. The standard description is <i>time to live</i> as specified in RFCs.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The time-to-live value does not change from its current setting.
<p>
<b>Note: </b>This default IP datagram time-to-live value is not used for datagrams sent to an IP multicast group address. The default IP datagram time-to-live value for datagram sent to an IP multicast group is always 1 as specified by the Internet standards. Individual multicast applications may override this default using the IP_MULTICAST_TTL socket option.
</p>
</dd>
<dt><b>*DFT</b></dt>
<dd>The default time-to-live value of 64 is used.
</dd>
<dt><b><i>1-255</i></b></dt>
<dd>Specify an IP time-to-live value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPQOSENB"></a>
<h3>IP QoS enablement (IPQOSENB)</h3>
<p>Specifies whether Quality of Service (QoS), IP Type of Service (TOS), or neither of the two are in use.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The QoS enablement value does not change from its current value.
</dd>
<dt><b>*TOS</b></dt>
<dd>Use TOS byte in the IP header.
</dd>
<dt><b>*YES</b></dt>
<dd>Use QoS.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not use QoS or TOS. This is the initial value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPDEADGATE"></a>
<h3>IP dead gateway detection (IPDEADGATE)</h3>
<p>Specifies whether dead gateway detection will be enabled on this system. Dead gateway detection is a mechanism which involves polling all attached gateways. If no reply is received to the polls then all routes using that gateway are inactivated. Gateways marked as dead will continue to be polled and when they respond again all routes using that gateway will be reactivated.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The dead gateway detection enablement status and dead gateway interval do not change from their current values.
</dd>
<dt><b>*NO</b></dt>
<dd>Dead gateway detection is not enabled for this system.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default dead gateway detection enablement status is *YES and the default dead gateway detection time interval is 2 minutes.
</dd>
</dl>
<p><b>Element 1: Enablement</b>
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>Dead gateway detection is enabled for this system.
</dd>
</dl>
<p><b>Element 2: Interval</b>
</p>
<p>Specifies the amount of time, in minutes, that the TCP/IP protocol stack will wait between dead gateway detection polls. When the time interval is exceeded, the gateways are polled.
</p>
<dl>
<dt><b><i>1-60</i></b></dt>
<dd>Specify a dead gateway detection interval in minutes.
<p><b>Notes:</b>
</p>
<ol>
<li>In order for the dead gateway detection interval element to be specified, the first element must be set to *YES.
</li>
</ol>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.ARPTIMO"></a>
<h3>ARP cache timeout (ARPTIMO)</h3>
<p>Specifies, in minutes, the ARP cache time-out value. The time-out value's purpose is to flush out-of-date cache entries from the ARP cache.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default ARP cache time-out interval does not change from its current setting.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default ARP cache time-out interval of 15 minutes is used.
</dd>
<dt><b><i>1-1440</i></b></dt>
<dd>Specify an ARP cache time-out interval in minutes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.ECN"></a>
<h3>Enable ECN (ECN)</h3>
<p>Specifies whether explicit congestion notification (ECN) is enabled.
</p>
<p>If ECN is enabled, routers can notify end-nodes of congestion before queues overflow. Without ECN, end-nodes can only detect congestion when packets are lost due to queues overflowing.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>ECN does not change from its current value.
</dd>
<dt><b>*NO</b></dt>
<dd>ECN is not enabled for the system.
</dd>
<dt><b>*YES</b></dt>
<dd>ECN is enabled for the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.NFC"></a>
<h3>Network file cache (NFC)</h3>
<p>Specifies whether the Network File Cache (NFC) function will be enabled on this system. The Network File Cache is used for the support of FRCA (Fast Response Cache Accelerator). FRCA dramatically improves the performance of serving non-secure static content by Web and other TCP servers.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*DFT</b></dt>
<dd>The default NFC enablement status is *YES with a default cache size of 10MB and a cache timeout of 300 seconds.
</dd>
<dt><b>*CLEAR</b></dt>
<dd>Specifies to immediately clear the entire network file cache. After the cache is cleared, the previous Network File Cache values will be retained.
</dd>
</dl>
<p><b>Element 1: Enablement</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The NFC enablement status does not change from its current value.
</dd>
<dt><b>*YES</b></dt>
<dd>The Network File Cache is enabled for this system.
</dd>
<dt><b>*NO</b></dt>
<dd>The Network File Cache is not enabled for this system.
</dd>
</dl>
<p><b>Element 2: Cached file timeout</b>
</p>
<p>Specifies the maximum amount of time, in seconds, that a file can be cached in the Network File Cache. This ensures that a file is refreshed at a regular interval.
</p>
<p><b>Note:</b> A cache time can be specified when NFC is not enabled; however, the cache time will not take affect until NFC is enabled.
</p>
<dl>
<dt><b><u>SAME</u></b></dt>
<dd>The cached file timeout does not change from its current value.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>The cached file entries will NOT timeout.
</dd>
<dt><b><i>30-604800</i></b></dt>
<dd>Specify a file cache time in seconds. The maximum value of 604800 seconds equals 1 week.
</dd>
</dl>
<p><b>Element 3: Cache size</b>
</p>
<p>Specifies the maximum amount of storage that may be used by the NFC for the entire system. This is the accumulative storage used by all TCP servers for loading files.
</p>
<p><b>Note:</b> A cache time can be specified when NFC is not enabled; however, the cache size will not take affect until NFC is enabled.
</p>
<dl>
<dt><b><u>SAME</u></b></dt>
<dd>The cache file size does not change from its current value.
</dd>
<dt><b><i>10-100000</i></b></dt>
<dd>Specify the number of megabytes to be used for the file cache size.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.LOGPCLERR"></a>
<h3>Log protocol errors (LOGPCLERR)</h3>
<p>Specifies log protocol errors. This parameter enables a user to log protocol errors that occur during the processing of TCP/IP data. These TCP/IP stack layer functions use this parameter to determine if they log protocol-specific errors: IP, ICMP, ARP, and NAM. TCP and UDP do not log protocol errors.
</p>
<p>The 7004 error reference code is logged when the LOGPCLERR(*YES) option is specified and inbound datagrams are silently discarded. Silently discarded means that an ICMP message is not returned to the originating host when a datagram is discarded because of header errors. Examples of such datagrams include those with invalid checksums and invalid destination addresses.
</p>
<p>The error reference code is for information only. No action should be taken as a result of this error reference code. It is generated to assist with remote device or TCP/IP network problem analysis.
</p>
<p>
<b>Note: </b>These error conditions cannot be processed using an APAR.
</p>
<p>The log protocol errors parameter should be used when error conditions require the logging of TCP/IP data, such as datagrams, to determine network problems.
</p>
<p>The data is logged in the system error log. This error log is available through the Start System Service Tools (STRSST) command.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The status of logging protocol errors does not change from its current value. LOGPCLERR(*NO) is the shipped value.
</dd>
<dt><b>*NO</b></dt>
<dd> Protocol errors are not logged.
</dd>
<dt><b>*YES</b></dt>
<dd>Protocol errors are logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPQOSBCH"></a>
<h3>IP QoS datagram batching (IPQOSBCH)</h3>
<p>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of i5/OS.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPA.IPQOSTMR"></a>
<h3>IP QoS timer resolution (IPQOSTMR)</h3>
<p>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of i5/OS.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTCPA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Using TCP/IP with UDP Checksum Verification</b>
</p>
<p>
<pre>
CHGTCPA UDPCKS(*YES)
</pre>
</p>
<p>This command indicates that UDP checksumming is done for UDP data.
</p>
<p><b>Example 2: Using Selected IP Parameters</b>
</p>
<p>
<pre>
CHGTCPA IPDTGFWD(*YES) IPTTL(5) IPRSBTIMO(60)
</pre>
</p>
<p>This command indicates that TCP/IP has the following characteristics:
</p>
<ul>
<li>IP datagrams are forwarded between interfaces on different subnets.
</li>
<li>IP time to live (TTL) is set to 5.
</li>
<li>IP reassembly time-out is set to 60 seconds.
</li>
</ul>
<p><b>Example 3: Using Selected TCP Parameters</b>
</p>
<p>
<pre>
CHGTCPA TCPKEEPALV(100) TCPURGPTR(*RFC) TCPRCVBUF(16000)
</pre>
</p>
<p>This command indicates the following:
</p>
<ul>
<li>TCP probes the other side of a connection every 100 minutes.
</li>
<li>The TCP urgent pointer in the TCP header points to the last byte of the urgent data (RFC convention).
</li>
<li>The TCP default receive buffer size is 16000 bytes.
</li>
</ul>
<p><b>Example 4: Turning Off IP Source Routing</b>
</p>
<p>
<pre>
CHGTCPA IPSRCRTG(*NO)
</pre>
</p>
<p>This command indicates that IP source routing will no longer be allowed. Any IP datagrams found with IP source routing turned on will be rejected.
</p>
<p><b>Example 5: Changing R1/R2 Counts and QoS Attributes</b>
</p>
<p>
<pre>
CHGTCPA TCPR1CNT(3) TCPR2CNT(10) TCPCLOTIMO(300)
IPQOSENB(*YES) IPDEADGATE(*YES)
</pre>
</p>
<p>This command indicates the following:
</p>
<ul>
<li>TCP is set to request a different network route after 3 unacknowledged transmissions.
</li>
<li>TCP is set to stop retransmitting an unacknowledged packet after 10 unsuccessful attempts.
</li>
<li>TCP is set to wait 300 seconds (5 minutes) before reusing a closed connection socket pair.
</li>
<li>Quality of Service (QoS) is enabled.
</li>
<li>Dead gateway detection is enabled.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTCPA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9801</b></dt>
<dd>Object &amp;2 in library &amp;3 not found.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9803</b></dt>
<dd>Cannot allocate object &amp;2 in library &amp;3.
</dd>
<dt><b>CPF9807</b></dt>
<dd>One or more libraries in library list deleted.
</dd>
<dt><b>CPF9808</b></dt>
<dd>Cannot allocate one or more libraries on library list.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF9830</b></dt>
<dd>Cannot assign library &amp;1.
</dd>
<dt><b>TCP1D03</b></dt>
<dd>&amp;1 member record length not correct.
</dd>
<dt><b>TCP1D04</b></dt>
<dd>Error occurred processing member &amp;1 of &amp;2/&amp;3.
</dd>
<dt><b>TCP15A3</b></dt>
<dd>TCP/IP attributes not changed.
</dd>
<dt><b>TCP15A5</b></dt>
<dd>Error accessing member &amp;3
</dd>
<dt><b>TCP15A6</b></dt>
<dd>Attribute file keyword &amp;4 missing
</dd>
<dt><b>TCP15A7</b></dt>
<dd>Attribute file keyword &amp;4 not valid.
</dd>
<dt><b>TCP8050</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
<dt><b>TCP9503</b></dt>
<dd>File &amp;3 in library &amp;2 not available.
</dd>
<dt><b>TCP9999</b></dt>
<dd>Internal system error in program &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>