Configuring the LLC and NetBIOS Protocols (MTOKRING.NLM and MNETBIOS.NLM) under DOS and Windows 3.x


This page provides information about:


Command-Line Parameters

You can use the parameters in this section the LOAD MTOKRING or LOAD MNETBIOS command lines, using the following syntax:

LOAD MTOKRING <parameter>

or:

LOAD MNETBIOS <parameter>


Command-Line Parameters for MTOKRING

Parameter

Information

HELP

Specifying this on the command line causes the protocol to display a list of supported NET.CFG configuration parameters and their default values.

The protocol does not load.


Command Line Parameters for MNETBIOS

Parameter

Information

HELP

Specifying this on the command line causes the protocol to display a list of supported NET.CFG configuration parameters and their default values.

The protocol does not load.

STATUS

You can only enter LOAD MNETBIOS STATUS at the command prompt after the protocol has been loaded. It causes MNETBIOS to display current protocol status information to the screen


NET.CFG Parameters

The parameters in this section are for use in the NET.CFG file. You must put these parameters for MTOKRING and MNETBIOS in the NET.CFG file in the directory in which Client 32 is installed. You must put parameters for MTOKRING under the section heading: Protocol MTOKRING and parameters for MNETBIOS under the section heading: Protocol MNETBIOS. Indent each parameter by one or more spaces or tabs, and separate the parameter name and associated value by a space, tab, or an "equal to" (=) sign.

Each Protocol MTOKRING or Protocol MNETBIOS section contains parameters for one adapter. To specify parameters for multiple adapters, you must use give each adapter it's own section. When multiple sections with the same heading exist, the first section contains parameters for the first adapter, the second section contains parameters for the second adapter and so on. An example of a NET.CFG containing multiple sections is displayed below.

; Parameters for LLC adapter 0:

Protocol MTOKRING
<parameter> = <value>
<parameter> = <value>
<parameter> = <value>
; Parameters for LLC adapter 1:

Protocol MTOKRING
<parameter> = <value>
; Parameters for NetBIOS adapter 0:

Protocol MNETBIOS

<parameter> = <value>
; Parameters for NetBIOS adapter 1:

Protocol MNETBIOS
<parameter> = <value>
<parameter> = <value>


MTOKRING NET.CFG Parameters

Parameter

Information

BIND <0-255>

Specifies that the LLC adapter number which the current "Protocol MTOKRING" section refers to should be bound to the ODI logical board number specified.

Default : Not specified

T1_TICK_ONE <1-255>

Overrides the timer tick length for the T1 short timer.

Default : 5

T1_TICK_TWO <1-65535>

Overrides the timer tick length for the T1 long timer.

Default : 25

T2_TICK_ONE <1-255>

Overrides the timer tick length for the T2 short timer.

Default : 1

T2_TICK_TWO <1-65535>

Overrides the timer tick length for the T2 long timer.

Default : 10

Ti_TICK_ONE <1-255>

Overrides the timer tick length for the Ti short timer.

Default : 25

Ti_TICK_TWO <1-65535>

Overrides the timer tick length for the Ti long timer.

Default : 125


MNETBIOS NET.CFG Parameters

Parameter

Information

STATIONS <1-254>

Specifies the maximum number of link stations which the adapter will support. One link station is required per remote computer with which sessions are opened. This is the number of link stations NetBIOS reserves with the LLC when it opens its SAP, therefore care must be taken to leave enough free stations for any other LLC applications running on the computer.

Default : 64

MAX_FRAME_SIZE <512-65535>

Limits the maximum frame size which NetBIOS will support.

Default : The maximum size supported by the underlying ODI network driver, set using the "MAX BUFFER SIZE" parameter in the "Link Support" NET.CFG section.

DATAGRAM_MAX <TRUE/FALSE>

Specifies whether the maximum sized frame can be used for transmitting datagrams. If FALSE, datagrams are limited to 512 bytes. Broadcast datagrams are always limited to 512 bytes. Setting this parameter to TRUE is not advised since some NetBIOS implementations which may be in use on the network may not support datagrams greater than 512 bytes.

Default : FALSE

SOURCE_ROUTING <TRUE/FALSE>

If FALSE, frames are transmitted without source routing information.

Default : TRUE

ADDR_NOT_REVERSED <TRUE/FALSE>

Specifies whether the node address used by the NCB.STATUS command and in the default name (NAME_NUMBER_1) should not be reversed.

