






Installing IBM* Ethernet Quad-BT and -B2 PeerMaster* Server Adapters
into AT&T System Servers running Windows NT





===============
Section Listing
===============

Section 1: "Overview"
Section 2: "Supported Environments"
Section 3: "Before You Begin"
Section 4: "MCA Hardware Installation"
Section 5: "PCI Hardware Installation"
Section 6: "Contents of IBM PeerMaster Option Diskette"
Section 7: "S/W Installation and Configuration Overview"
Section 8: "Precautions, Limitations and Guidelines"
Section 9: "S/W Installation and Configuration"
Section 10: "Error Messages"
Section 11: "Selectable Parameters"


=====================
Section 1: "Overview"
=====================

The IBM Ethernet Quad PeerMaster adapters operate in either of two
modes: traditional adapter mode or VNET (Virtual Network) mode.  In
traditional mode, the four ports of a PeerMaster adapter are treated
as separate adapters operating on separate subnets, with unique MAC
addresses.  Cross-subnet traffic must be routed, either internally by
the server, or externally by a local router.

When a PeerMaster adapter operates in VNET mode, the multiple LAN
segments to which the ports are attached are treated as a single
subnet,  called a VNET.  To protocol stacks, such as TCP/IP and
NetBIOS, a VNET appears to be a single adapter.  Multiple PeerMaster
adapters may be configured to interoperate in various ways: as one
large VNET (up to 24 segments when using 6 adapters); as multiple
independent VNETs; as traditional subnets; or in any combination of
VNETs and traditional subnets.  Each port within a VNET is configured
with the same MAC address.  Cross-segment traffic within a VNET is
switched by the adapter(s), shielding the server from the task of
handling and routing such traffic.  External internetworking devices
are not required to provide communication between segments of a VNET.

The following guidelines apply to PeerMaster adapters in either
traditional or VNET mode:

  *  Do not externally join (using bridges, switches, or
     concentrators) ports of adapters.
  *  You may configure as many nodes as necessary; the adapter places
     no limit on the number of nodes per segment.

For additional information on VNET Switch Mode refer to the IBM
Ethernet Quad PeerMaster Installation Guide provided with your
adapters.

===================================
Section 2: "Supported Environments"
===================================

The LAN software provided on your Option Diskette supports the
following versions of Microsoft NT Advanced Server:

     NT Advanced Server 3.5
     NT Advanced Server 3.51

The PeerMaster driver provided on your Option Diskette is designed to
control the following adapters:

     IBM Ethernet Quad-BT PeerMaster Server Adapter (Micro Channel)
     IBM Ethernet Quad-B2 PeerMaster Server Adapter (Micro Channel)
     IBM Ethernet PCI PeerMaster Server Adapter          (PCI)

Installation instructions are provided for all supported adapters.
Follow the instructions specific to the adapters that you are
installing.


=============================
Section 3: "Before You Begin"
=============================

In addition to a printed copy of this readme file, you will require
the following items:

  *  The PeerMaster adapters to be installed.
  *  The IBM PeerMaster Option Diskette that came with your adapters.
  *  A writable, working copy of the AT&T Reference Diskette that
     came with your server (for MCA servers).
  *  Appropriate tools and documentation to install the adapters into
     your server.
  *  The IBM Ethernet Quad PeerMaster Installation Guide provided
     with your adapters.

If any items are missing or damaged, contact your place of purchase.


======================================
Section 4: "MCA Hardware Installation"
======================================

This section guides you through the process of installing PeerMaster
adapters into AT&T Micro Channel System 3000 servers. Before you
begin, do the following:

1. Determine where the adapter is going to be installed; it can be
   installed in any empty MCA expansion slot.

2. Make sure you have a writable, working copy of the AT&T Reference
   Diskette. Also, make sure you label the diskette as the working
   copy of the AT&T Reference Diskette.

------------------------
Preparing the MCA System
------------------------

Use the following procedure to prepare the system for IBM Ethernet
PeerMaster adapter installation:

1. Shut down the NT server via the Program Manager.

2. Turn the power switch of the console and of the system to the OFF
   position. Disconnect the system power cord from the rear panel of
   the system or from the wall outlet. On some models, you may also
   need to flip the circuit breakers and remove the CMOS battery
   fuse.

