4.2 Parameter for the Interrupt Arbitrator Device Driver (DXMA0MOD.SYS)

 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


Back to  Jump to TOP-of-PAGE

Please see the LEGAL  -  Trademark notice.
Feel free - send a Email-NOTE  for any BUG on this page found - Thank you.