CHGNTBD (Change NetBIOS Description)

CHGNTBD Command syntax diagram

 

Purpose

The Change NetBIOS Description (CHGNTBD) command changes a NetBIOS description object. More information about using this command is in the Communications Configuration book.

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.

 

Required Parameters

NTBD

Specifies the name of the NetBIOS description being changed.

 

Optional Parameters

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).

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.

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 errors allowed. Valid values range from 0 through 10.

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.

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.

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.

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.

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.

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.

QRYTMR

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

*SAME: The value does not change.

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

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.

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.

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.

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.

DLCRTY

Specifies the number of additional transmission attempts that are 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.

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

Specifies the text that briefly describes the NetBIOS description. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGNTBD

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.

Error messages for CHGNTBD

*ESCAPE Messages

CPF27A2

NetBIOS description &1 not changed.