3. Install the PeerMaster adapter into the desired slot as instructed
   in "AT&T 345x/35xx Unit Installation, Care and Cleaning".
   
   Note:  The IBM Quad PeerMaster is a type 5 Micro Channel option
           adapter. To create sufficient clearance for type 5
           adapters it is necessary to remove the  brackets used to
           position and hold shorter option adapters.

4. Reboot the system from the AT&T Reference Diskette; make a copy of
   the Reference Diskette.

----------------------------
Reconfiguring the MCA System
----------------------------

Perform the following procedures to reconfigure the system.

Change the Configuration

1. Press the ESC (escape) key to return to the main menu.

2. Select <Configuration> and then select <Install> or <FileCopy>.

3. When instructed to insert the new adapter diskette, remove the
   Reference Diskette and insert the IBM Ethernet Quad PeerMaster
   Option Diskette.

   Alternate diskettes as prompted until the process is complete.

4. From the Configuration menu, select <Change>.

5. Use the arrow keys to highlight the slot for the IBM Ethernet
   PeerMaster adapter and press the Enter key. Information such as
   the following will be displayed:

   Fixed resources           "Fixed resources"

   Device I/O Address         1C00h-1C1Fh

   Interrupt Level            Level 3

   MCA Arbitration Level      Level 1

   Streaming Data             Enabled

   Selected Feedback Return   Disabled

   Address and Data Parity    Disabled

6. Using the arrow keys and Enter key, choose values for the Device
   I/O Address, Interrupt Level, MCA Arbitration Level, Shared Memory
   Window Location, and Full Memory Window Location so that they do
   not conflict with other adapters or system resources. Conflicts
   are indicated by an asterisk to the left of the selected value.

   IMPORTANT!:  Select one of the first 16 choices for the FULL
                MEMORY WINDOW location. The remaining choices result
                in conflicts under Windows NT that are not detected
                during MCA configuration.

7. Press the F10 key to save the selected configuration values.

   To install more than one IBM Ethernet PeerMaster adapter, repeat
   steps 5 through 7 for each additional PeerMaster adapter.

8. Press the ESC key to return to the CONFIGURATION menu.

-----------------------------
Back Up the MCA Configuration
-----------------------------

1. Select <Backup>. A configuration backup file is written to the
   working copy of the AT&T Reference Diskette so it can be used to
   restore the configuration information, if necessary.

2. When the Backup is complete, remove the working copy of the AT&T
   Reference Diskette from the drive.

3. Press the ESC key as many times as necessary to exit the system
   setup; the system is automatically rebooted and the Windows NT
   operating system is reloaded.


======================================
Section 5: "PCI Hardware Installation"
======================================

This section to be supplied at a later date.


=======================================================
Section 6: "Contents of IBM PeerMaster Option Diskette"
=======================================================

The following files are included on the Option Diskette provided
with your PeerMaster adapter:

A:\                  (Root Directory)

* README.TXT         Installation information not available at
                     the time of this readme file.

* @8F6D.ADF          Adapter Configuration File for the Quad-BT
                     PeerMaster. (used for MCA adapters only)

* @8F6A.ADF          Adapter Configuration File for the Quad-B2
                     PeerMaster. (used for MCA adapters only)

* PSSETUP.EXE        Adapter Setup and Diagnostics software.
                     (used for PCI adapters only)

A:\NT                (PeerMaster Windows NT Program Files)

* MXMCA4BT.BIN       MCA Quad-BT PeerMaster firmware download
                     file.

* MXMCA4TN.BIN       MCA Quad-B2 PeerMaster firmware download
                     file.

* MXPCI4BT.BIN       PCI PeerMaster firmware download file.

* OEMSETUP.INF       Used at install/configure time to drive the
                     dialog boxes, verify parameters, and to put
                     parameters in the registry.

* QSTATS.EXE         A utility that permits you to view
                     PeerMaster statistics.

* QUADENET.SYS       The device driver for both traditional MAC
                     and VNET functions.

* QUADENET.DLL       Contains the dialog boxes issued at
                     install/configure time.

