Using the Fastmac Plus DOS ODI Driver
=====================================
                                              CSS 1.0(0), January 1996 
                                              ------------------------
Summary
-------

This file provides information about loading Madge DOS ODI drivers for 
use in NetWare environments.

This file has the following sections: 

   1) Overview of the Open Datalink Interface (ODI)
   2) Driver Configuration
   3) Command Line Parameters


1) Overview of the Open Datalink Interface (ODI):
------------------------------------------------

Novell's   Open  Data-Link  Interface  (ODI)  allows  LAN  drivers  on 
different computers to work together despite differences  between  the 
hardware  and/or  the  protocol  stacks they use.  A layer of software 
called the Link Support Layer (LSL), which  is  situated  between  the 
driver  and  the  protocol  stack on each computer, is responsible for 
routing different packet types between the LAN driver  on  a  computer 
and the protocol stack.  

MCBODI.EXE is an ODI driver for DOS workstations. 


NetWare Higher layers:           NCP/LANWP

                     -----------ipx interface-------------

Protocol stacks:                IPXODI/TCPIP

                     ---hardware independent interface----

Link Support Layer:                 LSL

                     ---protocol independent interface----

LAN drivers:                     MCBODI

                     ---------hardware interface----------

Hardware:                 MADGE SMART 16/4 RINGNODE


The MCBODI.EXE driver conforms to ODI specification version 4.0 but is 
backwards  compatible  with  ODI  Specification  version  3.3 (see the 
"RECEIVE MONITOR" option and section 4 below).  

Load MCBODI after the Link Support  Layer  (LSL.COM)  and  before  any 
protocol  stacks (such as IPXODI.COM and TCPIP.EXE).  The following is 
a sample AUTOEXEC.BAT:

LSL             (supplied by Novell)
NESL            (supplied by Novell)
MCBODI
IPXODI          (supplied by Novell)
NETX or VLM     (supplied by Novell)

If you need source-routing support, load the file ROUTE.COM  (supplied 
by Novell) after MCBODI.EXE and before IPXODI.COM.


2) Driver Configuration
-----------------------

The  Madge  DOS  ODI driver is supplied with an associated file called 
MCBODI.INS. This file is used  by  the  Novell  DOS  ODI  Installation 
program.

By default, the driver uses a maximum frame size of 4210 bytes.   This 
gives  a  typical data packet size of 4Kbytes with either NETX or VLM. 
You can alter the packet size by using the "MAX FRAME SIZE" parameter. 
Changing the maximum frame size may affect  peak  performance  of  the 
driver  and  alter  its  DOS  memory  usage.   The default size of the 
transmit and receive buffers is equal to the maximum frame size.  This 
means   that   the   normal   DOS   memory  usage  for  MCBODI.EXE  is 
approximately:

8Kbytes + 2 x maximum frame size

With  the  default  settings,  and  using  DMA,  the  driver's  memory 
requirement  is   about   16Kbytes.    The   memory   requirement   is 
approximately  3Kbytes  less, however, if you use PIO (this is because 
no transmit buffer is needed for PIO transfers).  If  you  need  power 
management or hot swapping, the DOS memory usage is about 8Kbytes more 
(plus  60Kbytes  of  XMS  memory).  The driver can be loaded into high 
memory.

You  can  configure  the  MCBODI driver from a NET.CFG file.  List the 
options required after  the  driver's  section  header:  "LINK  DRIVER 
MCBODI".   If you are using multiple adapters, remember to include one 
"LINK DRIVER MCBODI" section for each instance of the driver.  If  you 
are not using a NET.CFG file, or if you do not specify a PORT, SLOT or 
BIA  setting,  the driver loads onto the first Madge adapter it finds.  
If you load the driver a second time, you must specify either the port 
or the slot number in the LINK DRIVER MCBODI section  for  the  second 
adapter.

The parameters you can specify in NET.CFG are:

PORT nnnn                   If   there  are  multiple  Madge  adapters 
			    installed in a machine, you can  use  this 
			    parameter  to  specify  the IO location of 
			    the adapter you  want  to  use.  You  must 
			    specify the address in hexadecimal. 

SLOT nn                     If   there  are  multiple  Madge  adapters 
			    installed in a machine, you can  use  this 
			    parameter  to  specify the bus slot of the 
			    adapter you want to use. 

BURNT IN ADDRESS nnnnnnnnn  If  there  are  multiple  Madge   adapters 
			    installed  in  a machine, you can use this 
			    parameter  to  specify   the   BIA   (node 
			    address) of the adapter you want to use. 

FRAME abc                   The frame type you require. The only valid 
                            choices  are  "TOKEN-RING"  (normally used 
                            with  IPXODI.COM)  and   "TOKEN-RING_SNAP" 
                            (normally used with TCPIP.EXE).