Default : FALSE

RND <4-255>

Specifying this parameter enables the Remote Name Directory (RND) and specifies the number of entries it should contain. The RND caches the location (node address and source routing information) of NetBIOS names as they are found on the network. When NetBIOS wants to transmit a SEND_DATAGRAM, call NAME_QUERY or STATUS_QUERY frame to a name which has an RND entry, the frame is directed to the cached node address rather than broadcast, which makes more efficient use of the network.

Default : Not specified

RDC <TRUE/FALSE>

This parameter only has meaning when the Remote Name Directory is enabled and specifies whether SEND_DATAGRAM frames should use the RND or should always be broadcast.

Default : FALSE

PIGGYBACK_ACK_TIMEOUT <0-100>

If this parameter has a non-zero value, piggybacked acknowledgements are enabled and the value specifies the number of deciseconds to wait before sending an explicit acknowledgement to a received data frame. Piggybacked ack's reduce network traffic by allowing a NetBIOS data frame to be acknowledged by inserting an acknowledgment in a data frame travelling in the reverse direction, rather than by a DATA_ACK frame. Piggybacked ack's work well if the NetBIOS traffic follows a request-response pattern where a received frame is likely to be responded to immediately by a frame transmitted back to the sender. In the event that no frame is sent back, an explicit DATA_ACK frame is sent after the timeout period specified by this parameter.

If the NetBIOS traffic does not follow a request-response pattern and the timeout is set too long, slow network performance may result. In this case piggybacked ack's should be disabled by setting this parameter to zero.

Default : 5

TRANSMIT_COUNT <1-10>

Specifies the number of times NetBIOS will retry sending UI request frames before assuming that the destination does not exist.

Default : 6

TRANSMIT_TIMEOUT <1-20>

Specifies the time (in 0.5 second units) to wait for a response to a UI request frame before retrying.

Default : 1

DLC_T1 <0-10>

Specifies the DLC T1 (retransmission) timer for frames transmitted on NetBIOS links. This determines the delay before re-transmitting a frame which didn't receive a response.

A value from 1-5 selects the short timer tick and from 6-10 selects the long timer tick.

Default : 5

DLC_T2 <0-11>

Specifies the DLC T2 (acknowledgement) timer for frames transmitted on NetBIOS links. This determines the delay between receipt and acknowledgement of a frame when the frame has not reached the receive window.

A value from 1-5 selects the short timer tick and from 6-10 selects the long timer tick.

Specifying a value of 11 disables the T2 timer which means no acknowledgements are transmitted until the receive window is reached.

Default : 2

DLC_TI <0-10>

Specifies the DLC Ti (inactivity) timer for frames transmitted on NetBIOS links. This determines the period of inactivity required before the DLC will send a poll frame to check that the link is still functional.

A value from 1-5 selects the short timer tick and from 6-10 selects the long timer tick.

Default : 10

DLC_MAXOUT <1-127>

Specifies the maximum number of I-frames that are transmitted on NetBIOS links before an LLC-level acknowledgement is required (the "transmit window").

Increasing DLC_MAXIN and DLC_MAXOUT can improve the performance of a link since it allows more data to be in transit (particularly useful for slow links) and reduces the number of LLC-level acknowledgements which are required. However, care must be taken to configure all NetBIOS stations using consistent values.

Default : 2

DLC_MAXIN <1-127>

Specifies the maximum number of I-frames that are received on NetBIOS links before an LLC-level acknowledgement is transmitted (the "receive window").

Increasing DLC_MAXIN and DLC_MAXOUT can improve the performance of a link since it allows more data to be in transit (particularly useful for slow links) and reduces the number of LLC-level acknowledgements which are required. However, care must be taken to configure all NetBIOS stations using consistent values.

Default : 1

DLC_MAXOUT_INCR <1-255>

If the LLC detects an error condition requiring a frame retransmission, it resets the MAXOUT parameter to 1. MAXOUT is then incremented by one each time the number of frames specified by this parameter are acknowledged by the remote station until the maximum value (DLC_MAXOUT) is reached.

Default : 1

DLC_RETRY_COUNT <1-255>

Specifies the number of attempts the LLC makes to transmit I-frames on NetBIOS links. If all the retries fail, all NetBIOS sessions using the link fail. The DLC_T1 timer gives the time between retransmissions.

Default : 15


See Also: