
          Active PCI-X driver for IBM* Systems v1.10D for Netware v5.1/v6.0 and
          Novell NetWare v5.1/v6.0 Installation Instructions.
          Readme.txt   Version 1.10D

       CONTENTS
       ---------

1.0 Active PCI Installation Overview for Novell NetWare v5.1/v6.0
    1.1 Overview
    1.2 Limitations
    1.3 Dependencies:
2.0 Change History
3.0 Installation and Setup Instructions for Netware v5.1/v6.0
    3.1 Instructions on adding support for RXE100
4.0 How to perform Active PCI Operations
    4.1 Required steps in Active PCI Operations
        4.1.1 Removing an adapter
        4.1.2 Replacing an adapter
        4.1.3 Adding a new adapter to an empty slot
    4.2 How to determine if your driver supports Active PCI Operations
    4.3 Warnings about incorrect usage of Active PCI.
5.0 Troubleshooting Active PCI operations
    5.1 Basic Troubleshooting
        5.1.1 Attention Indicator LED
        5.1.2 IBMXSBD.NLM messages
        5.1.3 Adapter Driver error messages
    5.2 Advanced Troubleshooting
        5.2.1 How to determine if the problem is with the adapter driver
              or the active pci driver.
        5.2.2 Use of switches and log file for IBMXSBD driver
        5.2.3 Interrupt handling
        5.2.4 NCMCON issues
6.0 Disclaimer


1.0 Active PCI Installation Overview for Novell NetWare v5.1/v6.0

1.1 Overview
The Active PCI support for NetWare v5.1/v6.0 provided by IBM
is compliant with many different specifications including full compliance
with the NetWare System Bus Driver specification v1.01, PCI v2.2, PCI-X 1.0
and the PCI Hot-Plug PCI v1.1 specification.

The IBM Active PCI system support consists of an interlock switch
and a set of two LED's for each Active PCI slot.  One LED will
remain on when power is ON to the given slot.  The other LED will
indicate that attention is required to that slot. Slots that do not
have these devices are NOT Active PCI slots.  All Active PCI operations
must be controlled through a console provided by Novell.

IN NO CASE SHOULD ACTIVE PCI OPERATIONS BE DONE WITHOUT FIRST REMOVING
POWER FROM THE SLOT THROUGH THE NETWARE CONFIGURATION MANAGER
CONSOLE (NCMCON).  IF A SLOT DOES NOT HAVE A LATCH,DO NOT
REMOVE THE ADAPTER.  DOING SO CAN CAUSE SERIOUS DAMAGE TO THE
SYSTEM AND ADAPTER.

The order of events in any active PCI operation are:

- Load the Active PCI-X driver for IBM Systems to provide Active PCI
  support.

- Go to the NetWare Configuration Manager Console (NCMCON)

- Choose an add or remove operation for the given slot.

- When the adapter power is OFF, open the latch and remove,
  replace or add an adapter and any necessary cabling.

- Close the latch and return to the NCMCON console.

NOTE:  The power to a slot cannot be turned ON until the latch
       is closed for the given slot.  The position of the latch
       (opened or closed) is not important if no adapter is in
       the given slot.

- In the case of adding a new adapter or replacing an old one, the NCMCON
  console will prompt you to turn on the newly added adapter.

- If selected, the adapter power is turned ON and the adapter is
  configured.  At this point, if you are using a LAN driver,
  HWDETECT.NLM will run and load the appropriate driver for you.  If
  you are using any other type of adapter, you will have to go to the
  system console and manually load the appropriate driver.

NOTE: In the case of a SCSI controller, you may need to issue the console
      command 'SCAN FOR NEW DEVICES' prior to the drive being recognized
      by NetWare.


1.2 Limitations


- On IBM e-Server xSeries 255, slots 2 & 3 only support hot-adding of devices
  capable of 133 MHz PCI-X operation.  Hot-adding of all other devices will result
  in a bus speed mismatch error because of the embedded device residing on that bus.
  This embedded device causes the bus to operate at 100 MHz PCI-X mode by default.