* QUADPCI.SYS        Detects the presence of PCI PeerMaster
                     adapters during adapter installation and
                     configuration.

* QUADENET.HLP       Contains help files invoked from dialogue
                     boxes.

* QDNCDET.DLL        Detects the presence of MCA PeerMaster
                     adapters during system installation.

* README.TXT         Provides LAN software installation
                     instructions.


========================================================
Section 7: "S/W Installation and Configuration Overview"
========================================================

You have already completed the hardware portion of the installation
process. This file contains the instructions to complete the
installation and configuration of the LAN software.

The following list provides the basic flow of the LAN software
installation process. The details required to perform each step are
provided in the following sections.

Note: Multiple ports of PeerMaster adapters may be bound to protocols
as a single virtual network, hereafter called 'VNET'.  The driver that
creates these virtual networks is QUADENET.SYS.

The basic procedure is as follows:

a)   Install and configure your NT Server as described by the
     installation manuals provided with that product.

b)   Review Section 8: "Precautions, Limitations and Guidelines" for
     NT specific precautions.

c)   Install and configure your Quad PeerMaster adapter(s) and
     protocols using the NT Network Control Panel Applet (NCPA).
     Section 9: "S/W Installation and Configuration", guides you
     through this process.


====================================================
Section 8: "Precautions, Limitations and Guidelines"
====================================================

1.   A single PeerMaster adapter may not be included into
     multiple VNETs.

2.   You may configure multiple adapters as a single VNET,
     multiple VNETs, multiple traditional subnetworks, or as any
     combination of traditional and virtual subnetworks.

3.   A single PeerMaster adapter must be configured to operate
     exclusively either as a VNET switch or a traditional
     adapter.  Both modes cannot be supported simultaneously.

4.   Values placed into the Network Address edit box on the
     Virtual Adapter Setup dialog box will override the factory
     programmed network address for your adapters, and will be
     applied to all ports within the VNET.

5.   Initialization, configuration and re-configuration changes
     do not take effect until the system is rebooted.

6.   All PeerMaster adapters (MCA and PCI) are configured in the
     same manner.

7.   It is NOT necessary to set up the Flash Slot parameter using
     PSSETUP on adapters being installed in NT servers. The PCI
     device number assigned by PCI BIOS is used as the slot
     number for each adapter. You may use PSSETUP to identify and
     label each adapter with it’s PCI device number. Note that
     the device number may change as PCI devices are added to, or
     removed from, your system. PCI device numbers are also
     subject to change should a different revision of BIOS be
     installed on your system. Should this occur, you may use
     PSSETUP to identify the PCI device numbers assigned to each
     adapter, and re-label the adapters.

8.   At least one, and no greater than eight, adapters must be
     included into a VNET. At least one port must be activated on
     each adapter included into a VNET.


===============================================
Section 9: "S/W Installation and Configuration"
===============================================

The program files for the PeerMaster Adapter are installed and
configured via the NT Network Control Panel Applet (NCPA). NCPA
automates the installation and configuration of LAN Adapters and
Protocols. NCPA copies installation files from the PeerMaster Option
Diskette and updates the NT registry with the selected configuration
options. The following steps describe installation and configuration
for both Traditional and VNET modes of operation using NCPA.

The following instructions assume:

   * The PeerMaster Adapter has been installed.
   * The required configuration information is known.
   * The installer has a basic familiarity with MS Windows.

1. Select the MAIN window.

2. From the "Control Panel" window, select the "Network" option. The
   NETWORK SETTINGS dialog box will appear presenting a number of
   options.

3. From the NETWORK SETTINGS dialog box, select "Add Adapter" and
   wait for the ADD NETWORK ADAPTER window to display.

4. In the ADD NETWORK ADAPTER window, use the mouse (or the DOWN
   ARROW) with the NETWORK ADAPTER CARD option to scroll through a
   list of available adapters. Select OTHER (at bottom of menu) and
   then click on CONTINUE.

5. When prompted for the location of the installation software,
   insert the PeerMaster Option Diskette into an available drive,
   enter the appropriate drive letter and the path NT into the edit
   box, for example:

      A:\NT

   Then click on OK and wait for the PeerMaster Adapter Setup dialog
   box to display.

