home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 20 NDrivers / 20-NDrivers.zip / IBMTRBM.ZIP / IBMTRBM.DOC < prev    next >
Text File  |  1991-05-28  |  36KB  |  1,059 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  27.                     NDIS Device Driver User's Guide
  28.                   (C) Copyright IBM Corp. 1990, 1991.
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.      TRADEMARKS
  47.  
  48.           3Com is a trademark of 3Com Corporation
  49.           Microsoft is a trademark of the Microsoft Corporation
  50.           Micro Channel is a trademark of the IBM Corporation
  51.           OS/2 is a trademark of the IBM Corporation
  52.  
  53.  
  54.                                                                         Page 1
  55.  
  56.  
  57.  
  58.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  59.                     NDIS Device Driver User's Guide
  60.  
  61.  
  62.  
  63. INTRODUCTION
  64.  
  65.      The IBM Token-Ring Network 16/4 Busmaster Server Adapter /A Network
  66.      Driver Interface Specification (NDIS) device driver for the OS/2
  67.      program provides the interface between the IBM Token-Ring Network 16/4
  68.      Busmaster Server Adapter /A and a NDIS protocol stack. The device driver
  69.      delivers received frames from the adapter card to the protocol handler
  70.      and sends frames from the protocol handler to the adapter card to be
  71.      transmitted on the token-ring network.  The device driver does not
  72.      examine frame contents.
  73.  
  74.      The IBM Token-Ring Network 16/4 Busmaster Server Adapter /A NDIS device
  75.      driver supports the NDIS interface specified in the 3COM/Microsoft
  76.      LAN Manager Network Driver Interface Specification, version 1.0.2.
  77.  
  78.  
  79. INSTALLATION
  80.  
  81.     Device Driver Files
  82.  
  83.     To install the required device driver files:
  84.  
  85.     1.  Create a directory on the target machine
  86.     2.  Obtain the following files from the IBM Bulletin Board:
  87.  
  88.           *  IBMTRBM.OS2
  89.           *  IBMTRBM.286
  90.           *  LT4.MSG
  91.           *  LT4H.MSG
  92.  
  93.    3.   Copy the files listed in Step 2 into the newly created directory.
  94.    4.   Copy the following files from the options diskette distributed with
  95.         the IBM Token-Ring Network 16/4 Busmaster Server Adapter /A into
  96.         the newly created directory:
  97.  
  98.          *  WRTRAM.BIN
  99.          *  MONT400.BIN
  100.  
  101.  
  102.     NOTE -  The IBMTRBM.OS2 file copied from the IBM bulletin board
  103.     supports only 80386/80486 processors.  If the target machine
  104.     contains a 80286 processor, then follow these steps to install the
  105.     proper version of the IBM Token-Ring Network 16/4 Busmaster Server
  106.     Adapter /A NDIS device driver:
  107.  
  108.     1.  Rename IBMTRBM.OS2 to IBMTRBM.386
  109.     2.  Rename IBMTRBM.286 to IBMTRBM.OS2
  110.  
  111.                                                                         Page 2
  112.  
  113.  
  114.  
  115.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  116.                     NDIS Device Driver User's Guide (con't)
  117.  
  118.  
  119.  
  120.  
  121.     CONFIG.SYS File
  122.  
  123.     Add a "DEVICE =" statement after the Protocol Manager device driver
  124.     statement in the CONFIG.SYS file.  A single "DEVICE = " statement is
  125.     required for the IBM Token-Ring Network 16/4 Busmaster Server Adapter /A
  126.     NDIS device driver, even when supporting multiple adapters.
  127.  
  128.     Add the following "DEVICE =" statement to the CONFIG.SYS file to allow
  129.     the IBM Token-Ring Network 16/4 Busmaster Server Adapter/A NDIS device
  130.     driver to initialize:
  131.  
  132.        DEVICE = d:\pathname\IBMTRBM.OS2
  133.  
  134.     where d:\pathname\ is the drive and path where the IBM Token-Ring
  135.     Network 16/4 Busmaster Server Adapter /A NDIS device driver has
  136.     been installed.
  137.  
  138.  
  139.  
  140.  
  141. CONFIGURING THE DEVICE DRIVER
  142.  
  143.  
  144.      The configuration file for the IBM Token-Ring Network 16/4 Busmaster
  145.      Server Adapter /A NDIS device driver is the PROTOCOL.INI file.  The
  146.      following information describes the configuration parameters
  147.      accepted by the IBM Token-Ring Network 16/4 Busmaster Server Adapter
  148.      /A NDIS device driver.  For more information about the PROTOCOL.INI
  149.      file, see the 3COM/Microsoft Lan Manager Network Driver Interface
  150.      Specification.
  151.  
  152.                                                                         Page 3
  153.  
  154.  
  155.  
  156.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  157.                     NDIS Device Driver User's Guide (con't)
  158.  
  159.  
  160.  
  161.  
  162.  
  163.      Default PROTOCOL.INI Configuration
  164.  
  165.      The device driver accepts 10 parameters (see Modifying PROTOCOL.INI
  166.      Parameters) in the PROTOCOL.INI file.  The PROTOCOL.INI file should
  167.      contain a section for each IBM Token-Ring Network 16/4 Busmaster
  168.      Server Adapter /A installed in the target machine that will be used
  169.      for token-ring communications.
  170.  
  171.      The following is an example of a section in a PROTOCOL.INI file that
  172.      provides the configuration parameters to load and initialize an
  173.      IBM Token-Ring Network 16/4 Busmaster Server Adapter /A.
  174.  
  175.      The section name (in the following, TOKEN1) must be different for
  176.      each adapter's configuration.
  177.  
  178.  
  179.  
  180.             [TOKEN1]
  181.                 DriverName   = IBMTRBM$
  182.                 BootStrap    = C:\IBMLAN\DRIVERS\TOKENRNG\WRTRAM.BIN
  183.                 MicroCode    = C:\IBMLAN\DRIVERS\TOKENRNG\MONT400.BIN
  184.                 AdapBuffSize = 1032
  185.                 AdapMinTran  = 16
  186.                 AdapMaxTran  = 40
  187.                 MinRcvBuffs  = 16
  188.                 SizWorkBuf   = 2048
  189.                 MaxTransmits = 10
  190.                 NetAddress   = "400000000077"
  191.  
  192.  
  193.                                                                         Page 4
  194.  
  195.  
  196.  
  197.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  198.                     NDIS Device Driver User's Guide (con't)
  199.  
  200.  
  201.  
  202.  
  203.  
  204.      The following is a example of a PROTOCOL.INI file that contains two
  205.      adapter configuration sections:
  206.  
  207.  
  208.  
  209.                 [TOKEN1]
  210.                     DriverName   = IBMTRBM$
  211.                     BootStrap    = C:\IBMLAN\DRIVERS\TOKENRNG\WRTRAM.BIN
  212.                     MicroCode    = C:\IBMLAN\DRIVERS\TOKENRNG\MONT400.BIN
  213.                     AdapBuffSize = 1032
  214.                     AdapMinTran  = 16
  215.                     AdapMaxTran  = 40
  216.                     MinRcvBuffs  = 16
  217.                     SizWorkBuf   = 2048
  218.                     MaxTransmits = 10
  219.                     NetAddress   = "400000000077"
  220.  
  221.  
  222.                 [TOKEN2]
  223.                     DriverName   = IBMTRBM$
  224.                     BootStrap    = C:\IBMLAN\DRIVERS\TOKENRNG\WRTRAM.BIN
  225.                     MicroCode    = C:\IBMLAN\DRIVERS\TOKENRNG\MONT400.BIN
  226.                     AdapBuffSize = 1032
  227.                     AdapMinTran  = 16
  228.                     AdapMaxTran  = 40
  229.                     MinRcvBuffs  = 16
  230.                     SizWorkBuf   = 2048
  231.                     MaxTransmits = 10
  232.                     NetAddress   = "400000000078"
  233.  
  234.                                                                         Page 5
  235.  
  236.  
  237.  
  238.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  239.                     NDIS Device Driver User's Guide (con't)
  240.  
  241.  
  242.  
  243.  
  244.  
  245.      Modifying PROTOCOL.INI Parameters
  246.  
  247.      Edit the PROTOCOL.INI file to modify the parameters.  All the keyword
  248.      parameters for the IBM Token-Ring Network 16/4 Busmaster Server Adapter
  249.      /A NDIS device driver can be modified except the DriverName parameter.
  250.      The following information describes each keyword parameter and dis-
  251.      cusses the possible values.  When modifying any vaules, use caution
  252.      to select a new value close to the defined default.  Using the maximum
  253.      values for several of the parameters at the same time may cause the
  254.      device driver to fail to load.  It is difficult to define the upper
  255.      bound that is valid.  Use values near the accepted default as a
  256.      guideline.
  257.  
  258.  
  259.      PROTOCOL.INI Parameters
  260.  
  261.  
  262.          DriverName
  263.  
  264.          This required parameter indicates the network adapter driver
  265.          name for the module. This parameter must be set to IBMTRBM$.
  266.          Numerics before or after the $ are not supported.  If omitted,
  267.          the IBM Token-Ring Network 16/4 Busmaster Server Adapter /A
  268.          NDIS device driver will ignore that section of the PROTOCOL.INI
  269.          file.
  270.  
  271.  
  272.          BootStrap
  273.  
  274.          This parameter specifies the path to the network adapter card
  275.          loader program, WRTRAM.BIN.  The network adapter card loader
  276.          program is downloaded onto the network adapter card.  Then
  277.          the network adapter card loader program downloads the network
  278.          adapter card program onto the IBM Token-Ring Network 16/4 Bus-
  279.          master Server Adapter /A.  If this parameter is omitted, the
  280.          default C:\WRTRAM.BIN is used as the location and name of the
  281.          adapter card loader program.
  282.  
  283.  
  284.                                                                         Page 6
  285.  
  286.  
  287.  
  288.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  289.                     NDIS Device Driver User's Guide (con't)
  290.  
  291.  
  292.  
  293.  
  294.          MicroCode
  295.  
  296.          This parameter specifies the path to the network adapter card
  297.          program, MONT400.BIN.  If this parameter is omitted, the de-
  298.          fault C:\MONT400.BIN is as the location and name of the adap-
  299.          ter card program.  Refer to the BootStrap parameter for more
  300.          information.
  301.  
  302.  
  303.          AdapBuffSize
  304.  
  305.          This parameter specifies the size of the buffers on the net-
  306.          work adapter card.  The value of this parameter must be a
  307.          multiple of 8.  The size of the buffers is actually 8 bytes
  308.          less than the amount specified, because there are 8 bytes of
  309.          overhead associate with each buffer.
  310.  
  311.          Default value:  1032
  312.          Minimum value:    96
  313.          Maximum value:  2048
  314.  
  315.          If this parameter is omitted the default value of 1032 is used.
  316.  
  317.  
  318.          AdapMinTran
  319.  
  320.          This parameter specifies the minimum amount of buffer resources
  321.          reserved for transmit buffers.
  322.  
  323.          Default value:    4
  324.          Minimum value:    4
  325.          Maximum value:  676
  326.  
  327.          If this keyword is omitted the default value of 4 is be used.
  328.  
  329.  
  330.          AdapMaxTran
  331.  
  332.          This parameter specifies the maximum amount of buffer resources
  333.          reserved for transmit buffers.
  334.  
  335.          Default value:    6
  336.          Minimum value:   40
  337.          Maximum value:  676
  338.  
  339.          By limiting the maximum number of buffer resources used for
  340.          transmission,  the buffer resources used for receiving frames
  341.          is defined. If this parameter is omitted the default value of
  342.          40 will be used.
  343.  
  344.                                                                         Page 7
  345.  
  346.  
  347.  
  348.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  349.                     NDIS Device Driver User's Guide (con't)
  350.  
  351.  
  352.  
  353.  
  354.          MaxTransmits
  355.  
  356.          This parameter specifies the maximum number of transmit queue
  357.          entries. The network adapter driver allocates approximately
  358.          260 bytes for each transmit queue entry.  The value of this
  359.          parameter should be high enough to accommodate the sum of all
  360.          MaxTransmits parameter values for all protocol drivers using
  361.          the adapter concurrently.
  362.  
  363.          Default value:     10
  364.          Minimum value:      1
  365.          Maximum value:  65535
  366.  
  367.          If this keyword is omitted a value of 10 is used.
  368.  
  369.  
  370.          MinRcvBuffs
  371.  
  372.          This parameter specifies the minimum number of receive buffers
  373.          that are allocated.  For a 4MB token-ring network, the value
  374.          of this parameter must have the following relationship:
  375.  
  376.          minrcvbuffs x sizworkbuf >= 4500 bytes
  377.  
  378.          For a 16MB token-ring network, the value of this parameter
  379.          must have the following relationship:
  380.  
  381.          minrcvbuffs x sizworkbuf >= 18000 bytes
  382.  
  383.          If the number of buffers is excessive and the size of the
  384.          buffers unusually large (see SizWorkBuf), then the device
  385.          driver may fail to load.  The values selected for these key-
  386.          word parameters should be within close range of the provided
  387.          defaults.
  388.  
  389.          Default value:     16
  390.          Minimum value:      1
  391.          Maximum value:  65535
  392.  
  393.          If this keyword is omitted a value of 16 is used.
  394.  
  395.                                                                         Page 8
  396.  
  397.  
  398.  
  399.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  400.                     NDIS Device Driver User's Guide (con't)
  401.  
  402.  
  403.  
  404.  
  405.          SizWorkBuf
  406.  
  407.          This parameter specifies the size of each receive buffer.
  408.          The value of this parameter should be high enough to accomodate
  409.          the largest frame of any protocol driver using the network
  410.          adapter driver.  Refer to the MinRcvBuffs parameter for more
  411.          information about the value of this parameter.
  412.  
  413.          Default value:   2048
  414.          Minimum value:      1
  415.          Maximum value:  65535
  416.  
  417.          If this keyword is omitted a value of 2048 is used.
  418.  
  419.          NetAddress
  420.  
  421.          This parameter overrides the network address of the network
  422.          adapter card.  Specify this parameter only if there are dup-
  423.          licate addresses on the netowrk.  The value of this parameter
  424.          is a hexadecimal string of 12 digits enclosed in quotes, as
  425.          in "400001020304".  The address must be unique among all other
  426.          network adapter addresses on the network. Specify the network
  427.          address in IBM Token-Ring network format.  If the protocol
  428.          driver specifies a network adapter address for the network
  429.          adapter driver, that value becomes the default value for the
  430.          network adapter driver.
  431.  
  432.          Default value:   Universially administered address (burned-in address)
  433.          Minimum value:   "400000000000"
  434.          Maximum value:   "40007FFFFFFF"
  435.  
  436.  
  437.      Configuring Multiple Adapters
  438.  
  439.      The PROTOCOL.INI parameters for the first DriverName = IBMTRBM$
  440.      applies to the adapter in the lowest Micro Channel slot number.
  441.      The second DriverName = keyword applies to the adapter card in
  442.      the next higher slot, and so on.
  443.  
  444.      Adapters are initialized based on occurrences of the DriverName =
  445.      IBMTRBM$ statement in a section in the PROTOCOL.INI file, regardless
  446.      of bind specifications.
  447.  
  448.  
  449.      Resource Allocation
  450.  
  451.      Parameters are processed for each adapter.  Resources allocated for
  452.      each adapter are reserved for use by only that adapter.
  453.  
  454.                                                                         Page 9
  455.  
  456.  
  457.  
  458.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  459.                     NDIS Device Driver User's Guide (con't)
  460.  
  461.  
  462.  
  463.  
  464. RESTRICTIONS
  465.  
  466.  
  467.      Initialization Failure
  468.  
  469.      If a section in the PROTOCOL.INI file is incorrect and a particular
  470.      adapter cannot be loaded, the IBM Token-Ring Network 16/4 Busmaster
  471.      Server Adapter /A NDIS device driver will not load any of the adap-
  472.      ters and will not complete initialization.  In this situation, the
  473.      IBM Token-Ring Network 16/4 Busmaster Server Adapter /A NDIS device
  474.      driver cannot be used by a protocol stack until the PROTOCOL.INI
  475.      section is fixed.
  476.  
  477.      If a adapter card cannot be loaded due to a hardware fault, the
  478.      adapter should be removed. Otherwise, the faulting adapter will
  479.      prevent all the other IBM Token-Ring Network 16/4 Busmaster Server
  480.      adapters from being loaded and being used by the protocol stack.
  481.  
  482.  
  483.      DOS Mode Support
  484.  
  485.      The IBM Token-Ring Network 16/4 Busmaster Server Adapter /A NDIS
  486.      device driver will execute in a protect mode system only.  The
  487.      PROTECTMODE = YES statement should be included in the CONFIG.SYS.
  488.  
  489.  
  490.      Interrupt Level
  491.  
  492.      All IBM Token-Ring Network 16/4 Busmaster Server adapters must exe-
  493.      cute using the same interrupt level. SETUP should be used to change
  494.      the rings to use the same interrupt level.  By default, SETUP places
  495.      adapters on different interrupt levels.
  496.  
  497.      The interrupt level that is chosen may be shared with other devices.
  498.  
  499.      NDIS Restrictions
  500.  
  501.      The following NDIS general requests are not supported by the IBM
  502.      Token-Ring Network 16/4 Busmaster Server Adapter /A NDIS device
  503.      driver:
  504.  
  505.      *  ResetMac
  506.      *  Interrupt
  507.      *  StartReset
  508.      *  EndReset.
  509.  
  510.      The following NDIS general requests are supported but with
  511.      restrictions:
  512.  
  513.      *  TransmitChain - Only physical addresses are supported
  514.      *  SetStationAddress - May only be issued before the adapter is
  515.         opened using the NDIS OPENADAPTER general request.
  516.  
  517.                                                                         Page 10
  518.  
  519.  
  520.  
  521.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  522.                     NDIS Device Driver User's Guide (con't)
  523.  
  524.  
  525.  
  526.  
  527. MESSAGES
  528.  
  529.      ───────────────────────────────────────────────────────────────
  530.  
  531.      LT40004E   The microcode file xxxxxxxx could not be opened.
  532.  
  533.      Cause:  An unexpected error occurred when the
  534.      program attempted to open the microcode file.
  535.  
  536.      Action:  Check the drive and directory to ensure that
  537.      the microcode file exists.  Check the microcode file name
  538.      specified in PROTOCOL.INI to ensure that it is correct.
  539.      If the problem persists, reinstall the microcode file in
  540.      the proper directory.
  541.  
  542.      ───────────────────────────────────────────────────────────────
  543.  
  544.      LT40005E   The microcode file xxxxxxxx could not be read.
  545.  
  546.      Cause:  An unexpected error occurred when the
  547.      program attempted to read the microcode file.
  548.  
  549.      Action:  Reinstall the microcode file in the proper
  550.      directory.
  551.  
  552.      ───────────────────────────────────────────────────────────────
  553.  
  554.      LT40006E   The bootstrap file xxxxxxxx could not be opened.
  555.  
  556.      Cause:  An unexpected error occurred when the
  557.      program attempted to open the bootstrap file.
  558.  
  559.      Action:  Check the drive and directory to ensure
  560.      that the bootstrap file exists.  Check the bootstrap
  561.      file name specified in PROTOCOL.INI to ensure that
  562.      it is correct.
  563.  
  564.      If the problem persists, reinstall the bootstrap file
  565.      in the proper directory.
  566.  
  567.      ───────────────────────────────────────────────────────────────
  568.  
  569.      LT40007E   The bootstrap file xxxxxxxx could not be read.
  570.  
  571.      Cause:  An unexpected error occurred when the
  572.      program attempted to read the bootstrap file.
  573.  
  574.      Action:  Reinstall the bootstrap file in the proper
  575.      directory.
  576.  
  577.                                                                         Page 11
  578.  
  579.  
  580.  
  581.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  582.                     NDIS Device Driver User's Guide (con't)
  583.  
  584.  
  585.  
  586.  
  587.      ───────────────────────────────────────────────────────────────
  588.  
  589.      LT40008E   The parameter specified in PROTOCOL.INI for
  590.                 keyword xxxxxxxxxxxx is not the proper character
  591.                 type.
  592.  
  593.      Cause:  The value provided for the keyword in the
  594.      IBMTRBM module in PROTOCOL.INI is not the correct type.
  595.  
  596.      Action:  Change the value in PROTOCOL.INI to
  597.      the correct type for the parameter.
  598.  
  599.      ───────────────────────────────────────────────────────────────
  600.  
  601.       LT40009E
  602.      An unrecoverable error occurred in the
  603.      IBM Token-Ring Network 16/4 Busmaster Server Adapter/A NDIS
  604.      device driver program.
  605.  
  606.      Cause:  An internal software error occurred.
  607.      Action:  Contact your vendor sales representative.
  608.  
  609.      ───────────────────────────────────────────────────────────────
  610.  
  611.      LT40010E   All IBM Token-Ring Network 16/4 Busmaster
  612.                 Server Adapter/A adapters must be set to
  613.                 the same interrupt level.
  614.  
  615.      Cause:  One or more IBM Token-Ring Network 16/4 Busmaster
  616.      Server Adapter/A adapters are set to a different interrupt level.
  617.      To function properly, these adapters must all be set to the
  618.      same interrupt level.
  619.  
  620.      Action:  Use the reference diskette that came with your
  621.      computer to ensure that all IBM Token-Ring Network 16/4 Busmaster
  622.      Server Adapter/A adapters are set to the same interrupt level.
  623.  
  624.      ───────────────────────────────────────────────────────────────
  625.  
  626.      LT40011E   A data-check error occurred while attempting
  627.                 to load the bootstrap code onto the adapter.
  628.  
  629.      Cause:  The bootstrap code was unable to load properly
  630.      onto the IBM Token-Ring Network 16/4 Busmaster Server
  631.      Adapter/A adapter.
  632.  
  633.      Action:  Contact your vendor sales representative.
  634.  
  635.                                                                         Page 12
  636.  
  637.  
  638.  
  639.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  640.                     NDIS Device Driver User's Guide (con't)
  641.  
  642.  
  643.  
  644.  
  645.      ───────────────────────────────────────────────────────────────
  646.  
  647.      LT40012E   A checksum error occurred while attempting
  648.                 to load the bootstrap code onto the adapter.
  649.  
  650.      Cause:  The bootstrap code was unable to load properly
  651.      onto the IBM Token-Ring Network 16/4 Busmaster Server
  652.      Adapter/A adapter.
  653.  
  654.      Action:  Contact your vendor sales representative.
  655.  
  656.      ───────────────────────────────────────────────────────────────
  657.  
  658.      LT40013E   This version of the IBM Token-Ring Network
  659.                 16/4 Busmaster Server Adapter/A NDIS device
  660.                 driver will not run on an 80286 machine.
  661.  
  662.      Cause:  The 80286 processor is not supported for this
  663.      version of the device driver.
  664.  
  665.      Action:  Either install the 80286 version of the
  666.      device driver on this machine or remove the statement
  667.      that installs the device driver from CONFIG.SYS.
  668.  
  669.  
  670.  
  671.      ───────────────────────────────────────────────────────────────
  672.  
  673.      LT40014E   The parameter values have forced the
  674.                 control-block size to exceed the allowable
  675.                 limit.
  676.  
  677.      Cause:  The parameters specified require more space for
  678.      processing than can be handled.  The maximum allowable
  679.      control-block size is 64KB.
  680.  
  681.      Action:  Reduce the value specified for the SIZWORKBUF
  682.      or MINRCVBUFFS parameter to change the amount of storage
  683.      required for the control-blocks.
  684.  
  685.      ───────────────────────────────────────────────────────────────
  686.  
  687.      LT40015E   The adapter is not responding.
  688.  
  689.      Cause:  The adapter is not responding to a request to load
  690.      the bootstrap code.
  691.  
  692.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  693.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  694.      your vendor sales representative.
  695.  
  696.                                                                         Page 13
  697.  
  698.  
  699.  
  700.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  701.                     NDIS Device Driver User's Guide (con't)
  702.  
  703.  
  704.  
  705.  
  706.      ───────────────────────────────────────────────────────────────
  707.  
  708.      LT40016E   A 2KB window error occurred while attempting
  709.                 to load the bootstrap code onto the adapter.
  710.  
  711.      Cause:  The adapter is not responding to a request to load
  712.      the bootstrap code.
  713.  
  714.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  715.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  716.      your vendor sales representative.
  717.      ───────────────────────────────────────────────────────────────
  718.  
  719.      LT40017E   An error occurred while attempting to run
  720.                 the bootstrap code.
  721.  
  722.      Cause:  The adapter is not responding to a request to run
  723.      the bootstrap code.
  724.  
  725.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  726.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  727.      your vendor sales representative.
  728.  
  729.      ───────────────────────────────────────────────────────────────
  730.  
  731.      LT40018E   A parameter error occurred while attempting
  732.                 to run the bootstrap code.
  733.  
  734.      Cause:  The adapter is not responding to a request to run
  735.      the bootstrap code.
  736.  
  737.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  738.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  739.      your vendor sales representative.
  740.  
  741.      ───────────────────────────────────────────────────────────────
  742.  
  743.      LT40019E   A write error occurred while attempting
  744.                 to load the bootstrap code onto the adapter.
  745.  
  746.      Cause:  The bootstrap code was unable to load properly
  747.      onto the IBM Token-Ring Network 16/4 Busmaster Server
  748.      Adapter/A adapter.
  749.  
  750.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  751.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  752.      your vendor sales representative.
  753.  
  754.                                                                         Page 14
  755.  
  756.  
  757.  
  758.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  759.                     NDIS Device Driver User's Guide (con't)
  760.  
  761.  
  762.  
  763.  
  764.      ───────────────────────────────────────────────────────────────
  765.  
  766.      LT40020E   A checksum error occurred while attempting
  767.                 to load the microcode onto the adapter.
  768.  
  769.      Cause:  The microcode was unable to load properly
  770.      onto the IBM Token-Ring Network 16/4 Busmaster Server
  771.      Adapter/A adapter.
  772.  
  773.      Action:  Contact your vendor sales representative.
  774.  
  775.      ───────────────────────────────────────────────────────────────
  776.  
  777.      LT40021E The microcode encountered a program-status
  778.               error while attempting to write to the adapter.
  779.  
  780.      Cause:  The microcode was unable to write properly
  781.      to the IBM Token-Ring Network 16/4 Busmaster Server
  782.      Adapter/A adapter.
  783.  
  784.      Action:  Contact your vendor sales representative.
  785.  
  786.      ───────────────────────────────────────────────────────────────
  787.  
  788.      LT40022E   A reset error occurred while attempting to
  789.                 initialize the adapter microcode.
  790.  
  791.      Cause:  The adapter is not responding to a request to initialize
  792.      the microcode.
  793.  
  794.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  795.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  796.      your vendor sales representative.
  797.  
  798.      ───────────────────────────────────────────────────────────────
  799.  
  800.      LT40023E   A parameter error occurred while attempting
  801.                 to run the microcode.
  802.  
  803.      Cause:  The adapter is not responding to a request to run
  804.      the microcode.
  805.  
  806.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  807.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  808.      your vendor sales representative.
  809.  
  810.                                                                         Page 15
  811.  
  812.  
  813.  
  814.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  815.                     NDIS Device Driver User's Guide (con't)
  816.  
  817.  
  818.  
  819.  
  820.      ───────────────────────────────────────────────────────────────
  821.  
  822.      LT40024E The burned-in address could not be found
  823.               on the IBM Token-Ring Network 16/4 Busmaster
  824.               Server Adapter/A adapter.
  825.  
  826.      Cause:  The burned-in address on the adapter could not be located.
  827.  
  828.      Action:  Either use the set network address (NETADDRESS)
  829.      parameter in PROTOCOL.INI to override the burned-in address or
  830.      run the hardware diagnostics for the IBM Token-Ring Network
  831.      16/4 Busmaster Server Adapter/A adapter and contact your
  832.      vendor sales representative.
  833.  
  834.  
  835.      ───────────────────────────────────────────────────────────────
  836.  
  837.      LT40025W   Duplicate device driver statements exist
  838.                 in CONFIG.SYS.
  839.  
  840.      Cause:  Only one occurrence of the device driver statement
  841.      for the IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  842.      NDIS MAC device driver is required to support multiple adapters.
  843.      Additional instances of the device driver statement in CONFIG.SYS
  844.      will be ignored.
  845.  
  846.      Action:  Remove the duplicate device driver statements from
  847.      CONFIG.SYS.
  848.  
  849.      ───────────────────────────────────────────────────────────────
  850.  
  851.      LT40026E   The required parameter DRIVERNAME was not
  852.                 found in PROTOCOL.INI.
  853.  
  854.      Cause:  The parameter specifying the driver name (DRIVERNAME) was not
  855.      found in PROTOCOL.INI.  This parameter is required.
  856.  
  857.      Action:  Change PROTOCOL.INI to specify the proper information.
  858.  
  859.      ───────────────────────────────────────────────────────────────
  860.  
  861.      LT40027E   The protocol manager could not be opened.
  862.  
  863.      Cause:  An unexpected error occurred when the
  864.      program attempted to open the protocol manager.
  865.      The IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  866.      NDIS device driver has been removed.
  867.  
  868.      Action:  Check the drive and directory to ensure that
  869.      the protocol manager is located in the specified path.
  870.  
  871.                                                                         Page 16
  872.  
  873.  
  874.  
  875.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  876.                     NDIS Device Driver User's Guide (con't)
  877.  
  878.  
  879.  
  880.  
  881.      ───────────────────────────────────────────────────────────────
  882.  
  883.      LT40028E   An unrecoverable error occurred while
  884.                 attempting to register the IBM Token-Ring
  885.                 Network 16/4 Busmaster Server Adapter/A NDIS
  886.                 device driver program with the protocol manager.
  887.  
  888.      Cause:  The device driver was unable to register with
  889.      the protocol manager.
  890.  
  891.      Action:  Reinstall the protocol manager and
  892.      try the operation again.
  893.  
  894.      ───────────────────────────────────────────────────────────────
  895.  
  896.      LT40029E   No physical adapter was found in this machine.
  897.  
  898.      Cause:  There was no adapter found in this machine.
  899.      IBM Token-Ring Network 16/4 Busmaster Server Adapter/A adapters
  900.      are required to run the MAC device driver.
  901.  
  902.      Action:  Install an IBM Token-Ring Network 16/4 Busmaster
  903.      Server Adapter/A adapter in this machine, or remove the device
  904.      driver statement from CONFIG.SYS.
  905.  
  906.      ───────────────────────────────────────────────────────────────
  907.  
  908.      LT40030W   The unrecognized parameter xxxxxxxxxxxx was
  909.                 found in PROTOCOL.INI.
  910.  
  911.      Cause:  An unrecognized parameter was found
  912.      while processing the IBM Token-Ring Network 16/4 Busmaster
  913.      Server Adapter/A section of PROTOCOL.INI.
  914.  
  915.      Action:  Correct the parameter or remove it from
  916.      PROTOCOL.INI.
  917.  
  918.                                                                         Page 17
  919.  
  920.  
  921.  
  922.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  923.                     NDIS Device Driver User's Guide (con't)
  924.  
  925.  
  926.  
  927.  
  928.      ───────────────────────────────────────────────────────────────
  929.  
  930.      LT40031W   The value specified for network address
  931.                 in PROTOCOL.INI is not valid.  The burned-in
  932.                 address will be substituted.
  933.  
  934.      Cause:  The value specified for the network address parameter in
  935.      PROTOCOL.INI is not valid for one of the following reasons:
  936.  
  937.      1.  Invalid local station address
  938.      2.  Too long
  939.      3.  Too short
  940.      4.  Contains non-hexadecimal characters
  941.      5.  Not enclosed in double quotes
  942.  
  943.      Action:  Remove or correct the network address parameter
  944.      (NETADDRESS). A valid value for this parameter is 12 characters
  945.      long, is enclosed in double quotes, and contains only valid
  946.      hexadecimal characters within the range of 400000000000 through
  947.      40007FFFFFFF.
  948.  
  949.      ───────────────────────────────────────────────────────────────
  950.  
  951.      LT40033E   A duplicate network address was found
  952.                 while inserting onto the ring.
  953.  
  954.      Cause:  The network address that the adapter wants to use on the
  955.      token-ring is being used by another node.
  956.  
  957.      Action:  Either modify PROTOCOL.INI to provide a different
  958.      value for the network address (NETADDRESS) parameter, use the
  959.      default burned-in address, or remove the other node that is
  960.      using this network address from the ring.
  961.  
  962.      ───────────────────────────────────────────────────────────────
  963.  
  964.      LT40034E   Ring failure or beaconing was encountered
  965.                 while inserting onto the ring.
  966.  
  967.      Cause:  The ring speed is different from the speed of the
  968.      node attempting to insert onto the ring.
  969.  
  970.      Action:  Use the reference diskette that came with your
  971.      computer to ensure that the adapter is configured at the same
  972.      speed as the token-ring.
  973.  
  974.                                                                         Page 18
  975.  
  976.  
  977.  
  978.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  979.                     NDIS Device Driver User's Guide (con't)
  980.  
  981.  
  982.  
  983.  
  984.      ───────────────────────────────────────────────────────────────
  985.  
  986.      LT40035E   A hardware failure occurred while attempting
  987.                 to open the adapter.
  988.  
  989.      Cause:  When the adapter tried to insert onto the token-ring, a
  990.      hardware error occurred on the adapter.
  991.  
  992.      Action:  Run the hardware diagnostics for the IBM Token-Ring
  993.      Network 16/4 Busmaster Server Adapter/A adapter.  Contact
  994.      your vendor sales representative.
  995.  
  996.      ───────────────────────────────────────────────────────────────
  997.  
  998.      LT40036E   A lobe media error has occurred.  Ensure
  999.                 that the token-ring cable is connected
  1000.                 to the adapter.
  1001.  
  1002.      Cause:  While attempting to open the adapter, an indication
  1003.      was received that the adapter is not properly connected to
  1004.      the token-ring.
  1005.  
  1006.      Action:  Ensure that the token-ring cable is connected to
  1007.      the adapter and to the token-ring multistation access unit (MAU).
  1008.  
  1009.      If the error persists, use a different token-ring cable
  1010.      and check to ensure that the connection to the MAU is
  1011.      functioning properly.  Then run the hardware diagnostics
  1012.      for the IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  1013.      adapter.
  1014.  
  1015.      ───────────────────────────────────────────────────────────────
  1016.  
  1017.      LT40037W   The version of the installed device driver is not
  1018.                 optimized for the 80386/80486 processor.
  1019.  
  1020.      Cause:  The version of the IBM Token-Ring Network 16/4
  1021.      Busmaster Server Adapter/A NDIS MAC device driver is
  1022.      built for an 80286 machine.  The version will function
  1023.      correctly on this 80386/80486 machine, but performance
  1024.      benefits will not be available.
  1025.  
  1026.      Action:  Install the optimized version on this machine.
  1027.  
  1028.                                                                         Page 19
  1029.  
  1030.  
  1031.  
  1032.            IBM Token-Ring Network 16/4 Busmaster Server Adapter/A
  1033.                     NDIS Device Driver User's Guide (con't)
  1034.  
  1035.  
  1036.  
  1037.  
  1038.      ───────────────────────────────────────────────────────────────
  1039.  
  1040.      LT40038E   The installed IBM Token-Ring Network 16/4
  1041.                 Busmaster Server Adapter/A NDIS device driver
  1042.                 cannot run on this operating system.
  1043.  
  1044.      Cause:  The device driver installed is designed to run on
  1045.      a different operating system.
  1046.  
  1047.      Action:  Do the following:
  1048.  
  1049.      1.  Locate the current version of IBMTRBM.OS2 on the machine.
  1050.      2.  Erase IBMTRBM.OS2.
  1051.      3.  Copy IBMTRBM.286 from the installation diskette
  1052.          into the directory.
  1053.      4.  Rename IBMTBM.286 to IBMTRBM.OS2.
  1054.      5.  Restart your system.
  1055.  
  1056.      ───────────────────────────────────────────────────────────────
  1057.  
  1058.  
  1059.