- Cannot load driver multiple times within same boot session. If the driver
  is loaded, adapters are hot-added, then the driver is unloaded and re-loaded,
  erroneous behavior will occur.

- Multi-Function PCI devices are supported as long as the multi-function
  capability is not provided with or through a PCI-to-PCI bridge.

- Video adapters are not supported in the Active PCI environment due to
  I/O space limitations and restrictions.

- Devices that are not PCI v2.1 compliant or that do not implement the
  PCI presence detection pins are not supported.

- Device drivers that are not LAN ODI v3.31 compliant or SCSI NWPA v3.00b
  compliant are NOT supported.

- Non-PCI devices are not hot pluggable.

- HWDETECT.NLM, a Novell provided module, may not find the correct driver
  if more than one driver is capable of loading for the given adapter.

- Unloading the driver before unloading NCMCON causes the system to go down.
  The correct procedure is to unload NCMCON and then unload ibmxsbd if really needed.
  
- Because of errors encountered in testing, HWDETECT.NLM is not provided
  by IBM.  If you want the capability of being able to auto-detect the
  correct driver for newly added adapters, download the latest HWDETECT.NLM
  from the Novell web site.  The URL to find the latest version of
  HWDETECT.NLM from Novell's web site is:

      http://support.novell.com/search/ff_index.htm


1.3   Dependencies:

All files that are required by the Active PCI-X driver are provided in
the standard Novell Netware v5.1/v6.0 package.


2.0   Change History
--------------------

**********************
*   V1.10D Changes   *
*   June 2002       *
**********************
Removed code that assigns IRQs C and E to the devices, even if BIOS (via IRQ Routing
Table) reports they are available.

**********************
*   V1.10C Changes   *
*   June 2002       *
**********************
Fixed memory allocation to shareable for RXE100 when running with ACPI

**********************
*   V1.10B Changes   *
*   June 2002       *
**********************
Added support for buggy CIOB-X chipset
Fixed issues related to alignment and size of the resources

**********************
*   V1.10A Changes   *
*   May 2002       *
**********************
Changed the operation of the driver so if the card asks for all of the resources
allocated to that bus, will not give it instead of being conservative as before.
Fixed memory allocation to shareable for the case of ACPI.

**********************
*   V1.09g Changes   *
*   April 2002       *
**********************
Fixed the report in NCMCON, to show current bus speed of PCI-X 66 correctly.

**********************
*   V1.09f Changes   *
*   April 2002       *
**********************
Converted the slot numbers to decimal in the error reports
Fixed bus count limitations so that no longer count powered off slots against the bus
load.

**********************
*   V1.09e Changes   *
*   April 2002       *
**********************
Fixed bus limitations to take into account devices present on loading with open latches
Changed bus speed mismatch error reporting to go around the problem of 'generic bus speed mismatch'
and NCMCON not updating automatically
Added delay after setting bus speed and before sending the power on command to accomodate for bug in HPC firmware

**********************
*   V1.09b Changes   *
*   April 2002       *
**********************
Fixed bus limitations to consider embedded devices
Added delay reading the slot status register to avoid erroneous power fault reporting

**********************
*   V1.08 Changes    *
*   March 2002       *
**********************
Added functionality for bus limitations.
Added distinction between bus mode mismatch.

**********************
*   V1.07 Changes    *
*   February 2002    *
**********************
Added support for RXE100.
Cleaned up debug information.
Turn off all empty slots before finishing registration with the OS.

**********************
*   V1.05b Changes   *
*    January 2002    *
**********************
Added delay to handle ServeRAId cards.

**********************
*   V1.05 Changes    *
*   November 2001    *
**********************
Made changes in the error handling for powering on a slot. Needed to
pass Novell certification.