6. This step guides you through the process of installing a single
   PeerMaster port as a traditional adapter. To configure multiple
   ports as a virtual subnetwork, skip to step 7. After completion of
   this step, you may return to step 3 of this section and configure
   another port as a traditional adapter or skip to step 8 if no more
   ports are to be installed.

   You may press the HELP button at any time during this process to
   display on-line information pertaining to the available options.
   To display information within the HELP dialog box, click on the
   desired field using your mouse or highlight the desired field
   using the tab key then press <ENTER>.
   
   a)  The Socket Id field permits you to select a specific
       PeerMaster port to install/configure in Traditional adapter
       mode. Use the pull-down menu to display a list of all
       available adapter/ports. A Socket Id is comprised of the
       following three sub-fields:

        Bus number:
           For MCA and PCI systems, this identifies the system bus in
           which the target adapter is installed.  This field is
           meaningful only in multi-bus servers.  The bus type of the
           target adapter (MCA or PCI) is displayed in the Socket Id
           box.

        Slot number:
           For MCA systems, this is the number of the expansion slot
           in which the target adapter is installed.
            
           For PCI systems, this is the PCI device number assigned to
           the adapter by PCI BIOS. You may use PSSETUP to identify
           and label each installed adapter with the PCI device
           number assigned to it.
            
           Note: PCI device numbers are subject to change as
           additional PCI devices are installed in your system, or if
           the BIOS revision on your system is changed.

        Port number:
           For MCA and PCI systems, this is the target Ethernet port
           number of the adapter being installed.  Port one of the
           adapter is the connector furthest from the gold fingers
           that insert into the expansion slot on the system board of
           your computer. Port four is the connector that is closest
           to the expansion slot connector pins on the adapter.

   b)   You may override the factory set network address. Use the
        edit box to enter a Locally Administered Network Address.
        Valid network addresses are twelve hex characters long. The
        Locally Administered bit must be set to one and the Group bit
        set to zero.

   c)   You may optionally disable link test for the selected port.
        Link test applies to 10BaseT adapters only. If the specified
        port is cabled to a hub that does not support 10BaseT link
        signals then clear the Link Test Enable check box.

   d)   You may override the default values for the Advanced Adapter
        settings at this time. Select ADVANCED to invoke the Adapter
        Advanced Setup dialog box and wait for the dialog box to
        display. Please note that only knowledgeable system
        administrators should modify the Advanced Setup values.
        Select CONTINUE when complete to save the settings and return
        to the PeerMaster Adapter Setup dialog box. The following
        advanced settings may be configured:

          Full Memory Window:
            Description: To support peer-to-peer DMA transfers
            PeerMaster adapters require a memory window in system
            address space to enable peer adapters to access to their
            local memory. The location of this window is normally
            auto-selected during adapter installation. On some IBM
            Model 85 Micro Channel computers, this window is not auto-
            configurable, thus default window base addresses are used
            by the device driver. This parameter allows manual
            override of the default values. The edit box specifies a
            megabyte value for a window base address. A value of 200,
            for instance, specifies a system memory base address of
            200MB. For each adapter, the first configured port sets
            the base address for that adapter. A unique value must be
            used for each adapter.
            
            Range:      2 - 255
            Default:    Based upon adapter slot as follows:
                        slot 1: 255
                        slot 2: 254
                        slot 3: 253
                        slot 4: 252
                        slot 5: 251
                        slot 6: 250
                        slot 7: 249
                        slot 8: 248

          WatchDog Timer:
            Description: Time interval, in seconds, indicating how
            often a Watchdog command/reply must be exchanged between
            the driver and adapter. A value of zero disables the
            watchdog function.  If the adapter fails to respond to a
            watchdog request within the specified timeout, the driver
            will reset and restart the adapter.
            
            Range:      0 - 255
            Default:    0

   e)   Click on CONTINUE to save the settings for this PeerMaster
        port. The Adapter Setup dialog box will now exit and the
        remaining program files will be copied from the PeerMaster
        Option Diskette.