PROTOCOL abc                A Protocol stack that you require (may  be 
                            entered more than once).

MAX FRAME SIZE nnnn         The  Maximum  packet  size to be supported 
                            including protocol  and  hardware  headers 
                            (4210  represents  a  maximum data size of 
                            4Kbytes).  The minimum frame size you  can 
                            specify  is  632 (1/2Kbytes).  The maximum 
                            frame size you can specify is 18000.  This 
                            frame   size   should   only  be  used  in 
                            configurations required to monitor network 
                            frames (for example, Novell's LANalyzer).

PIO                         Forces  the  driver to use PIO, regardless 
                            of  the adapter's default transfer  method 
                            (DMA  or  MMIO).  

INT n                       You can use this  parameter  to  force  an 
			    interrupt  setting  for  your CardBus 16/4 
			    Adapter (in those computers that allow you 
			    a choice).

NODE ADDRESS nnnnnnnnnnnn   The node address parameter allows  you  to 
                            specify the 6-byte node address to be used 
                            by   the   adapter.    If  you  omit  this 
                            parameter, the  adapter  uses  its  unique 
                            burnt-in  node  address.  We recommend the 
                            burnt-in address whenever possible.

                            You can use any valid  hexadecimal  number 
                            in the range 400000000000 to 7FFFFFFFFFFF.

                            Ensure  that every adapter in your network 
                            has a different node address.

                            Range   :   400000000000  -  7FFFFFFFFFFF 
                            Default : burnt-in  address  of  Ringnode 
                            Abbreviation: (none)

                            Example : NODE ADDRESS 400012345678

RECEIVE MONITOR             This release of MCBODI.EXE conforms to DOS 
			    ODI   specification   version  4.0.   This 
			    specification  does  not  provide  for   a 
			    receive  monitor  function as used in such 
			    products as  LANalyser  (pre  v2.2).   The 
			    "RECEIVE   MONITOR"   option   causes  the 
			    receive monitor function to operate as  in 
			    the  previous  version  of  the  ODI  Spec 
			    (version 3.3). See  section  4  below  for 
			    more details.

HOTSWAP                     
			    
			    If  you specify this option you can remove 
			    and replace the  CardBus  Adapter  without 
			    losing network connections. To do this, go 
			    to  a DOS volume prompt (for example, C:); 
			    eject the card; insert and use a different 
			    card (without  trying  to  access  network 
			    drives), then re-insert the adapter in any 
			    CardBus  slot.   To allow a different card 
			    to be inserted,  you  must  use  the  NODE 
			    ADDRESS option must be used when you first 
			    load MCBODI.

			    If you load MCBODI.EXE without the CardBus 
			    Adapter installed, the driver  will  still 
			    load  properly. Then, when you install the 
			    adapter, you  will  be  able  to  use  the 
			    network  straightaway.  For  this to work, 
			    however, you must specify the  NODEADDRESS 
			    option  when  you  load  the  driver. This 
			    enables  IPXODI  to  determine  the   node 
			    address  of  the  adapter  even though the 
			    adapter is not installed.
			    
                            
POWER MANAGEMENT            This  option  works  in  conjunction  with 
			    POWER.EXE. When  a  machine  is  put  into 
			    "suspend"  mode  the adapter is shut down, 
			    and when the machine is "resumed" the card 
			    gets re-initialized.

ADAPTER WATCHDOG TIMEOUT nn Changes  the period that the adapter waits 
			    before  shutting  itself  down  after  the 
			    computer  has  hung  or  been  reset.  The 
			    default is 8 seconds.   Increase  this  if 
			    you  are  using  applications that disable 
			    system interrupts for  long  periods.   If 
			    you  use  this option but do not specify a 
			    value  for  it,  the  Watchdog  timer   is 
			    disabled. 
			 
FORCE16                     This will force the adapter to insert into 
			    the Token-Ring at 16 mbit/s.
                            
FORCE4                      This will force the adapter to insert into 
			    the Token-Ring at 4 mbit/s.
                            
LLC                         Use this parameter to force an adapter  to 
			    respond  to the LLC frames called TEST and 
			    XID frames (for destination SAP zero).
                         

3) Command Line Parameters
--------------------------

The driver also supports the following command-line switches:

MCBODI    :  Loads the driver into memory.

MCBODI PIO:  Forces the driver to use PIO if possible.  

MCBODI U  :  Unloads the driver from memory if possible.

MCBODI S  :  Displays details of MCBODI drivers currently loaded.

MCBODI I  :  Displays version information.

MCBODI ?  :  Displays a list of command-line switches.

MCBODI H  :  Displays a sample NET.CFG file.


                --------- End of MCBODI.TXT --------