**********************
*   V1.04b Changes   *
*   November 2001    *
**********************
Fixed bug involving stale data in bus register. This bug prevented
the addition of some adapter cards displaying a bus speed mismatch.

**********************
*   v1.04 Changes    *
*   November 2001    *
**********************
Added dynamic bus speed change capability.
Placed debug information inside of DEBUG conditionals

**********************
*   v1.03 Changes    *
*   October 2001     *
**********************
Added readme file.
Corrected bus speed displayed on user interface.

**********************
*   v1.00 Changes    *
*   October 2001     *
**********************
Original Release


3.0   Installation and Setup Instructions for Netware v5.1/v6.0
-----------------------------------------

To install the Active PCI-X driver for IBM systems, perform the following
operation:

  1.  Start the Netware server and go to the Netware console.

  2.  Copy the Active PCI-X driver for IBM systems (IBMXSBD.NLM) to hard drive (C:\)

  3.  Type Load C:\IBMXSBD.NLM

 NOTE: When the NetWare Configuration Manger Console (NCMCON) is opened, it
       will show the available Active PCI slots, their current status, and
       any adapters that are currently in the Active PCI slots.

 NOTE: If there is a failure of any type, please power down the machine, reboot,
       and Type 'Load C:\IBMXSBD.NLM -DBGALL > C:\IBMXSBD.TXT' and provide the
       IBMXSBD.TXT file for debugging purposes.


3.1    Instructions on adding support for RXE100 
-------------------------------------------------

To add support for RXE100, a new NBI.NLM file must be obtained from the 
Novell Support website.  Perform the following operation:

   1.   Obtain the new NBI.NLM from http://support.novell.com/filefinder/
        doing a search for nbiup1.exe.
        (for convenience of test this file is included on this diskette)

NOTE:  The NetWare Support Pack MUST be installed before installing
       the new NBI.NLM.  Otherwise, installing the suppork pack will
       overwrite the new NBI.NLM.

   2.  Bring the server down to a DOS prompt

   3.  Go to C:\NWSERVER directory and rename the NBI.NLM to NBI.OLD If it exists.

   4.  There are two NBI.NLM files in NBIUP1.EXE (one for NW5.1 and one for NW6.0).
       Copy the new NBI.NLM associated with the version of NetWare being used into 
       the C:\NWSERVER directory.

   5.  Restart the server



4.0 How to perform Active PCI Operations

4.1 Required steps in Active PCI Operations


NOTE: Opening an adapter latch will turn off the power to the
      slot.  If a device driver was loaded for that slot, the system will
      most likely hang, requiring the system to be rebooted.


4.1.1 Removing an adapter

1.  Verify that the IBMXSBD.NLM and NCMCON.NLM modules are loaded.

2.  Go to the NetWare Configuration Manager Console (NCMCON) screen.

3.  Select the slot where the adapter you want to remove is located and
    Press Enter.

4.  Select 'Remove Adapter' and press Enter.

5.  If a driver is loaded for the adapter, you will get a prompt asking if
    you want to unload the driver.  You must have the driver unloaded for
    the power to the slot to be removed.

6.  If you receive a message stating that the driver could not be unloaded,
    go to the system console and manually remove the driver.  Return to
    NCMCON after the driver has been unloaded and repeat steps 3 through 5.

7.  Verify that the status for the slot reads 'Powered off'.

8.  Verify that the power-on light status for the adapter is OFF.  If the
    light is ON, go back to the console and verify that the given slot is
    powered OFF.

NOTE: NEVER REMOVE AN ADAPTER FROM A SLOT WITH THE SLOT POWER STILL ON.  THIS
      COULD RESULT IN A SYSTEM HANG AND/OR SERIOUS DAMAGE TO THE ADAPTER
      CARD AND/OR SYSTEM UNIT.

9.  Open the latch and remove the adapter from the slot.



4.1.2 Replacing an adapter

1.  Verify that the IBMXSBD.NLM and NCMCON.NLM modules are loaded.