7. This step is required to create a virtual adapter (VNET)
   consisting of multiple PeerMaster adapters. Do not perform this
   step for ports configured as traditional adapters. After
   completion of this step, you may return to step 3 of this section
   to create another VNET or continue with step 8 to complete the
   installation process.

   You may press the HELP button at any time during this process to
   display on-line information pertaining to the available options.
   To display information within the HELP dialog box, click on the
   desired field using your mouse or highlight the desired field
   using the tab key then press <ENTER>.

   a)   Select the Create VNET button and wait for the Virtual
        Adapter Setup dialog box to appear. This dialog box permits
        you to specify the adapters included into the VNET.

   b)   Click the check box next to each adapter to include it into
        this VNET. A check box will not be selectable if:

         * The indicated adapter has at least one port configured in
           traditional mode, or...
         * the indicated adapter is included into another VNET, or...
         * no adapter is indicated.

          Note:  A single VNET must contain one to eight adapters.
                 Adapters not included into a VNET may be configured
                 as traditional adapters or as part of another VNET.

   c)   You may override the factory set network address. Use the
        edit box to enter a Locally Administered Network Address.
        This address will be used for all ports within the VNET.
        Valid network addresses are twelve hex characters long. The
        Locally Administered bit must be set to one and the Group bit
        set to zero.

   d)   You may override the default values for the Advanced Virtual
        Adapter settings at this time. Select ADVANCED to invoke the
        Virtual Adapter Advanced Setup dialog box and wait for the
        dialog box to display. Please note that only knowledgeable
        system administrators should modify the Advanced Setup
        values. Select CONTINUE when complete to save the settings
        and return to the Virtual Adapter Setup dialog box. The
        following advanced settings may be configured:

          Bridge Aging Timer:
            Description: When the VNET Switch function is active the
            PeerMaster adapters maintain both in-host and on-board
            databases to associate network addresses with specific
            adapters/ports. Unused entries are periodically purged to
            prevent overflow of these databases. This parameter
            defines the rate (in seconds) that inactive entries are
            purged. Setting this value to zero disables the aging
            process (inactive entries are not purged).
            
            Range:      0 - 65535
            Default:    120

          WatchDog Timer:
            Description: Time interval, in seconds, indicating how
            often a Watchdog command/reply must be exchanged between
            the driver and adapter. A value of zero disables the
            watchdog function.  If the adapter fails to respond to a
            watchdog request within the specified timeout, the driver
            will reset and restart the adapter.
            
            Range:      0 - 255
            Default:    0

   e)   Click on CONTINUE. This will cause a Virtual Adapter Port
        Setup dialog box to appear. Wait for the new dialog box to
        appear.

   f)   The dialog box indicates which adapter is currently being set
        up. Click the check box next to each port to activate it
        within the VNET. At least one port must be selected.

   g)   You may override the default values for the Virtual Adapter
        Advanced Port Setup settings at this time. Select ADVANCED to
        invoke the Virtual Adapter Advanced Port Setup dialog box and
        wait for the dialog box to display. Please note that only
        knowledgeable system administrators should modify the
        Advanced Setup values. Select CONTINUE when complete to save
        the setting and return to the Virtual Adapter Port Setup
        dialog box. The following advanced settings may be
        configured:
   
          Full Memory Window:
            Description: To support peer-to-peer DMA transfers
            PeerMaster adapters require a memory window in system
            address space to enable peer adapters to access to their
            local memory. The location of this window is normally
            auto-selected during adapter installation. On some IBM
            Model 85 Micro Channel computers, this window is not auto-
            configurable, thus default window base addresses are used
            by the device driver. This parameter allows manual
            override of the default values. The edit box specifies a
            megabyte value for a window base address. A value of 200,
            for instance, specifies a system memory base address of
            200MB. For each adapter, the first configured port sets
            the base address for that adapter. A unique value must be
            used for each adapter.
            
            Range:      2 - 255
            Default:    Based upon adapter slot as follows:
                        slot 1: 255
                        slot 2: 254
                        slot 3: 253
                        slot 4: 252
                        slot 5: 251
                        slot 6: 250
                        slot 7: 249
                        slot 8: 248

          Link Test Enable:
            Description: Link test applies to 10BaseT adapters only.
            If the specified port is cabled to a hub that does not
            support 10BaseT link signals, then clear this check box.
            
            Settings:   Enabled or Disabled
            Default:    Enabled

   h)   Click on CONTINUE to save the port settings for this adapter.
        This process repeats itself for each adapter included into
        the VNET. When the settings for all adapters in the VNET have
        been saved, the Virtual Adapter Setup dialog box will exit
        and the remaining program files will be copied from the
        PeerMaster Option Diskette.

