4.2 Parameter for the Interrupt Arbitrator Device Driver (DXMA0MOD.SYS)
DXMA0MOD.SYS has one parameter that defines the language in which
load-time messages are displayed. This parameter corresponds to one of
the values defined as DOS country codes in the IBM Personal Computer Disk
Operating System user's guide for your version of DOS. If the parameter
is specified, it is entered in CONFIG.SYS using the following syntax:
DEVICE=\LSP\DXMA0MOD.SYS ccc
In this example, \LSP is a sample directory. You may substitute another
directory if you wish.
The following country codes are supported:
+---------+-----------------+---------+----------------------------------+
| Country | | Country | |
| Code | Language | Code | Language |
+---------+-----------------+---------+----------------------------------+
| 001 | U.S. English | 049 | German |
+---------+-----------------+---------+----------------------------------+
| 034 | Spanish | 081 | Japanese |
+---------+-----------------+---------+----------------------------------+
4.3 Parameters for DXME0MOD.SYS
Chapter 2, "Using the Installation Aid" explains how to use the
Installation Aid to change the values of the parameters. If you use the
Installation Aid to update the parameters of the LSP NDIS drivers, see
"List of Parameters" in topic 4.3.2.
4.3.1 Syntax Example
The sample directory \LSP is provided in the examples showing you how to
edit CONFIG.SYS to change the parameters for DXME0MOD.SYS. You may
substitute another directory name if you wish.
They are entered in CONFIG.SYS using the following syntax: (1)
DEVICE=\LSP\DXME0MOD.SYS N X ADDR0,WRK0,XMIT_SWAP0,MINSAP0,MINLINK0,
ADDR1,WRK1,XMIT_SWAP1,MINSAP1,MINLINK1
A 0 as the last character of a parameter name in this example means that
this parameter is used for the primary or only adapter; a 1 means that the
parameter is used for the alternate adapter when the primary adapter is
present. The range of values for each of these parameters is the same for
either the primary or the alternate adapter, but CONFIG.SYS must be edited
differently.
(1) In CONFIG.SYS, the list of parameters must be continued on
one line.
4.3.2 List of Parameters
The parameters for DXME0MOD.SYS are listed in Figure 4-1. See the
sections referred to for detailed descriptions of them.
Note: When using MINLINK or MINSAP, you may need to increase the work
space for the adapter. See "Work Space" in topic 4.3.10 and "Increasing
Work Space for DXME0MOD.SYS" in topic 6.6 for more information.
+------------------------------------------------------------------------+
| Figure 4-1. Parameters for DXME0MOD.SYS |
+-----------+----------------------------------------+-------------------+
| Parameter | Function | See: |
+-----------+----------------------------------------+-------------------+
| N | The N parameter enables the device | "The N Parameter" |
| | driver to interpret the MINSAP and | in topic 4.3.8 |
| | MINLINK parameters correctly. You | |
| | must use this parameter when you use | |
| | MINSAP or MINLINK. | |
+-----------+----------------------------------------+-------------------+
| ADDR | Parameter to set the adapter address. | "Adapter Address" |
| | | in topic 4.3.9 |
+-----------+----------------------------------------+-------------------+
| WRK | Parameter to set the internal work | "Work Space" in |
| | space of the adapter. | topic 4.3.10 |
+-----------+----------------------------------------+-------------------+
| XMIT_SWAP | Parameter to set the frame format when | "Transmit/Swap" |
| | using an Ethernet adapter. | in topic 4.3.11 |
+-----------+----------------------------------------+-------------------+
| MINSAP | Parameter to set the minimum number of | "MINSAP" in |
| | service access points (SAPs). The N | topic 4.3.12 |
| | parameter must be present when this | |
| | parameter is used. | |
+-----------+----------------------------------------+-------------------+
| MINLINK | Parameter to set the minimum number of | "MINLINK" in |
| | link stations. The N parameter must | topic 4.3.13 |
| | be present when this parameter is | |
| | used. | |
+-----------+----------------------------------------+-------------------+
4.3.3 Using the Installation Aid to Change Parameter Values
If you plan to use the Installation Aid, you do not need to read "Global
and Positional Parameters" in topic 4.3.4 or "Examples of Editing the
Parameter List" in topic 4.3.5. See "Descriptions of the DXME0MOD.SYS
Parameters" in topic 4.3.7.
4.3.4 Global and Positional Parameters
The N and X parameters are global parameters. They must follow the device
driver name and precede the first address, and be separated from them and
from each other by spaces. These global parameters, if used, must precede
the positional parameters.
The parameters separated by commas are positional parameters. They must
be entered in the sequence shown in "Syntax Example" in topic 4.3.1. Each
positional parameter is always followed by a comma except when it is at
the end of the list. If a positional parameter is missing, the single
comma that would follow it is used to mark its place.
The name of the device driver must always be followed by a space. For
more information about entering these parameters manually, see "Examples
of Editing the Parameter List" in topic 4.3.5.
4.3.5 Examples of Editing the Parameter List
If two adapters are installed in the same computer, the parameters for the
primary adapter are entered first, followed by the parameters for the
alternate adapter.
° Use a blank to separate the parameter list from
DEVICE=\LSP\DXME0MOD.SYS
° Follow each positional parameter by a comma except when the parameter
is at the end of the list.
° If a parameter that is not at the end of the list is missing, use the
single comma that would follow it to mark its place.
To specify a locally administered address for the primary adapter, use the
following line:
DEVICE=\LSP\DXME0MOD.SYS 400000000001
In this example, 400000000001 is the new address for the primary adapter,
which overrides the default address encoded on the adapter. All other
defaults are retained.
You must enter the WRK parameters as one or two decimal digits. This
value is interpreted as the number of KB of work space to reserve. If no
value is specified, or if the value is less than the default, the default
value will be used. A value greater than 64 will be reduced to 64. To
specify a work space different from the default, add the parameter as in
the following example:
DEVICE=\LSP\DXME0MOD.SYS ,20
In this example, 20 is the new size of the work space for the primary or
only adapter (20 KB). All other defaults are retained. Note the comma
before the work space size. This comma indicates that a parameter (the
primary adapter address) has been omitted.
To increase the work space for the primary adapter to 20 KB, the workspace
for the alternate adapter to 10 KB, and to specify MINSAP of 2 and MINLINK
of 2 for each adapter, you would use this statement:
DEVICE=\LSP\DXME0MOD.SYS N ,20,,2,2,,10,,2,2
4.3.6 Editing the Parameter for PROTMAN.DOS
PROTMAN.DOS is a file required when NDIS adapters are used. It has one
parameter (the /I: parameter) that must be included when PROTOCOL.INI is
located in any directory other than \LANMAN. For a description of this
parameter and its use, see "Using the /I: Parameter" in topic 3.3.4.
4.3.7 Descriptions of the DXME0MOD.SYS Parameters
The following sections describe the parameters for DXME0MOD.SYS
4.3.8 The N Parameter
This parameter (the letter N) alerts the software to read values for
MINSAP and MINLINK. If you enter values for MINSAP and MINLINK, but do
not enter the N parameter, the MINSAP and MINLINK parameters will be
ignored if there is one adapter or misinterpreted if there are two.
The Installation Aid provides this parameter automatically when the
default value of any parameter is changed.
4.3.9 Adapter Address
The address of the adapter is in the range that is administered
universally by the standards committees for LANs. This universally
administered address is the default address for the adapter if no other
address is assigned, and is often referred to as the burned-in address.
The network administrator may assign a locally administered address that
will override the universally administered address. This address must
consist of 12 hexadecimal digits that range from X'4000 0000 0000' to
X'7FFF FFFF FFFF'.
IBM recommends that the address be restricted to decimal values. The
locally administered address can range from X'4000 0000 0000' to X'4000
7999 9999' decimal.
You may configure DXME0MOD.SYS manually with a locally administered
address in one of two ways:
1. By using a keyword parameter in PROTOCOL.INI
2. By using the ADDR parameter.
Using the ADDR parameter is not recommended; using the keyword parameter
in PROTOCOL.INI is the preferred method. For instructions on using the
keyword parameter, see "Network Adapter Address Configuration" in
topic 4.7.1.
NOTES:
1. Make sure that the address is recorded on the physical and logical
address locator charts.
(See IBM Token-Ring Network Introduction and Planning Guide.)
2. Each address must be unique on the LAN segment.
4.3.10 Work Space
The LSP NDIS driver DXME0MOD.SYS allows a maximum internal work space of
64 KB per adapter, all of which may or may not be needed. The amount of
work space depends on the requirements of the application program. The
default work space is 16 KB for each adapter in your computer. This
default is twice the 8 KB size allocated by the stand-alone LAN Support
Program Version 1.3 or higher.
The values of this parameter are set as follows:
° If a value of 0 is entered, the work space is set to the default of 16
KB.
° If a value of 1 to 7 is entered, the work space is set to 8 KB.
° If a value of 8 to 64 is entered, the work space is set to that value
in KB.
° If a value of 65 to 99 is entered, the work space is set to 64 KB.
As the number of SAPs, link stations, or sessions increases, you may have
to increase the work space. See "Increasing Work Space for DXME0MOD.SYS"
in topic 6.6 for more information.
4.3.11 Transmit/Swap
The transmit function of this parameter determines the frame format.
Frames can be transmitted on the Ethernet network in one of two formats:
Ethernet DIX Version 2.0 or IEEE 802.3. The default is to transmit IEEE
802.3 frames.
The swap function determines whether addresses are transmitted with or
without their bits swapped. Addresses may be transmitted with their bits
swapped on a byte basis. For example, if the value X'10007BC00402' is an
address and address bit swapping is on, the address will be transmitted as
X'0800DE032040'. The default is to transmit with the address bits
swapped. Changing the parameter so that the address bits are not swapped
is not recommended.
The XMIT_SWAP parameter must be entered as a single decimal digit; each
digit defines one of the following user options:
0 Transmit IEEE 802.3 frame and swap address bits (default).
1 Transmit Ethernet DIX Version 2.0 frame and swap address bits.
2 Transmit IEEE 802.3 frame and do not swap address bits.
3 Transmit Ethernet DIX Version 2.0 frame and do not swap address bits.
If you are using IEEE 802.5 frames on a token-ring network, the value of
this parameter does not affect the network. However, it must be a valid
number (0, 1, 2, or 3).
4.3.12 MINSAP
This parameter is used to define the minimum number of SAPs that the
adapter will support when opened. It enables multiple 802.2 applications
to coexist. For example, IBM Personal Communications/3270 and IBM
Application System/400 PC Support can run on the same workstation if
MINSAP is set to a high enough value to include the total number of SAPs
required by both application programs.
The N parameter must be present when this parameter is used. If MINSAP is
omitted, 0 is used as its value. The range is 0-127.
4.3.13 MINLINK
This parameter sets the min. number of link stations that the adapter
will support when opened. It enables multiple 802.2 applications to
coexist. For example, IBM Personal Communications/3270 and IBM
Application System/400 can run on the same workstation if MINLINK is set
to a high enough value to include the total number of link stations
required by both application programs.
The N parameter N must be present when this parameter is used. If MINLINK
is omitted, 0 is used as its value. The range is 0-254.
4.4 NetBIOS Driver Parameters (Parameters for DXMT0MOD.SYS)
This section refers to DXMT0MOD.SYS parameters only. For information
about DXMJ0MOD.SYS parameters, see "Parameters for DXMJ0MOD.SYS" in
topic 4.7.
The NetBIOS interface has many optional parameters available to customize
the driver for certain network application programs. These parameters,
like the other LSP NDIS driver parameters, can be updated using the
Installation Aid. As with the other parameters, disregard the syntax and
editing information if you use the Installation Aid.
Only one of the parameters, the Enable parameter, is position dependent.
If used, it must be entered as the first parameter. For example:
DEVICE=\LSP\DXMT0MOD.SYS ENABLE
NOTES:
1. ENABLE may be abbreviated as E.
The processing of a NetBIOS command occurs when the X'5C' interrupt is
issued. Because interrupts are disabled for a short time, some loss of
data may occur in an asynchronous adapter if it is used simultaneously
with a LAN adapter.
If the computer contains an asynchronous adapter that is used
simultaneously with a LAN adapter, you should use the Enable parameter.
In this case, the NetBIOS command will be processed at a later time,
during a LAN adapter appendage interrupt. Because interrupts are enabled,
data is not lost. But because of the short delay, there may be some loss
in performance.
4.4.1 Keyword Values for DXMT0MOD.SYS Old Parameters
The new releases of the NetBIOS driver DXMT0MOD.SYS use keyword
parameters. The name of the parameter, called the keyword, is set equal
to its value. The keyword with its value can be placed at any position in
the list of parameters. However, in previous releases NetBIOS used
positional parameters.
The difference between old/new parameters is taken care of
autom. by the Installation Aid. If you are upgrading a previous
NetBIOS program release manually and do not plan to change over to the new
parameters, a migration selection allows you to select the positional
parameters. To do this, see the following example:
DEVICE=\LSP\DXMT0MOD.SYS OLD.PARMS.0=x y z
OLD.PARMS.0 is the keyword indicating that the old form of positional
parameters will be used for the adapter. The x y z stand for values that
can be set for the old parameters:
x PC RAM used as internal work space. The default is 9 (9 KB). For
large systems, this value may have to be increased (the maximum value
is 64 [64 KB]).
y Extra SAPs. This indicates the number of extra (non-NetBIOS) SAPs
that will be defined when NetBIOS opens the adapter. The default
value is 0 and the maximum value is 99.
z Extra link stations. This indicates the number of extra
(non-NetBIOS) link stations that will be defined when NetBIOS opens
the adapter. The default value is 0 and the max. value is 99.
OLD.PARMS.1 is the keyword for positional parameters for the alternate
adapter. The a b c indicates the positional parameters.
Note: If one of two adapters uses the old parameters, the other adapter
must also use the old parameters.
+------------------------------------------------------------------------+
| Figure 4-2. NetBIOS (Default = OLD.PARMS) Parameters |
+-----------------------+------------------------+-----------------------+
| Load Parameters | Valid Values | Defaults |
+-----------------------+------------------------+-----------------------+
| Work area | 0 to 64 | 9 |
+-----------------------+------------------------+-----------------------+
| EXTRA.SAPs | 0 to 99(1) | 0 |
+-----------------------+------------------------+-----------------------+
| EXTRA.STATIONS | 0 to 99(1) | 0 |
+-----------------------+------------------------+-----------------------+
| (1) If this value is too large, the adapter will fail to open. The |
| maximum value allowed here typically exceeds current adapter maximum |
| values. |
+------------------------------------------------------------------------+
NOTES:
1. If y is specified, x must be specified. If z is specified, both x and
y must be specified. The same is true for a, b, and c. Only these
parameters can be changed by an entry on the CONFIG.SYS command line.
2. Listed in the following table are the old parameters whose default
values differ from those listed in Figure 4-4 in topic 4.4.4. Use the
NetBIOS RESET command to change the values for STATIONS, SESSIONS, and
COMMANDS.
+------------------------------------------------------------------------+
| Figure 4-3. DXMT0MOD.SYS Old Parameters Defaults |
+-----------------------+------------------------+-----------------------+
| Parameters | Defaults | Valid Values |
+-----------------------+------------------------+-----------------------+
| STATIONS | 6 | 1 to 32 |
+-----------------------+------------------------+-----------------------+
| SESSIONS | 6 | 1 to 32 |
+-----------------------+------------------------+-----------------------+
| COMMANDS | 12 | 1 to 32 |
+-----------------------+------------------------+-----------------------+
| OPEN.ON.LOAD | NO | Cannot be changed |
+-----------------------+------------------------+-----------------------+
4.4.2 Keyword Values for DXMT0MOD.SYS New Parameters
Figure 4-4 in topic 4.4.4 shows all the new NetBIOS keywords and their
default values. If you are using the Installation Aid, you do not need
the editing information that follows. Go to the notes in topic 4.4.4 .
4.4.3 Manual Configuration of the OPEN.ON.LOAD Parameter
If no command line parameters are specified for DXMT0MOD.SYS, the
parameters default to the NetBIOS old parameters, and the parameter
OPEN.ON.LOAD is equal by default to No (O=N). If you specify any command
line parameter for DXMT0MOD.SYS, the NetBIOS new parameters become the
defaults, and the parameter OPEN.ON.LOAD is equal by default to Yes (O=Y).
With NDIS adapters, the default value O=Y causes an error message. When
O=Y, DXMT0MOD.SYS tries to open the adapter at load time and fails because
NETBIND, the COM file that enables the adapter to open, is not executed
until AUTOEXEC.BAT is executed.
To prevent this problem, you should specify the OPEN.ON.LOAD parameter
equal to N (O=N) if you change any DXMT0MOD.SYS parameter values.
4.4.4 Editing CONFIG.SYS for DXMT0MOD.SYS Command Line Parameters
When using the DXMT0MOD.SYS new parameters, each keyword is set equal to
its value, so keyword parameters are not position dependent. They need to
be separated by a blank as shown in the examples that follow, and they
must also be on the same line.
Note that keywords may be defined for either one or two adapters; if there
are two adapters, the keywords are separated by a slash (/). Any
undefined keywords take the default value. If the / is used, any
undefined keywords before it apply to the primary adapter and any
undefined keywords to the right of it apply to the alternate adapter. The
= sign used to the right of the slash indicates that all parameter values
specified for the primary adapter are duplicated for the alternate
adapter. O=N must be specified for each adapter unless the = sign is
used.
One or more keywords can be specified for each adapter as follows:
° For the primary or only adapter, or to specify keywords for the
primary adapter and use all keyword defaults for the alternate
adapter, see the following example:
DEVICE=\LSP\DXMT0MOD.SYS E O=N ST=64 S=64 N=32 C=32
Note that some of the keyword values (for example, DG) are defaults
for the primary adapter as well. When a parameter is not stated, a
default value is implied.
In this instance, 64 sessions are defined, and the Enable parameter is
activated. Remember that Enable is the parameter that activates the
Enable function, and that it is the only position-dependent NetBIOS
new parameter. If used, it must precede any other NetBIOS parameters
listed. (You can represent ENABLE with the abbreviation E.)
° To specify keywords for the alternate adapter and use all keyword
defaults for the primary adapter, if it exists (note the /), see the
following example:
DEVICE=\LSP\DXMT0MOD.SYS O=N / O=N ST=16 S=32 C=32
° To specify keywords for both the primary and alternate adapters (note
the /), see the following example:
DEVICE=\LSP\DXMT0MOD.SYS O=N ST=16 S=32 C=16 / O=N ST=8 S=8
° To specify keywords for the primary adapter and define the alternate
adapter the same way (note the / =), see the following example:
DEVICE=\LSP\DXMT0MOD.SYS O=N ST=16 S=32 C=16 / =
NOTES:
1. The DXMT0MOD.SYS parameters are used to customize the system, if
required.
2. These parameters cannot be used if OLD.PARMS.0, OLD.PARMS.1, or both
are used.
3. The keywords STATIONS, SESSIONS, and COMMANDS provide maximum values
that can be used; if a program issues a RESET command, and the RESET
indicates a value larger than indicated by these keywords, the keyword
value will be used.
4. If any of these keywords are used, all other keywords will assume the
default values indicated in Figure 4-4.
+------------------------------------------------------------------------+
| Figure 4-4. NetBIOS (DXMT0MOD.SYS) New Keyword Values |
+----------------------+-------------------+----------+--------+---------+
| | | Valid | | |
| Keyword | Abbreviations | Values | Minimum| Default |
+----------------------+-------------------+----------+--------+---------+
| | | 0 to 254 | | |
| STATIONS | ST | (1) | 1 | 16 |
+----------------------+-------------------+----------+--------+---------+
| SESSIONS | S | 0 to 254 | 1 | 16 |
+----------------------+-------------------+----------+--------+---------+
| COMMANDS | C | 0 to 255 | 1 | 12 |
+----------------------+-------------------+----------+--------+---------+
| NAMES | N | 0 to 254 | 2 | 17 |
+----------------------+-------------------+----------+--------+---------+
| | | Y (Yes) | | |
| OPEN.ON.LOAD | O | N (No) | - | Yes |
+----------------------+-------------------+----------+--------+---------+
| | | Y (Yes) | | |
| DATAGRAM.MAX | DG | N (No) | - | No |
+----------------------+-------------------+----------+--------+---------+
| | | Y (Yes) | | |
| CLOSE.ON.RESET | CR | N (No) | - | No |
+----------------------+-------------------+----------+--------+---------+
| | | Y (Yes) | | |
| CALL.FAR | CF | N (No) | - | No |
+----------------------+-------------------+----------+--------+---------+
| | | 0, 200 | | |
| | | to | | |
| | | 17 960 | | |
| DHB.SIZE | DS | (1) | 200 | (2) |
+----------------------+-------------------+----------+--------+---------+
| | | 0 to 9 | | |
| DHB.NUMBER | DN | (1) | - | (2) |
+----------------------+-------------------+----------+--------+---------+
| | | 0 to | | |
| RECEIVE.BUFFER.SIZE | R | 9999 (1) | (3) | (2) |
+----------------------+-------------------+----------+--------+---------+
| TRANSMIT.TIMEOUT | TT | 0 to 20 | 0 | 1 |
+----------------------+-------------------+----------+--------+---------+
| TRANSMIT.COUNT | TC | 0 to 10 | 0 | 6 |
+----------------------+-------------------+----------+--------+---------+
| DLC.MAXOUT | MO | 0 to 9 | 0 | 2 |
+----------------------+-------------------+----------+--------+---------+
| DLC.MAXIN | MI | 0 to 9 | 0 | 1 |
+----------------------+-------------------+----------+--------+---------+
| RING.ACCESS | RA | 0 to 3 | 0 | 0 |
+----------------------+-------------------+----------+--------+---------+
| | | 0 to 99 | | |
| EXTRA.SAPS | ES | (1) | 0 | 0 |
+----------------------+-------------------+----------+--------+---------+
| | | 0 to 254 | | |
| EXTRA.STATIONS | EST | (1) | 0 | 0 |
+----------------------+-------------------+----------+--------+---------+
| REMOTE.NAME.DIRECTORY| RND | 0 to 255 | 0 | 0 |
+----------------------+-------------------+----------+--------+---------+
| REMOTE.DATA | | Y (Yes) | | |
| GRAM.CONTROL | RDC | N (No) | - | No |
+----------------------+-------------------+----------+--------+---------+
| | | Y (Yes) | | |
| RESET.VALUES | RV | N (No) | - | No |
+----------------------+-------------------+----------+--------+---------+
| | | Y (Yes) | | |
| ADAP.ADD.NOT.REVERSED| ANR | N (No) | - | No |
+----------------------+-------------------+----------+--------+---------+
| DLC.RETRY.COUNT | RC | 0 to 255 | 0 | 8 |
+----------------------+-------------------+----------+--------+---------+
| DLC.T1 | T1 | 0 to 10 | 0 | 5 |
+----------------------+-------------------+----------+--------+---------+
| DLC.T2 | T2 | 0 to 11 | 0 | 2 |
+----------------------+-------------------+----------+--------+---------+
| DLC.TI | TI | 0 to 10 | 0 | 10 |
+----------------------+-------------------+----------+--------+---------+
| PIGGYBACKED | | | | |
| ACKNOWLEDGMENTS | PBA | 0 to 5 | 0 | 0 |
+----------------------+-------------------+----------+--------+---------+
| Note: On this table, (1) means see note 1, (2) means see note 2, and |
| (3) means see note 3. The notes follow. |
+------------------------------------------------------------------------+
NOTES:
1. If this value is too large, the adapter fails to open. The maximum
value allowed here typically exceeds current adapter maximum values.
2. The default value set by the NetBIOS interface device driver is based
on the number of stations. See "DXMT0MOD.SYS Adapter Transmit and
Receive Buffer Default Sizes" in topic 4.5.
3. If a value is specified for RECEIVE.BUFFER.SIZE, its value is not
checked by the NetBIOS interface device driver. The value is checked
by the adapter upon opening. Current adapters require a minimum value
of 96.
4.4.5 NetBIOS Device Driver Keyword Parameter Descriptions
Each keyword has an abbreviated version, which is indicated in parentheses
following the keyword:
STATIONS= (ST=)
° Indicates the maximum number of NetBIOS interface link
stations that can be defined.
° Must be a decimal number from 0 to 254.
- The realistic maximum is affected by the size of the
shared RAM on the adapter.
- The EXTRA.STATIONS value reduces the maximum for the
NetBIOS interface.
° If other than the default is used, CLOSE.ON.RESET must be
set to Y (Yes).
° If omitted or 0, the default value is 16.
SESSIONS= (S=)
° Indicates the maximum number of NetBIOS interface device
driver sessions that can be defined.
° Must be a decimal number from 0 to 254.
° If omitted or 0, the default value is 16.
If the value is less than that of STATIONS, it will be set
to the value of STATIONS.
COMMANDS= (C=)
° Indicates the maximum number of NetBIOS interface commands
node control block (NCB) that can be outstanding at one
time.
° Must be a decimal number from 0 to 255.
° If omitted or 0, the default value is 12.
NAMES= (N=)
° Indicates the maximum number of NetBIOS interface device
driver names that can be defined, including NAME_NUMBER_1.
° Must be a decimal number from 0 to 254.
° If omitted or 0, the default value is 17.
° If the parameter is 1, the value will be set to 2.
OPEN.ON.LOAD= (O=)
° Must be N (NO).
° If Y (YES), an error message is displayed at load time. The
Installation Aid provides the default value N. See "Manual
Configuration of the OPEN.ON.LOAD Parameter" in topic 4.4.3
for more information.
DATAGRAM.MAX= (DG=)
° Indicates that the maximum length datagram transmitted by
the NetBIOS interface device driver will be based on the
size of the transmit buffer or data hold buffer (DHB) of the
adapter. Usually, a datagram is limited to 512 bytes.
° Must be specified as either Y (Yes) or N (No).
° If the maximum length of a datagram is:
DHB length - 86 (the size of the transmit buffer less 86
bytes).
° If omitted or N, this function is not performed.
CLOSE.ON.RESET= (CR=)
° Indicates that the NetBIOS interface will close the adapter
and reopen it when a RESET is issued.
° Must be specified as either Y (Yes) or N (No).
° Must be specified as Y if you want to change the number of
link stations.
° If omitted or N, this function will not be performed.
CALL.FAR= (CF=)
° Prevents an application program from intercepting the X'5C'
interrupt issued by the NetBIOS device driver DXMT0MOD.SYS.
If an application program intercepts this interrupt
incorrectly, LAN Support Program processing is terminated.
° Must be specified as either Y (Yes) or N (No). The default
value is N.
° Must be specified as Y when Windows(**) or DOS memory
managers are used with LSP NDIS. This keyword must also be
set to Y for any other application programs that may
intercept X'5C' interrupts.
For two adapters, enter this parameter on the command line
once.
° If omitted or N, this function will not be performed. The
default value is N.
DHB.SIZE= (DS=)
° Indicates the size of the DHB (the transmit buffers of the
adapter).
° Must be a decimal number within the range acceptable to the
adapter. Note that the minimum size allowed by the NetBIOS
interface is 200. Therefore, the value entered must be
either 0 or a number from 200 to 17 960.
° If omitted or 0, the value is determined by the NetBIOS
interface. See "DXMT0MOD.SYS Adapter Transmit and Receive
Buffer Default Sizes" in topic 4.5 for information about the
NetBIOS default values.
DHB.NUMBER= (DN=)
° Indicates the number of DHBs allocated by the adapter.
° Must be a decimal number within the range acceptable to the
adapter.
° If omitted or 0, the value is determined by the NetBIOS
interface device driver. See "DXMT0MOD.SYS Adapter Transmit
and Receive Buffer Default Sizes" in topic 4.5 for
information about the NetBIOS default values.
RECEIVE.BUFFER.SIZE= (R=)
° Indicates the size of the receive buffers of the adapter. A
minimum of eight adapter buffers of the specified size will
be allocated.
° Must be a decimal number within the range acceptable to the
adapter.
° If omitted or 0, the value is determined by the NetBIOS
interface. See "DXMT0MOD.SYS Adapter Transmit and Receive
Buffer Default Sizes" in topic 4.5 for information about the
NetBIOS default values.
TRANSMIT.TIMEOUT= (TT=)
° Indicates the time between transmission of queries (for
example, CALL).
° Is indicated in 1/2-second periods.
° Must be a decimal number from 0 to 20.
° If omitted or 0, the default is 1 (1/2 second).
TRANSMIT.COUNT= (TC=)
° Indicates the number of times queries (for example, CALL)
are transmitted.
° Must have a decimal value from 1 to 10. If a number from 1
to 10 is specified, that number is the value.
° If omitted or 0, the default is 6.
DLC.MAXOUT= (MO=)
° Sets the MAXOUT value for all NetBIOS interface link
stations. The MAXOUT value indicates the number of I-frames
sent before waiting for an acknowledgment.
° The sender's MAXOUT value must always be greater than the
receiver's MAXIN value.
° Must have a decimal value from 1 to 9. If a number from 1
to 9 is specified, that number is the value.
° If omitted or 0, the default is 2.
DLC.MAXIN= (MI=)
° Sets the MAXIN value for all NetBIOS interface link
stations. The MAXIN value indicates the number of I-frames
received before sending an acknowledgment.
° The receiver's MAXIN value must always be less than the
sender's MAXOUT value.
° Must have a decimal value from 1 to 9. If a number from 1
to 9 is specified, that number is the value.
° If omitted or 0, the default is 1.
RING.ACCESS= (RA=)
° Indicates the ring access priority for this adapter for
NetBIOS device driver interface messages. This parameter is
valid for token-ring adapters only.
° Must be a decimal number from 0 to 3.
° If omitted or 0, the default is 0.
° The higher the number, the higher the priority.
EXTRA.SAPS= (ES=)
° Indicates additional SAPs requested by the NetBIOS interface
when it implicitly opens the adapter by activating the
parameters specified on the NetBIOS command line. These
SAPs are not used by the NetBIOS interface.
° Must be a decimal number from 0 to 99.
° If omitted or 0, no additional SAPs are requested.
NOTES:
1. If this value exceeds the adapter maximum value, the error
will be detected when the adapter fails to open.
2. If this value is less than the value of MINSAP, the value of
MINSAP will be used.
EXTRA.STATIONS= (EST=)
° Indicates additional link stations requested by the NetBIOS
interface when it implicitly opens the adapter by activating
the parameters specified on the NetBIOS command line. These
link stations are not used by the NetBIOS interface.
° Requesting extra stations reduces link stations available
for the use on the NetBIOS interface.
° Must be a decimal number from 0 to 254.
° If omitted or 0, no additional stations are requested.
NOTES:
1. If this value exceeds the adapter maximum value, the error
will be detected when the adapter fails to open.
2. If this value is less than the value of MINLINK, the value
of MINLINK will be used.
REMOTE.NAME.DIRECTORY= (RND=)
° Can be coded as a number from 0 to 255.
° If omitted or 0, the REMOTE.NAME.DIRECTORY (RND) function is
not implemented. All CALLS, STATUS QUERIES, and SEND
DATAGRAMS will operate as in previous levels of NetBIOS and
broadcast messages to all NetBIOS nodes.
° If a nonzero value is coded, the RND function is implemented
with the value indicating the number of remote names that
can be saved by the local node. Note that 4 is the minimum
number of name entries; if coded as 1, 2, or 3, the value of
4 is used. When RND is implemented (after the local station
has located a remote name), the remote node address is saved
and subsequent messages to that name will be to a specific
node rather than a broadcast to all nodes. This is true for
CALLS, STATUS QUERIES, and SEND DATAGRAMS (see next keyword
REMOTE.DATAGRAM.CONTROL).
Important: Using the RND function can significantly improve
performance in situations where large numbers of DATAGRAMS,
CALLS, and REMOTE_ADAPTER_STATUS commands are used.
Warning: When the RND function is being used, a duplicate
network name will not be detected by a CALL function unless
it is the first time that the remote (CALL) name has been
used.
REMOTE.DATAGRAM.CONTROL= (RDC=)
° Is meaningless if REMOTE.NAME.DIRECTORY is omitted or coded
as 0.
° If omitted or coded as N (No), SEND DATAGRAMS will not use
the RND function.
° If coded as Y (Yes), SEND DATAGRAMS will also use the RND
for sending to remote nodes. Note that if a bridge in the
transmission path drops out, datagrams give no indication
that the path is no longer valid. Therefore, if this
function is used, you may want to update the RND if you
become aware that the remote node is not receiving
datagrams. You can update the RND by having the application
program issue a FIND_NAME command with a receive buffer
length of 0. This function allows an application to update
the RND without having to execute either a CALL or REMOTE
ADAPTER STATUS.
RESET.VALUES= (RV=)
° If omitted or coded as N (No), RESET works as it does in
earlier releases of NetBIOS.
° If coded as Y (Yes), when a RESET is issued:
- If the number of sessions is coded as 0 in the RESET,
the default will be the value defined by the keyword
SESSIONS= rather than the normal default value of 6.
- If the number of commands is coded as 0 in the RESET,
the default will be the value defined by the keyword
COMMANDS= rather than the normal default value of 12.
ADAP.ADDR.NOT.REVERSED= (ANR=)
° If omitted or coded as N (No), the universally administered
address of the adapter as used in the ADAPTER_STATUS command
and in NAME_NUMBER_1 will be byte-reversed (that is, if the
value is X'010203040506', it will be saved as
X'060504030201').
° If coded as Y (Yes), the universally administered address of
the adapter as used in the ADAPTER_STATUS command and in
NAME_NUMBER_1 will not be byte-reversed (that is, if the
value is X'010203040506', it will be saved as
X'010203040506').
DLC.RETRY.COUNT= (RC=)
° Determines the number of retry attempts to be made by the
logical link control (LLC) code.
° Must be a decimal value from 1 to 255. If a number from 1
to 255 is specified, that number is the value.
° If omitted or 0, the default value of 8 is used. The
default value is equal to 9 seconds. More detailed
information about the values of this parameter is found in
the IBM Local Area Network Technical Reference, SC30-3383.
DLC.T1= (T1=)
° Determines the value of the T1 response timer in the LLC
code. The T1 timer sets the maximum time to wait for an
acknowledgment before retransmitting a link-level frame.
° Must be a decimal value from 0 to 10. See Figure 4-5 for
correlations between parameters and seconds.
° If omitted or 0, the default value of 5 is used.
DLC.T2= (T2=)
° Determines the value of the T2 acknowledgment timer in the
LLC code. The T2 timer sets the maximum delay before
sending an acknowledgment.
° Must be a decimal value from 0 to 11. See Figure 4-5 for
correlations between parameters and seconds.
° If 11, the T2 timer function is not implemented.
° If omitted or 0, the default value of 2 is used.
DLC.TI= (TI=)
° Determines the value of the TI inactivity timer in the LLC
code. The TI timer sets how long to wait before generating
a data link control (DLC) status if there is no link station
traffic.
° Must be a decimal value from 0 to 10. If a number is
specified, that number is the value. See Figure 4-5 for
correlations between parameters and seconds.
° If omitted or 0, the default value of 10 is used.
PIGGYBACKED.ACKNOWLEDGMENTS= (PBA=)
° Specifies whether the NetBIOS protocol sends and receives
acknowledgments piggybacked with incoming data. If PBA is
enabled, the acknowledgment of the frame received is sent as
a piggyback on the next frame transmitted. If PBA is
disabled, a separate acknowledgment frame is sent. Network
performance may be improved when PBA is enabled.
° Must be a decimal value from 0 to 5.
° If changed to 0, the workstation neither sends nor requests
piggybacked acknowledgments. If the workstation is used in
a low traffic environment, setting PBA=0 is recommended.
° If omitted, the default value of 0 is used.
° If the default parameter is not changed, the workstation
sends and requests piggybacked acknowledgments.
+------------------------------------------------------------------------+
| Figure 4-5. DLC Timer Values |
+-----------------------+------------------------+-----------------------+
| DLC.T1 | DLC.T2 | DLC.TI |
| (RESPONSE) | (ACKNOWLEDGMENT) | (INACTIVITY) |
+---------+-------------+---------+--------------+---------+-------------+
| Parm | Seconds | Parm | Seconds | Parm | Seconds |
+---------+-------------+---------+--------------+---------+-------------+
| T1=1 | 0.2-0.4 | T2=1 | 0.04-0.08 | TI=1 | 1-2 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=2 | 0.4-0.6 | T2=2(1) | 0.08-0.12(1) | TI=2 | 2-3 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=3 | 0.6-0.8 | T2=3 | 0.12-0.16 | TI=3 | 3-4 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=4 | 0.8-1.0 | T2=4 | 0.16-0.20 | TI=4 | 4-5 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=5(1) | 1.0-1.2(1) | T2=5 | 0.20-0.24 | TI=5 | 5-6 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=6 | 1-2 | T2=6 | 0.4-0.8 | TI=6 | 5-10 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=7 | 2-3 | T2=7 | 0.8-1.2 | TI=7 | 10-15 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=8 | 3-4 | T2=8 | 1.2-1.6 | TI=8 | 15-20 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=9 | 4-5 | T2=9 | 1.6-2.0 | TI=9 | 20-25 |
+---------+-------------+---------+--------------+---------+-------------+
| T1=10 | 5-6 | T2=10 | 2.0-2.4 | TI=10(1)| 25-30(1) |
+---------+-------------+---------+--------------+---------+-------------+
| | | T2=11 | Disabled | | |
+---------+-------------+---------+--------------+---------+-------------+
| (1) Default value |
+------------------------------------------------------------------------+
More >> 4.5 DXMT0MOD.SYS Adapter Transmit and Receive Buffer Default Sizes
Please see the LEGAL - Trademark notice.
Feel free - send a for any BUG on this page found - Thank you.