2.  Go to the NetWare Configuration Manager Console (NCMCON) screen.

3.  Select the slot where the adapter you want to remove is located and
    Press Enter.

4.  Select 'Remove Adapter' and press Enter.

5.  If a driver is loaded for the adapter, you will get a prompt asking if
    you want to unload the driver.  You must have the driver unloaded for
    the power to the slot to be removed.

6.  If you receive a message stating that the driver could not be unloaded,
    go to the system console and manually remove the driver.  Return to
    NCMCON after the driver has been unloaded and repeat steps 3 through 5.

NOTE: Beware that unloading the driver in most cases unloaded it for ALL
      instances of the adapter in the system.  See Section 5.2 for any
      special commands that may be required to remove an individual
      instance of the driver.  In the case where a driver does not have
      a special command to unload it and NCMCON is not able to unload
      the driver, a new device driver supporting 'instance unload' must
      be obtained from the adapter vendor.  'Instance unload' is part of
      the Novell NetWare ODI v3.31 LAN Specification and the Novell NetWare
      NWPA v3.00b Disk Specification.

7.  Verify that the status for the slot reads 'Powered off'.

8.  Verify that the power-on light status for the adapter is OFF.  If the
    light is ON, go back to the console and verify that the given slot is
    powered OFF.

NOTE: NEVER REMOVE AN ADAPTER FROM A SLOT WITH THE SLOT POWER STILL ON.  THIS
      COULD RESULT IN A SYSTEM HANG AND/OR SERIOUS DAMAGE TO THE ADAPTER
      CARD AND/OR SYSTEM UNIT.

9.  Open the latch and remove the adapter from the slot.

10. Place the new adapter in the slot and close the latch.

11. Go back to the NCMCON screen.  A message should be displayed asking if
    power should be turned on to the given slot.

12. After selecting to turn on the power to a given slot, you will be
    prompted to verify that any necessary cables have been attached to
    the adapter card prior to power being applied.

13. Press Enter at the cable reminder screen.  The adapter power will be
    turned on, the adapter configured, and a message displayed as to the
    success of adding the adapter.

NOTE:  If an error occurs during power ON and configuration of the adapter,
       the power to the slot will be turned back OFF, and an appropriate
       message displayed on the NCMCON screen and the system console screen.
       If an adapter does not power up, go to Section 5.0 Troubleshooting
       Active PCI Operations.

NOTE: In the case of a network adapter, be sure to BIND the appropriate
      protocols to the driver after the driver is loaded.

NOTE: In the case of a SCSI controller, you may need to issue the console
      command 'SCAN FOR NEW DEVICES' prior to the drive being recognized
      by NetWare.

NOTE: Drivers for newly added adapters do not automatically reload.  Please
      see the instructions for the specifically supported adapters for
      information on how to reload drivers.

14. The status of the adapter in the NCMCON screen will show READY if a
    driver is not loaded for the given slot, and ACTIVE when a driver is
    loaded.


4.1.3 Adding a new adapter to an empty slot

NOTE: Adding a new adapter to a slot with an adapter already in the slot
      is the same as replacing an adapter.  The steps to replacing an
      adapter are given in Section 4.1.2 above.

1.  Verify that the IBMXSBD.NLM and NCMCON.NLM modules are loaded.

2.  Go to the NetWare Configuration Manager Console (NCMCON) screen.

3.  Verify that the status for the slot reads 'Powered off'.

4.  Verify that the power-on light status for the adapter is OFF.  If the
    light is ON, go back to the console and verify that the given slot is
    powered OFF.

NOTE: NEVER REMOVE AN ADAPTER FROM A SLOT WITH THE SLOT POWER STILL ON.  THIS
      COULD RESULT IN A SYSTEM HANG AND/OR SERIOUS DAMAGE TO THE ADAPTER
      CARD AND/OR SYSTEM UNIT.