8. Select OK.  A prompt will appear, requesting that the system be
   restarted so that the changes may take effect.  Remove any
   diskettes and select RESTART.  The computer will be restarted with
   the network interface installed.

9. Once restarted, the PeerMaster adapters will be active within your
   server. You may re-configure your adapters using the REMOVE
   ADAPTER, ADD ADAPTER and CONFIGURE options on the NCPA dialog box.
   Using the CONFIGURE option, you may add additional adapters to, or
   activate inactive ports within, an existing VNET. You may also
   modify basic and advanced configuration parameters associated with
   traditional or virtual adapters. These changes will not take
   affect until the system is rebooted.


===================================
Section 10: "PeerMaster Statistics"
===================================
The PeerMaster Option Diskette contains a utility program to display
traditional and switch statistics for PeerMaster adapters. The utility
is called QSTATS.EXE and is copied to default Windows NT system
directory during the installation process.

QSTATS may be run from Program Manager or from a DOS command prompt.
The program takes two command line parameters, as follows:

  QSTATS /device:NAME /slot:NN
  
  Where:
  
     NAME specifies the driver name to be queried. Each instance of
     the PeerMaster driver is given a unique name, such as
     quadenet[x], where x is the number that NCPA displays before the
     driver name.
     
     NN specifies the slot number of the adapter as reported by NCPA.
     
  For example, NCPA displays the following list of adapters:
     
     [2] IBM Quad PeerMaster Adapter
     [3] IBM Quad PeerMaster Adapter
     
  If adapter [2] is installed into slot 7, then statistics for that
  adapter are displayed as follows:
     
     QSTATS /device:quadenet2 /slot:7
       

QSTATS displays the following traditional statistics for all ports of
the specified adapter:

  Traditional Stats     Description
  -----------------     ------------------------------------------
  InOctets              Octets received
  InMcast               Multicast packets received
  InDisc                Packets dropped due to lack of resources
  OutOctets             Octets transmitted
  OutMcast              Multicast packets transmitted
  OutDisc               Tx packets dropped due to lack of resources
  BusTransmitErrors     Errors on system bus
  PeerRxResources       Memory allocated for peer transfers
  AdapterRxResources    Total number of receive buffers
  OperationalVersion    Current firmware version
  FCSErrors             Frames received with bad CRC
  MultipleCollisions    Tx frames than collided more than once
  DeferredTransmission  Tx frames that were deferred
  ExcessiveCollisions   Tx frames that collided 16 times
  CarrierSenseErrors    Tx carrier sense errors
  MacRxErrors           Frames dropped internally
  InUcast               Unicast frames received
  InBcast               Broadcast frames received
  InErrors              Corrupt frames received
  OutUcast              Unicast frames transmitted
  OutBcast              Broadcast frames transmitted
  OutErrors             Frames transmitted unsuccessfully
  HostTransferErrors    System bus errors
  PeerTxResources       Memory allocated for peer transfers
  AdapterTxResources    Adapter transmit buffers
  AlignmentErrors       Corrupt receive frames
  SingleCollisions      Tx frames that collided one time
  SQETestErrors         Collision detection test failures
  LateCollisions        Collisions detected after first 64 bytes
  InternalMacTxErrors   Tx frames dropped internally
  FramesTooLong         Frames that exceed max frame length
  
QSTATS displays the following switch statistics for all ports of the
specified adapter:
  
  Switch Stats           Description
  ------------           ------------------------------------------
  LearnedEntryDiscards   The number of address learning table entries
                         that had to be discarded due to table
                         overflow.
  PeerInFrames           The number of packets that were transferred
                         by peer adapters to this PeerMaster adapter.
  PeerOutFrames          The number of packets that were sent by this
                         PeerMaster adapter to peer adapters.
  PeerInDiscards         The number of packets that were sourced by
                         peer adapters to this PeerMaster adapter
                         that were discarded (filtered) by the
                         Forwarding Process.
  Eth N InFrames         The number of packets received by port N
                         that were passed to the switching function.
  Eth N OutFrames        The number of packets passed from the
                         switching function to port N.
  Eth N InDiscards       The number of packets received by port N
                         that were filtered by the switching
                         function.


