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

531 lines
17 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>Change NetBIOS Description (CHGNTBD)</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="CHGNTBD.Top_Of_Page"></a>
<h2>Change NetBIOS Description (CHGNTBD)</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="#CHGNTBD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGNTBD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGNTBD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGNTBD"></a>
<p>The Change NetBIOS Description (CHGNTBD) command changes a NetBIOS description object. More information about using this command is in the Communications Configuration book, SC41-5401.
</p>
<p>
<b>Note: </b>Changes to this object while using a configuration object, such as a network server description that is varied on, do not affect that object until it is varied off and back on.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGNTBD.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="#CHGNTBD.NTBD"><b>NTBD</b></a></td>
<td valign="top">NetBIOS description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.FULLBUFDTG"><b>FULLBUFDTG</b></a></td>
<td valign="top">Full buffer datagrams</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.ADPWDWITV"><b>ADPWDWITV</b></a></td>
<td valign="top">Adaptive window interval</td>
<td valign="top">0-65535, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.MAXWDWERR"><b>MAXWDWERR</b></a></td>
<td valign="top">Maximum window errors</td>
<td valign="top">0-10, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.MAXRCVDATA"><b>MAXRCVDATA</b></a></td>
<td valign="top">Maximum receive data size</td>
<td valign="top">512-16384, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.INACTTMR"><b>INACTTMR</b></a></td>
<td valign="top">Inactivity timer</td>
<td valign="top">1000-65535, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.RSPTMR"><b>RSPTMR</b></a></td>
<td valign="top">Response timer</td>
<td valign="top">50-65535, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.ACKTMR"><b>ACKTMR</b></a></td>
<td valign="top">Acknowledgement timer</td>
<td valign="top">50-65535, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.MAXIN"><b>MAXIN</b></a></td>
<td valign="top">Maximum outstanding receives</td>
<td valign="top">1-127, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.MAXOUT"><b>MAXOUT</b></a></td>
<td valign="top">Maximum outstanding transmits</td>
<td valign="top">1-127, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.QRYTMR"><b>QRYTMR</b></a></td>
<td valign="top">Query timeout</td>
<td valign="top">500-10000, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.NTBRTY"><b>NTBRTY</b></a></td>
<td valign="top">NetBIOS retry</td>
<td valign="top">1-50, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.ALWMULTACK"><b>ALWMULTACK</b></a></td>
<td valign="top">Allow multiple acknowledgement</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.PREBLTPKT"><b>PREBLTPKT</b></a></td>
<td valign="top">Prebuilt message packets</td>
<td valign="top">1-200, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.PKTRESTART"><b>PKTRESTART</b></a></td>
<td valign="top">Packet confirms for restart</td>
<td valign="top">0-9999, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.DLCRTY"><b>DLCRTY</b></a></td>
<td valign="top">DLC retries</td>
<td valign="top">1-65535, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.ETHSTD"><b>ETHSTD</b></a></td>
<td valign="top">Ethernet standard</td>
<td valign="top"><b><u>*SAME</u></b>, *IEEE8023, *ETHV2</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNTBD.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGNTBD.NTBD"></a>
<h3>NetBIOS description (NTBD)</h3>
<p>Specifies the name of the NetBIOS description being changed.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.FULLBUFDTG"></a>
<h3>Full buffer datagrams (FULLBUFDTG)</h3>
<p>Specifies whether to request the full transmit buffer size for datagrams.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The full transmit buffer size is requested.
</dd>
<dt><b>*NO</b></dt>
<dd>The full transmit buffer size is not requested. The length of a datagram is equal to the transmit buffer size minus the size of the overhead, for a maximum of 512 bytes. Large messages are truncated.
<p>
<b>Note: </b>The size of the overhead is the sum of the sizes of the NetBIOS header (44 bytes), the LAN header (a maximum of 36 bytes), and the buffer hold overhead (a maximum of 6 bytes).
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.ADPWDWITV"></a>
<h3>Adaptive window interval (ADPWDWITV)</h3>
<p>Specifies the time, in milliseconds, between runs of the adaptive window algorithm. For each link, this algorithm is used to change the values on the MAXIN and MAXOUT parameters to match the values set on the remote workstation using NetBIOS protocol. The algorithm considers the conditions of the link, including adapter receive buffers and transmission load, when changing the values.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>adaptive-window-interval</i></b></dt>
<dd>Specify the time between algorithm runs, in milliseconds. Valid values range from 0 through 65535.
<p>
<b>Note: </b>The value 0 disables the algorithm.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.MAXWDWERR"></a>
<h3>Maximum window errors (MAXWDWERR)</h3>
<p>Specifies the number of dropped packets the adaptive window algorithm allows before decreasing the value on the MAXOUT parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>window-errors</i></b></dt>
<dd>Specify the number of window errors allowed. Valid values range from 0 through 10.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.MAXRCVDATA"></a>
<h3>Maximum receive data size (MAXRCVDATA)</h3>
<p>Specifies the maximum data size in any frame that can be received in a session. The partner in the transmission limits the size to the smaller of this specified size, or the size available in the partner's transmit buffer. NetBIOS takes into account the maximum size that is forwarded by bridges in the path.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>maximum-receive-data-size</i></b></dt>
<dd>Specify the maximum data size that can be received, in bytes. Valid values range from 512 through 16384.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.INACTTMR"></a>
<h3>Inactivity timer (INACTTMR)</h3>
<p>Specifies the amount of time that a link can be inactive before the NetBIOS protocol driver checks to verify that the link is operational.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>inactivity-timer</i></b></dt>
<dd>Specify the amount of time to wait for activity, in milliseconds. Valid values range from 1000 through 65535.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.RSPTMR"></a>
<h3>Response timer (RSPTMR)</h3>
<p>Specifies the amount of time to wait before again transmitting a link-level frame when no acknowledgement is received from the previous transmission.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>response-timer</i></b></dt>
<dd>Specify the amount of time to wait, in milliseconds. Valid values range from 50 through 65535.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.ACKTMR"></a>
<h3>Acknowledgement timer (ACKTMR)</h3>
<p>Specifies the amount of time the NetBIOS protocol driver delays acknowledging a received frame, when the number of frames sent is less than the maximum specified on the MAXIN parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>acknowledgement-timer</i></b></dt>
<dd>Specify the amount of time to delay, in milliseconds. Valid values range from 50 through 65535.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.MAXIN"></a>
<h3>Maximum outstanding receives (MAXIN)</h3>
<p>Specifies the maximum number of NetBIOS messages packets that can be received before sending an acknowledgement.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>maximum-receives</i></b></dt>
<dd>Specify the number of packets to receive. Valid values range from 1 through 127.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.MAXOUT"></a>
<h3>Maximum outstanding transmits (MAXOUT)</h3>
<p>Specifies the maximum number of NetBIOS messages packets that can be sent before expecting an acknowledgement.
</p>
<p>
<b>Note: </b>This parameter is used only when ADPWDWITV(0) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>maximum-transmits</i></b></dt>
<dd>Specify the number of packets to send. Valid values range from 1 through 127.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.QRYTMR"></a>
<h3>Query timeout (QRYTMR)</h3>
<p>Specifies the time, in milliseconds, to wait between transmission retry attempts.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>query-timer</i></b></dt>
<dd>Specify a value in the range of 500 through 10000 milliseconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.NTBRTY"></a>
<h3>NetBIOS retry (NTBRTY)</h3>
<p>Specifies the number of transmission retries that are attempted at the NetBIOS level before assuming that the receiving party is not present.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>NetBIOS-retry</i></b></dt>
<dd>Specify a value in the range of 1 through 50 attempts.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.ALWMULTACK"></a>
<h3>Allow multiple acknowledgement (ALWMULTACK)</h3>
<p>Specifies whether acknowledgements for received data can be combined with requests for data.
</p>
<p>
<b>Note: </b>When the NetBIOS protocol driver sends and receives acknowledgements with incoming data, LAN performance is improved.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>` The acknowledgements can be combined with data requests.
<p>
<b>Note: </b>Both parties to the transmission must support combining acknowledgements with data requests or this value is ignored.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>The acknowledgements cannot be combined with data requests.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.PREBLTPKT"></a>
<h3>Prebuilt message packets (PREBLTPKT)</h3>
<p>Specifies the number of NetBIOS message packets that are prebuilt for each session.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>prebuilt-packets</i></b></dt>
<dd>Specify a value in the range of 1 through 200 message packets.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.PKTRESTART"></a>
<h3>Packet confirms for restart (PKTRESTART)</h3>
<p>Specifies the number of transmission confirmations that must be received before sending additional packets when an out-of-resource condition occurs. The NetBIOS protocol driver stops sending packets when an out-of-resource condition is received from a port.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>packet-restart</i></b></dt>
<dd>Specify a value in the range of 0 through 9999 confirmations.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.DLCRTY"></a>
<h3>DLC retries (DLCRTY)</h3>
<p>Specifies the number of additional transmission attempts that will be made before assuming that the receiving data link control (DLC) layer is not responding.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>DLC-retries</i></b></dt>
<dd>Specify a value in the range of 1 through 65535 attempts.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.ETHSTD"></a>
<h3>Ethernet standard (ETHSTD)</h3>
<p>Specifies the Ethernet standard frame type that is used for NetBIOS communication.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*IEEE8023</b></dt>
<dd>IEEE 802.3 frames are used.
</dd>
<dt><b>*ETHV2</b></dt>
<dd>Ethernet Version 2 frames are used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNTBD.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the NetBIOS description.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*BLANK</b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNTBD.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGNTBD NTBD(MYNETBIOS) ACKTMR(3000)
</pre>
</p>
<p>This command changes a NetBIOS description named MYNETBIOS to delay acknowledging a received frame for 3000 milliseconds (3 seconds) when the number of received packets is less than the value specified on the MAXIN parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNTBD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF27A2</b></dt>
<dd>NetBIOS description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNTBD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>