5.  Using NCMCON, choose the slot that the adapter will be added, select that
    slot by pressing ENTER, and choose ADD ADAPTER.

6.  Open the latch and place the new adapter in the slot and close the latch.

7.  Go back to the NCMCON screen.  A message should be displayed asking if
    power should be turned on to the given slot.

8.  After selecting to turn on the power to a given slot, you will be
    prompted to verify that any necessary cables have been attached to
    the adapter card prior to power being applied.

9.  Press Enter at the cable reminder screen.  The adapter power will be
    turned on, the adapter configured, and a message displayed as to the
    success of adding the adapter.

NOTE:  If an error occurs during power ON and configuration of the adapter,
       the power to the slot will be turned back OFF, and an appropriate
       message displayed on the NCMCON screen and the system console screen.
       If an adapter does not power up, go to Section 5.0 Troubleshooting
       Active PCI Operations.

NOTE: In the case of a network adapter, be sure to BIND the appropriate
      protocols to the driver after the driver is loaded.

NOTE: In the case of a SCSI controller, you may need to issue the console
      command 'SCAN FOR NEW DEVICES' prior to the drive being recognized
      by NetWare.

NOTE: Drivers for newly added adapters do not automatically reload.  Please
      see the instructions for the specifically supported adapters for
      information on how to reload drivers.

10. The status of the adapter in the NCMCON screen will show READY if a
    driver is not loaded for the given slot, and ACTIVE when a driver is
    loaded.


4.2 How to determine if your driver supports Active PCI Operations
      Operations

NOTE:  This section shows how to handle devices that are not on the
       IBM approved list of Active PCI devices.  Some devices may work
       correctly, but have not been tested and approved by IBM.

NOTE:  There are no changes to the physical adapter required to support
       Active PCI operations.

Many other adapter vendors will be providing drivers that meet the required
Novell specifications for Active PCI in the future.  However, there are
times where you may have a driver and will not know whether the driver is
Active PCI compatible.  The following is a list of methods to determine if a
given driver supports Active PCI operations.

1.  Almost any driver will allow a singular instance in the Active PCI
    environment.

2.  The device can be powered OFF through the NCMCON screen with a driver
    loaded or has a command-line option to remove a single instance of the
    driver.

NOTE:  A driver that forces all instances of itself to be unloaded is not
       considered an Active PCI driver.

3.  Can the driver detect newly added adapters after an Active PCI operation?

NOTE:  Many adapters will not detect new slot numbers because they do a
       static scan for cards on their first load.  If a new card is added,
       the driver will report that no slots are available.  Unloading the
       adapter (and sometimes the underlying support module, TOKENTSM.NLM,
       ETHERTSM.NLM, etc) and reloading them will allow the new slots to
       be seen in most instances.  However, this will require unloading the
       driver for all adapters in the system.

4.  Does the driver complain about PCI configuration problems?

NOTE:  Some older drivers do not allow for PCI configuration resources to
       be reallocated or changed.  These drivers will report that one or
       more of the PCI resource requirements (IRQs, I/O ports, Memory, or
       Prefetchable Memory) are not correct/unavailable.



4.3 Warnings about incorrect usage of Active PCI.

Below are several warnings about Active PCI operations:

1.  Do not remove an adapter from a non-Active PCI slot. (On NCMCON screen, under
    the column 'Hot Plug', you should see 'Yes')

2.  Grounding equipment, including wrist straps, should be used when
    working inside any system unit to protect against electrostatic
    discharge (ESD) that could damage system components and adapter
    cards.

3.  Make sure that any adapter card hot added to the system is fully
    seated before attempting to turn on power.

4.  Opening an adapter latch will turn off the power to the slot. If a
    device driver was loaded for that slot, the system could hang,
    requiring the system to be rebooted.

5.  Do NOT remove the plastic cover over the system components.  Removal
    of the plastic cover exposes system components that may be shorted
    by adapter brackets during Active PCI operations.