================================
Section 11: "Event Log Messages"
================================
This section describes entries posted by the driver in the event
viewer in case of a malfunction.  Using the event viewer find the
latest entry entitled QuadEnet in the system log and double click
on the entry. Look for a data window at the bottom of the screen
containing text starting with "Err: " followed by 8 ASCII digits.
Use the following tables to interpret the error. If you are not
able to resolve the error, record the error information and call
for service.

The first ASCII (left most) digit represents the module where the
error occurred:

 ASCII   Module
 1       init.c
 2       ndis.c
 3       adapter.c
 4       mib.c
 5       intr.c

The second ASCII digit represents the routine where the error
occurred:

 ASCII   Routine
 1       ConfigureAdapter
 2       MacAddAdapter
 3       MacOpenAdapter
 4       VerifySharedMemory
 5       SlotDownLoad
 6       PortSetMulticastList
 7       ReceiveCommand

The third and fourth ASCII digits provide a description of the
failed function:

 ASCII     Function
 20        no function specified
 10        NDIS function, NdisMapFile
 11        NDIS function, NdisOpenConfiguration
 12        NDIS function, NdisReadMcaPosInformation
 13        NDIS function, NdisImmediateReadPciSlot Information
 14        NDIS function, NdisInitializeInterrupt
 15        NDIS function, NdisWriteConfiguration
 16        NDIS function, NdisAllocateMemory
 17        NDIS function, NdisMapIoSpace
 18        NDIS function, NdisAllocateSharedMemory
 19        NDIS function, NdisOpenFile
 31        Filter function, EthNoteOpenFilterAdapter
 32        Filter function, EthCreateFilter

The fifth through eighth digits provide the exact cause of the
error:

ASCII     Cause of Error
0000      NDIS function or filter function error
0001      Error in registry, an invalid MAC address specified
0006      Adapter id specified in the POS registers is invalid
0007      According to the POS registers, the adapter is not
          enabled
0009      NdisInitializeInterrupt failed due to a resource
          conflict
0010      The adapter is in an unexpected state
0011      The transport does not support the media type 802.3
          (Ethernet)
0012      Error in registry, no slot number specified for a MAC
          driver
0013      Error in registry, no bus number specified
0014      Error in registry, no bus type specified
0015      Slot in error state, cannot add or open adapter
0016      Error in registry, no port number specified
0017      Error in registry, no download file specified
0018      Cannot open download file
0019      Error in registry, bus type invalid
0020      Shared memory error, signature in control boot
          structure invalid
0021      Shared memory error, invalid checksum in control boot
          structure
0022      Unknown card type stored in Slot structure
0023      Invalid sequence number in pipe status response to
          status request
0024      Invalid pipe response to a status request during
          download
0026      Invalid sequence number in response to download file
          transfer
0027      Error deleting multicast address
0028      Error in registry, no VSlot entry
0029      Error in registry, no IsVnet entry
0030      Error in registry, Slot/Port used in more than one
          entry
0032      Error in registry, Slot used for VNET and in another
          entry
0034      Received CommandPipeIn interrupt, received function
          error response
0035      Vendor Id is invalid using
          NdisImmediateReadPciSlotInformation
0036      Device Id is invalid using
          NdisImmediateReadPciSlotInformation
0037      I/O base address is invalid using
          NdisImmediateReadPciSlotInformation
1001      Could not allocate memory for binding structure
1002      Could not allocate memory for VNET structures, buffers
          or statistics
----------------------------------------------------------------

PeerMaster adapters contain on-board Power-On-Self-Tests
(POST) that run each time the adapter powers up or is
restarted. POST results are verified by the driver prior to
downloading and initializing the adapter. The PeerMaster driver logs
POST errors into the system event log. When this occurs the system
will, upon start-up, display a warning that a device failed to
function properly, and indicates that information is available via the
event viewer.

