Change NetBIOS Description (CHGNTBD)

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.

Note: 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.

Parameters

Keyword	Description	Choices	Notes
NTBD	NetBIOS description	Name	Required, Key, Positional 1
FULLBUFDTG	Full buffer datagrams	SAME, YES, *NO	Optional, Positional 2
ADPWDWITV	Adaptive window interval	0-65535, *SAME	Optional
MAXWDWERR	Maximum window errors	0-10, *SAME	Optional
MAXRCVDATA	Maximum receive data size	512-16384, *SAME	Optional
INACTTMR	Inactivity timer	1000-65535, *SAME	Optional
RSPTMR	Response timer	50-65535, *SAME	Optional
ACKTMR	Acknowledgement timer	50-65535, *SAME	Optional
MAXIN	Maximum outstanding receives	1-127, *SAME	Optional
MAXOUT	Maximum outstanding transmits	1-127, *SAME	Optional
QRYTMR	Query timeout	500-10000, *SAME	Optional
NTBRTY	NetBIOS retry	1-50, *SAME	Optional
ALWMULTACK	Allow multiple acknowledgement	SAME, YES, *NO	Optional
PREBLTPKT	Prebuilt message packets	1-200, *SAME	Optional
PKTRESTART	Packet confirms for restart	0-9999, *SAME	Optional
DLCRTY	DLC retries	1-65535, *SAME	Optional
ETHSTD	Ethernet standard	SAME, IEEE8023, *ETHV2	Optional
TEXT	Text 'description'	Character value, SAME, BLANK	Optional

Top

Full buffer datagrams (FULLBUFDTG)

Specifies whether to request the full transmit buffer size for datagrams.

*SAME: The value does not change.

*YES: The full transmit buffer size is requested.
*NO: 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.
Note: 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).

Adaptive window interval (ADPWDWITV)

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.

*SAME: The value does not change.

adaptive-window-interval: Specify the time between algorithm runs, in milliseconds. Valid values range from 0 through 65535.
Note: The value 0 disables the algorithm.

Maximum window errors (MAXWDWERR)

Specifies the number of dropped packets the adaptive window algorithm allows before decreasing the value on the MAXOUT parameter.

*SAME: The value does not change.

window-errors: Specify the number of window errors allowed. Valid values range from 0 through 10.

Maximum receive data size (MAXRCVDATA)

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.

*SAME: The value does not change.

maximum-receive-data-size: Specify the maximum data size that can be received, in bytes. Valid values range from 512 through 16384.

Inactivity timer (INACTTMR)

Specifies the amount of time that a link can be inactive before the NetBIOS protocol driver checks to verify that the link is operational.

*SAME: The value does not change.

inactivity-timer: Specify the amount of time to wait for activity, in milliseconds. Valid values range from 1000 through 65535.

Response timer (RSPTMR)

Specifies the amount of time to wait before again transmitting a link-level frame when no acknowledgement is received from the previous transmission.

*SAME: The value does not change.

response-timer: Specify the amount of time to wait, in milliseconds. Valid values range from 50 through 65535.

Acknowledgement timer (ACKTMR)

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.

*SAME: The value does not change.

acknowledgement-timer: Specify the amount of time to delay, in milliseconds. Valid values range from 50 through 65535.

Maximum outstanding receives (MAXIN)

Specifies the maximum number of NetBIOS messages packets that can be received before sending an acknowledgement.

*SAME: The value does not change.

maximum-receives: Specify the number of packets to receive. Valid values range from 1 through 127.

Maximum outstanding transmits (MAXOUT)

Specifies the maximum number of NetBIOS messages packets that can be sent before expecting an acknowledgement.

Note: This parameter is used only when ADPWDWITV(0) is specified.

*SAME: The value does not change.

maximum-transmits: Specify the number of packets to send. Valid values range from 1 through 127.

Query timeout (QRYTMR)

Specifies the time, in milliseconds, to wait between transmission retry attempts.

*SAME: The value does not change.

query-timer: Specify a value in the range of 500 through 10000 milliseconds.

NetBIOS retry (NTBRTY)

Specifies the number of transmission retries that are attempted at the NetBIOS level before assuming that the receiving party is not present.

*SAME: The value does not change.

NetBIOS-retry: Specify a value in the range of 1 through 50 attempts.

Allow multiple acknowledgement (ALWMULTACK)

Specifies whether acknowledgements for received data can be combined with requests for data.

Note: When the NetBIOS protocol driver sends and receives acknowledgements with incoming data, LAN performance is improved.

*SAME: The value does not change.

*YES: ` The acknowledgements can be combined with data requests.
Note: Both parties to the transmission must support combining acknowledgements with data requests or this value is ignored.
*NO: The acknowledgements cannot be combined with data requests.

Prebuilt message packets (PREBLTPKT)

Specifies the number of NetBIOS message packets that are prebuilt for each session.

*SAME: The value does not change.

prebuilt-packets: Specify a value in the range of 1 through 200 message packets.

Packet confirms for restart (PKTRESTART)

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.

*SAME: The value does not change.

packet-restart: Specify a value in the range of 0 through 9999 confirmations.

DLC retries (DLCRTY)

Specifies the number of additional transmission attempts that will be made before assuming that the receiving data link control (DLC) layer is not responding.

*SAME: The value does not change.

DLC-retries: Specify a value in the range of 1 through 65535 attempts.

Ethernet standard (ETHSTD)

Specifies the Ethernet standard frame type that is used for NetBIOS communication.

*SAME: The value does not change.

*IEEE8023: IEEE 802.3 frames are used.
*ETHV2: Ethernet Version 2 frames are used.

Text 'description' (TEXT)

Specifies the text that briefly describes the NetBIOS description.

*SAME: The value does not change.

*BLANK: Text is not specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

CHGNTBD   NTBD(MYNETBIOS)  ACKTMR(3000)

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.