6.  Processors, memory and integrated systems devices are not hot swappable.


5.0 Troubleshooting Active PCI operations
-------------------------------------------

5.1 Basic Troubleshooting

There are several troubleshooting techniques that can be used to determine
why an Active PCI operation failed.  Two LED's are provided for each Active
PCI capable slot.  One LED blinks to indicate that attention is required.  
The second LED indicates power state.  Messages are generated by the NCMCON 
screen, IBMXSBD.NLM driver, and the various adapter drivers.


5.1.1 Attention Indicator LED

The Attention Indicator LED is controlled by NetWare.  At present, the
Attention Indicator LED is used only by device drivers to indicate that
an adapter in a given slot needs attention.  Not all device drivers support
the attention indicator messaging.  The Attention Indicator will only be
cleared upon successful replacement of the adapter in the slot or by the
device driver clearing the condition that led it to turn on the Attention
Indicator LED in the first place.


5.1.2 IBMXSBD.NLM messages

The IBMXSBD.NLM Active PCI-X driver for IBM systems generates messages to 
indicate change of state in the Active PCI system.  If the driver is not 
loaded, no system messages are generated.  The messages that you may see 
generated by the IBMXSBD driver will all be proceeded by the IBMXSBD: or 
IBMXSBD Error: tags.  The messages that may be seen are:

"IBMXSBD: New Adapter added.  Please use the Novell Configuration Manager
console (NCMCON) to configure this new adapter."

This indicates that a new adapter was added into a previously empty slot.
The empty slot can occur as a result of a previous replace or add Active
PCI operation.  This is an information message directing you to use the
console (NCMCON) to configure the newly added adapter.

"IBMXSBD Error: Allocate NEB.AESTag() failed."

This error indicates that the IBMXSBD driver was unable to allocate an
asynchronous event system (AES) tag.  Because events happen asynchronously
in the Active PCI system, IBMXSBD must have an AES handle to function.
Unloading other NLM's that have AES tags registered will free up AES
resources so that the IBMXSBD driver can properly load.

"IBMXSBD Error: Not enough memory to generate event for queue."

This error indicates that memory could not be allocated to place an Active
PCI event onto the internal resource queue.  This normally occurs when the 
system runs out of available memory.  To fix this problem, unload
other NLM's or add additional memory to the system.

"IBMXSBD Error: Add Adapter command failed because of empty slot.  Slot is x"

This messages occurs when NCMCON is directed to add an adapter to a slot
that does not currently have an adapter card in it.  This error may also
occur if a PCI adapter does not meet the PCI v2.1 specification requirement
that the adapter use presence pins.  The IBMXSBD module uses the presence
pins to determine when an adapter has been inserted and removed from the
system.

"IBMXSBD: The IBM hot-plug controller is not present."

This error occurs when an attempt is made to run the IBMXSBD module on a
system that does not have an Active PCI controller.  This error may also
occur if the Active PCI controller is malfunctioning or not working.
The -COMMAND -DEBUG switches can be used on the IBMXSBD driver to determine
if the Active PCI controller is working.  See Section 5.2.2 for more
information about debug switches for the IBMXSBD device driver.

"IBMXSBD: Current operation would exceed bus load limit."

This error occurs when the bus cannot support electrically adding additional
card at current speed and mode.  To fix this problem, try adding the card 
into a different slot on a different bus.

"IBMXSBD: PCI-X mode mismatch for slot: x"

This error happens when the bus is operating at a particular mode, and the card
in slot x is not capable of operating in that mode.  For example, if the bus
is operating at PCi-X mode, and the card in slot x is 33 PCI, or 66 PCI.  To fix
this problem, try adding the card into a different bus.  You can find out information
about buses from NCMCON.

All other messages are provided through the Novell Configuration Manager
Console (NCMCON) screen.  For information about problems in NCMCON such
as all slots show 'No' in the Hot Plug field or a message appears asking
whether to continue waiting another 10 seconds, see Section 5.2.4.