When the system is up, invoke the event viewer and find the latest
entry entitled QuadEnet in the system log and double click on the
entry. A message in the log will indicate that the adapter returned an
invalid value. Look for a data window at the bottom of the screen
containing text starting with "POST: " followed by an ASCII error
number. Use the following table to interpret and respond to the error.

POST
Error #             Description
-------             --------------------------

  1       Message:  POST Flash Main Sector Checksum Failure
          Action :  Call for service.

  2       Message:  POST was not performed - board restarted
          Action :  Call for service.

  3       Message:  POST Test Sequencer Internal Failure
          Action :  Call for service.

  4       Message:  POST Flash Boot Sector Checksum Failure
          Action :  Call for service.

  5       Message:  POST DRAM Size Detection Failure
          Action:   Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

  6       Message:  POST DRAM Byte  (8 bit) Wide Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

  7       Message:  POST DRAM Short (16 bit) Wide Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

  8       Message:  POST DRAM Word (32 bit) Wide Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

  9       Message:  POST DRAM Long (64 bit) Wide Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

 10       Message:  POST DRAM Trip (96 bit) Wide Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service

 11       Message:  POST DRAM Quad (128 bit) Wide Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

 12       Message:  POST DRAM Addressability Failure
          Action :  Power down the server. Verify proper
                    seating of the DRAM SIMM on the board
                    and try again. If failure persists, call
                    for service.

 13       Message:  POST SRAM Size Detection Failure
          Action :  Call for service.

 14       Message:  POST SRAM Byte (8 bit) Wide Failure
          Action :  Call for service.

 15       Message:  POST SRAM Short (16 bit) Wide Failure
          Action :  Call for service.

 16       Message:  POST SRAM Word (32 bit) Wide Failure
          Action :  Call for service.

 17       Message:  POST SRAM Long (64 bit) Wide Failure
          Action :  Call for service.

 18       Message:  POST SRAM Trip (96 bit) Wide Failure
          Action :  Call for service.

 19       Message:  POST SRAM Quad (128 bit) Wide Failure
          Action :  Call for service.

 20       Message:  POST SRAM Addressability Failure
          Action :  Call for service.

 21       Message:  POST Timer Failure
          Action :  Call for service.

 22,23    Message:  POST Ethernet Port N Internal Loopback
 24,25              Failure (N = 1, 2, 3, or 4)
          Action :  Call for service.

 26,27    Message:  POST Ethernet Port N External Loopback
 28,29              Failure (N = 1, 2, 3, or 4)
          Action :  Call for service.

 30,31    Message:  POST Ethernet Port N Device Verification
 32,33              Failure (N = 1, 2, 3, or 4)
          Action :  Call for service.


===================================
Section 12: "Selectable Parameters"
===================================

A list of the user-configurable parameters follows:

Keyword          Minimum  Maximum   Default Usage
---------------  -------- -------   ------- -----------------------
BridgeAgeTimer   0        65535     120     Specifies address cache
                                            flush interval
FullMemoryWindow 2        255       slot    Specifies interadapter
                                            memory window address.
                                            Default based on slot:
                                              Slot 8: 255 MByte
                                              Slot 7: 254 MByte
                                              Slot 6: 253 MByte
                                              Slot 5: 252 MByte
                                              Slot 4: 251 MByte
                                              Slot 3: 250 MByte
                                              Slot 2: 249 MByte
                                              Slot 1: 248 MByte
LinkTestEnabled  Disable  Enable    Enable  Enables/disables 10BaseT
                                            Link Error Testing
NetworkAddress   N/A      N/A       N/A     Specifies locally
                                            administered MAC address
WatchDogTimer    0        65535     0       Specifies watchdog
                                            interval





==========
TRADEMARKS
==========

The following terms, denoted by an asterisk (*) in this README
file,
are trademarks of the IBM Corporation in the United States or
other
countries:

IBM            PeerMaster


IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED,
INCLUDING WITHOUT LIMITATION, WARRANTIES OF FITNESS AND
MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS
DOCUMENT.  BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES
TO ANY RELATED PATENTS OR COPYRIGHTS.

(c) Copyright IBM Corporation, 1995.  All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication, or
disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
