The Create NetBIOS Description (CRTNTBD) command creates a NetBIOS configuration description. Configuration objects, such as network server descriptions, for IOPs that support NetBIOS can then refer to this object for their NetBIOS parameters.

More information about using this command is in the Communications Configuration book, SC41-5401 book.

Parameters

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

Top

NetBIOS description (NTBD)

Specifies the name of the NetBIOS configuration object being created.

This is a required parameter.

Text 'description' (TEXT)

Specifies text that briefly describes the NetBIOS description.

*BLANK

Text is not specified.

'description'

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

Full buffer datagrams (FULLBUFDTG)

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

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

*YES

The full transmit buffer size is requested.

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.

1000

The time between runs of the adaptive window algorithm is 1000 milliseconds.

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.

0

The number of dropped packets is 0.

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.

4168

The maximum data size that can be received is 4168 bytes.

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.

30000

The link can be inactive for 30000 milliseconds.

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.

500

The NetBIOS protocol driver waits 500 milliseconds.

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.

200

The driver delays for 200 milliseconds.

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.

1

An acknowledgement is sent after one packet is received.

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.

1

An acknowledgement is expected after one packet is sent.

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.

500

The time to wait is 500 milliseconds.

query-timeout

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.

8

The number of retries is 8.

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.

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

5

The number of NetBIOS message packets is 5.

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.

2

The maximum number of transmission confirmations is 2.

packet-restart

Specify the number of transmission confirmations. Valid values range from 0 through 9999.

DLC retries (DLCRTY)

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

5

The additional number of transmission attempts is 5.

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.

*IEEE8023

IEEE 802.3 frames are used.

*ETHV2

Ethernet Version 2 frames are used.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*CHANGE

The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL

The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE

The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE

The user cannot access the object.

*LIBCRTAUT

The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

name

Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTNTBD   NTBD(MYNETBIOS)  ADPWDWITV(6000)

This command creates a NetBIOS description named MYNETBIOS specifying that the adapter window algorithm is to be run every 6000 milliseconds (6 seconds).

Error messages

*ESCAPE Messages

CPF26C3

IPX description &1 not created due to errors.

CPF27A6

NetBIOS description &1 not created due to errors.