home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / us8210b4.dsk / IBMCOM / MACS / MACS.ZIP / ibmcom / macs / rtr16nds.txt < prev    next >
Text File  |  1995-09-13  |  7KB  |  165 lines
  1. Automatic Installation
  2.  
  3.     This driver supports the automatic installation procedure defined
  4.     by the IBM LAN Adapter and Protocol Support (LAPS) module. LAPS is
  5.     provided by IBM with the following services:
  6.  
  7.         IBM OS/2 Extended Services 1.0
  8.         IBM OS/2 LAN Server 2.0
  9.         IBM OS/2 LAN Requester 2.0
  10.  
  11. Manual Installation
  12.  
  13.      1. Copy the driver RTR16NDS.OS2, and the message file RTR16NDS.MSG
  14.         from the installation diskette to the desired fixed disk
  15.         drive and directory.
  16.  
  17.     NOTE: If you are using an FPA based adapter, copy the file RTR16FPA.COD
  18.           from the installation diskette's DIAGS directory to the ROOT
  19.           directory on your LAN Server system drive.  When the driver
  20.           loads, the message "Utilizing FPA microcode" will be displayed if
  21.           the RTR16FPA.COD file was found and an FPA based adapter is being
  22.           used. If the RTR16FPA.COD file was not found or the adapter is
  23.           non-FPA based, the message "Utilizing MAC microcode" will be
  24.           displayed.
  25.  
  26.      2. Add the following line to the CONFIG.SYS.
  27.  
  28.           DEVICE=[drive:directory]RTR16NDS.OS2
  29.  
  30.         This line should be entered immediately following the line
  31.         which installs the PROTMAN.OS2 device driver.
  32.  
  33.     NOTE: You must specify a DPATH in CONFIG.SYS to the subdirectory
  34.           containing the RTR16NDS.MSG file to enable driver error
  35.           messages and alleviate the "Cannot find message file" error
  36.           at boot time.
  37.  
  38.      3. Add the following section to PROTOCOL.INI
  39.  
  40.           [RTR16NDS_NIF]
  41.               DriverName = RTRNDS$
  42.  
  43.      4. Add RTR16NDS_NIF to the bindings list of the protocol in the
  44.         PROTOCOL.INI. An example protocol section follows.
  45.  
  46.           [NETBEUI_XIF]
  47.                DriverName = NETBEUI$
  48.                Bindings = RTR16NDS_NIF
  49.  
  50. RTR16NDS Parameters
  51.  
  52.      The PROTOCOL.INI file defines the configuration of protocol
  53.      and NDIS drivers. The following table summarizes RTR16NDS
  54.      parameters.
  55.  
  56. ┌────────────────────┬──────────────────────────────┬──────────┐ 
  57. │  Parameter         │         Range                │ Default  │
  58. │                    │                              │   OS/2   │
  59. ├────────────────────┼──────────────────────────────┼──────────┤ 
  60. │  DRIVERNAME        │ RTRNDS$ or RTRNDSn$          │ Required │
  61. │  IOADDRESS         │ 0xA00, 0xA20, 0xA40, 0xA60   │     -    │
  62. │  MAXTRANSMITS      │ 3 - 50                       │     6    │
  63. │  NUMRXBUFFERS      │ 3 - 100                      │     6    │
  64. │  LOOKAHEAD         │ See description              │          │
  65. │  RXBUFFERSIZE      │ 256 - 17960                  │    2048  │
  66. │  PSEUDODMA         │                              │     -    │
  67. │  NOEARLYRELEASE    │                              │     -    │
  68. │  NETADDRESS        │ "000000000000"-"7FFFFFFFFFFF"│    BIA   │
  69. │  PIU               │ 265 - 2048                   │          │
  70. │  RPL               │                              │     -    │
  71. │  PROMISCUOUS       │                              │     -    │
  72. └────────────────────┴──────────────────────────────┴──────────┘
  73.  
  74. DRIVERNAME
  75.      Identifies the network device driver. The DRIVERNAME is RTRNDS$
  76.      for the first driver and RTRNDS2$ for the second, and so on.
  77.      This parameter is required.
  78.  
  79. IOADDRESS
  80.      If no IOADDRESS is specified, the driver will search for an
  81.      adapter at all I/O addresses until one is found. Otherwise,
  82.      only the specified I/O address is checked. This parameter is
  83.      required when multi adapter support is desired.
  84.  
  85. MAXTRANSMITS
  86.      Sets the number of transmits that can be queued simultaneously
  87.      by the driver.
  88.  
  89. NUMRXBUFFERS
  90.      Sets the number of receive buffers to allocate.
  91.  
  92. LOOKAHEAD
  93.      Directs the driver to use the Receive Lookahead method in lieu of
  94.      the default Receive Chain method.  NDIS requires the upper protocol
  95.      to support either method.  Some protocols have been found to only
  96.      support Receive Lookahead.  Receive Chain will typically give better
  97.      performance on DMA and Pseudo-DMA based adapters.
  98.  
  99. RXBUFFERSIZE
  100.      Sets the size of buffers used to queue received frames in the
  101.      driver. Several buffers may be required to queue a large
  102.      frame. Performance is improved if a received frame fits in one
  103.      buffer. Use the following formula to determine maximum frame
  104.      size. MediaMaxSize equals 17960 @ 16 Mbps, or 4490 @ 4 Mbps.
  105.  
  106.      MaxFrameSize = 
  107.           min(min(8, NumReceiveBuffers) x ReceiveBufferSize, MediaMaxSize)
  108.  
  109.      NOTE: For maximum performance when using an FPA based adapter,
  110.            set RXBUFFERSIZE = 4128.
  111.  
  112. PSEUDODMA
  113.      This entry informs the driver to use pseudo DMA on 16 bit ISA
  114.      adapters. Normally, 16 bit adapters use DMA bus master mode.
  115.      Note that the pseudo DMA option is not supported on Micro-Channel
  116.      adapters. Also note that the 8 bit ISA adapter does not support bus
  117.      master DMA, and always defaults to the pseudo DMA mode. This entry
  118.      is not followed by an equal sign.
  119.  
  120. NOEARLYRELEASE
  121.      This entry informs the driver to disable early token release.
  122.      Early token release reduces the average time another network
  123.      adapter must wait to transmit a frame. This entry is not
  124.      followed by an equal sign.
  125.  
  126. NETADDRESS
  127.      This entry allow the driver to override the burned in address
  128.      (BIA). The entry must be a 12 character string of hexadecimal
  129.      digits, and must be enclosed in quotes.
  130.  
  131. PIU
  132.      Instructs the driver to implement Lying Sends on all transmits smaller
  133.      than the given PIU (Program Interchange Unit) size.  The driver by default 
  134.      will verify each transmit on the physical ring before confirming the
  135.      transmit to the upper protocol.  Personal Communications 3270 ver 3.0x
  136.      requires all PIU transfers to confirm the transmit before it is physically
  137.      transmitted on the ring. The PIU option enables this 'Lying' send.
  138.  
  139. RPL
  140.      This entry provides compatibility when RPLing under OS/2 and
  141.      certain versions of IBM LAN Server. This parameter should be
  142.      specified for each station performing RPL, as required. This
  143.      entry should NOT be specified on server or non-RPLing PC's.
  144.  
  145. PROMISCUOUS
  146.      This entry enables the promiscuous mode in the driver. When
  147.      enabled, the Token Ring adapter will receive and forward to
  148.      the driver all MAC frames, even if they are not addressed to
  149.      the adapters unique node address. This mode will affect driver
  150.      performance and is not recommended for normal use. Either the
  151.      RTR16FPA.COD or RTR16CAF.COD file must have been successfully
  152.      read and downloaded to the adapter for this mode to function.
  153.  
  154.  
  155. For example, the following is a sample PROTOCOL.INI file:
  156.  
  157.      [RTR16NDS_NIF]
  158.           DRIVERNAME = RTRNDS$
  159.           IOADDRESS = 0xA20
  160.           MAXTRANSMITS = 10
  161.           NUMRXBUFFERS = 12
  162.           RXBUFFERSIZE = 4128
  163.           NETADDRESS = "400000000312"
  164.           PSEUDODMA
  165.