NOTE: NCMCON currently does not update automatically the status of the
slots reported by ibmxsbd, such as current bus speed etc.  As a result
there would sometimes be a message that the adapter 'Failed' after simply
closing the latch on e-server x-Series 440, even if no power fault occured.
In this situation, unload ncmcon and load it again, this will produce the 
correct status of 'Powered off.'

5.1.3 Adapter Driver error messages

Many non Active PCI device drivers will not load correctly with the
ODI v3.31 or the NWPA v3.00b specifications.  If you have such a device
driver, first determine if you adapter vendor has a certified driver
available.  If no such driver exists, you will need to either use a
different adapter or lose at least some of the Active PCI functionality.

Drivers that do not support the Novell specifications may exhibit such
problems as:

- Failure to see new adapters until unloaded and reloaded.

- Failure to support single instance unload.  Single instance unload is
  the ability to unload the driver for a single adapter even though the
  driver may be supported many adapters.

- Failure to be able to register PCI resources such as interrupt, I/O ports,
  memory or prefetchable memory ranges.


5.2 Advanced Troubleshooting

This section contains information that is more technically advanced than
the Basic Troubleshooting section.  Information contained in this section
includes:

 - How to determine if a problem loading an adapter device driver is
   caused by the Hot Plug Controller, IBMXSBD.NLM, or the device driver
   itself

 - debug switches available with the IBMXSBD.NLM driver

 - how interrupts are assigned

 - NCMCON issues such as no Active PCI slots showed, or a query about waiting
   another ten seconds


5.2.1 How to determine if the problem is with the adapter driver
      or the Active PCI driver.

NOTE:  There are no changes to the physical adapter required to support
       Active PCI operations.

Many other adapter vendors will be providing drivers that meet the required
Novell specifications for Active PCI in the future.  However, there are
times where you may have a driver and will not know whether the driver is
Active PCI compatible.  The following is a list of methods to determine if a
given driver supports Active PCI operations.

1.  Almost any driver will allow a singular instance in the Active PCI
    environment.

2.  The device can be powered OFF through the NCMCON screen with a driver
    loaded or has a command-line option to remove a single instance of the
    driver.

NOTE:  A driver that forces all instances of itself to be unloaded is not
       considered an Active PCI driver.

3.  Can the driver detect newly added adapters after an Active PCI operation?

NOTE:  Many adapters will not detect new slot numbers because they do a
       static scan for cards on their first load.  If a new card is added,
       the driver will report that no slots are available.  Unloading the
       adapter (and sometimes the underlying support module, TOKENTSM.NLM,
       ETHERTSM.NLM, etc) and reloading them will allow the new slots to
       be seen in most instances.  However, this will require unloading the
       driver for all adapters in the system.

4.  Does the driver complain about PCI configuration problems?

NOTE:  Some older drivers do not allow for PCI configuration resources to
       be reallocated or changed.  These drivers will report that one or
       more of the PCI resource requirements (IRQs, I/O ports, Memory, or
       Prefetchable Memory) are not correct/unavailable.

5.  If new device drivers, support modules, and installation of the latest
    Support Packs does not fix the problem, then proceed to Section 5.2.2
    to debug the IBMXSBD.NLM module.


5.2.2 Use of switches and log file for IBMXSBD driver

There are a number of command line switches that can be used to create an
IBMXSBD.LOG file in the specified directory on the hard drive.  This file
can be looked at to verify that the IBMXSBD.NLM module is working properly.
The following are the command line switches and a description of each:

The following commands are case sensitive, but they  they require the
leading hyphen.  If multiple commands are given, they should be separated
by spaces.  (ie. LOAD IBMXSBD -DETECT DBGALL -COMMAND)

/?,-?, ? These flags are used to print out the following list of switches.

-DETECT  This parameter will allow the IBMXSBD.NLM driver to detect if the
         Active PCI system and controller are detected.  The driver will
         print a message to the system console as to its finding and then
         terminate.  This flag cannot be used with any other flag.

-DBGALL  This parameter must be listed for any debug actions to be logged
         to the IBMXSBD.LOG file.  Various system information including
         version of NetWare, PCI BIOS discovery, Novell Event Bus (NEB)
         events, Novell HIN numbers, driver deregistration, memory
         release traces and the PCI Interrupt Routing Options table are
         documented.


If a problem arises where you must create the IBMXSBD.LOG file, the file
can be submitted as part of the call to the HelpCenter for further
diagnostic help.


5.2.3 Interrupt handling

Interrupts are handled in the following manner:

- Only interrupts 9, 10, and 11 will be assigned to Active PCI devices.
  These options are not settable.  If during BIOS setup, these three
  interrupts are reserved for ISA Legacy devices, all Active PCI
  operations will fail.

- IRQ 15 will never be assigned to Active PCI devices unless an adapter
  already installed in the server of the same type has already been assigned to
  IRQ 15.

- Interrupts are preserved from the MPS table located in the extended BIOS
  data area (EBDA) of the system.

- For slots that do not have an adapter in them at boot, interrupts are
  assigned according to the following formula:

  - If another device that matches the vendorID and deviceID in the PCI
    Configuration header is found, then the newly added adapter will
    receive the same interrupt as the other device.

  - An unused interrupt between 9, 10, and 11 is assigned.

  - The least used interrupt between interrupts 9, 10, and 11 is assigned.

NOTE:  There may be instances where a LAN and SCSI controller may be
       assigned the same interrupt.  If this occurs, the LAN adapter may
       fail to handle interrupts correctly when the SCSI controller accesses
       the DOS partition and lose connections.  If this occurs, it will be
       necessary to down the server, reboot it, go into System Setup, and
       manually assign the interrupts so the devices do not share interrupts.


5.2.4 NCMCON issues

- If NCMCON.NLM fails to report the correct bus speed at which any of the
  busses is operating, exit NCMCON and reload NCMCON.

- If NCMCON.NLM fails to show any slots with 'Yes' in the Hot Plug field,
  the IBMXSBD.NLM module is not loaded.  To fix the problem, exit NCMCON,
  load IBMXSBD at the system console, and reload NCMCON.

- If you receive a message about Slot Status not being available with
  a query to wait another 10 seconds, NCM.NLM or one of its support modules,
  IOCONFIG.NLM or NEB.NLM is not loaded.  To fix this problem, exit NCMCON,
  load the appropriate support modules, load NCM, then NCMCON.  It is not
  necessary for NCM or NCMCON to be loaded for the IBMXSBD driver to load
  properly.

- If a fully supported ODI v3.31 LAN device driver cannot be unloaded, verify
  that ODINEB.NLM is loaded.  It can be loaded at the system console after
  NEB.NLM is loaded.

- All SCSI controller drivers must be unloaded from the system console.
  The following command to remove a single adapter and its volumes from
  the system:

  REMOVE STORAGE ADAPTER Ax

  where x is the adapter number as determined by the scan order of the PCI
  buses in the system.  All integrated devices will be assigned first,
  followed by adapters in PCI Bus 0, PCI Bus 1, etc.

- When using failover pairs in conjunction with Active PCI, you should not
  setup failover pairs using the Netfinity Ethernet Adapter 2 and the Netfinity
  Fault Tolerant Ethernet Adapter as two independent pairs.  Failover pairs
  should consist of one adapter type or the other, but not both simultaneously.


6.0   Disclaimer
----------------------------

6.1   THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.   IBM
      DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT
      LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
      MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT.   BY
      FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR
      COPYRIGHTS.


6.2   Note to U.S. Government Users -- Documentation related to restricted
      rights -- Use, duplication or disclosure is subject to restrictions set
      forth in GSA ADP Schedule Contract with IBM Corporation.