
             Adaptec 7800 Family Manager for OS/2 2.1X/Warp
             =============================================


This diskette contains Adaptec's OS/2 solution for the AIC-7800 Family of
Host Adapters.  This includes:

      AHA-2910      PCI-to-Fast SCSI (non-bootable)
      AHA-2940      PCI-to-Fast SCSI
      AHA-2940W     PCI-to-Fast and Wide Single-Ended SCSI
      AHA-2944W     PCI-to-Fast and Wide Differential SCSI
      AHA-2940Ultra PCI-to-Wide UltraSCSI
      AHA-3940      MultiChannel PCI-to-Fast SCSI
      AHA-3940W     MultiChannel PCI-to-Fast and Wide SCSI
      AIC-7850      Single-Chip PCI-to-Fast SCSI
      AIC-7870      Single-Chip PCI-to-Fast and Wide SCSI
      AIC-7880      Single-Chip PCI-to-UltraSCSI


The folowing files on this diskette are required for the installation of
the 7800 Family OS/2 driver:

         \os2\aic7870.add
         \os2\7870pres.exe
         \os2\aic7870.ddp
        

=============================================================================
           INSTALLATION INSTRUCTIONS FOR THE OS/2 DRIVER:
=============================================================================

1) Installing a New Driver or Updating an Existing Driver for OS/2 2.1X/Warp
----------------------------------------------------------------------------

  a) Open the OS/2 System Folder, then open the System Setup folder.

  b) Double-click on Device Driver Install.

  c) Insert the AS2940UW CD to the appropriate drive.

  d) Change to the directory where the driver is located, usually \OS2.
                                                                      
  e) When you find the driver (AIC7870.ADD), select INSTALL.

  f) After the install finishes, a message will appear to report the 
     status.  An error will be displayed if no host adapters are found.

     You may also install the driver manually. 
     If running OS/2 2.1X, copy AIC7870.ADD to C:\OS2.
     If running OS/2 Warp, copy AIC7870.ADD to C:\OS2\BOOT.
     Add a line to your CONFIG.SYS that says BASEDEV=AIC7870.ADD .

  Note: If you run out of disk space and are unable to copy the
  AIC7870.ADD driver to the appropriate directory, you will need to delete
  other drivers in that directory that are not being used. Be sure to make
  backup copies of any drivers or files before deleting them.

2) First-Time Installation of OS/2 2.1X/Warp From Floppy Diskette
-----------------------------------------------------------------

  a) Make backup copies of the Installation Diskette and Disk #1.

  b) If you are installing OS/2 2.1X, use the backup copies of the
     Installation Diskette and Disk #1 to do the following:

     1) Copy OS2LDR from AS2940UW CD onto the Installation Diskette.

     2) Copy IBMINT13.I13 from AS2940UW CD onto Disk #1.

     Note: You do not need these files when installing OS/2 Warp.

  c) Install OS/2 using the backup diskettes and the remainder 
     of the standard OS/2 diskettes.
         
  d) When installation has completed, reboot the system.

  e) After the system has rebooted, follow the instructions for installing
     the driver on a system containing OS/2.


3) First-Time Installation of OS/2 2.1X From CD-ROM
---------------------------------------------------

  a) Copy the OS2LDR file from the AS2940UW CD
     (i.e., \OS2\OS2LDR) onto the OS/2 installation diskette.
     This overwrites the existing OS/2 loader on the diskette.

  b) Copy the IBMINT13.I13 driver from the AS2940UW CD
     (i.e.,\OS2\IBMINT13.I13) onto the OS/2 installation diskette #1.
     This overwrites any existing version of the driver included on
     diskette #1.

  c) Copy the AIC7870.ADD driver from the AS2940UW CD
     (i.e., \OS2\AIC7870.ADD) onto the OS/2 installation diskette #1.
     This overwrites any existing version of the driver included on
     diskette #1.

  d) Modify the CONFIG.SYS file on diskette #1 to include the following
     line:

          BASEDEV=AIC7870.ADD /PCIHW

  e) Run the OS/2 installation program; follow the instructions in your
     OS/2 documentation.

  f) At the end of the installation process, follow the onscreen instructions
     to remove the last OS/2 distribution diskette and reboot the computer.
     If the computer fails to boot up, and locks up while displaying the OS/2
     logo screen, you may use one of the following options to get to the 
     command prompt:

     1) If you installed OS/2 using the FAT Filesystem, boot up MS-DOS 
        to get to the command prompt.

     2) If you installed OS/2 using the HPFS Filesystem, insert the 
        Installation Diskette and boot up the computer from this diskette.
        When the IBM screen is displayed, remove the Installation diskette
        and insert Diskette #1 as instructed to do so. After a while, a screen 
        will be displayed asking which installation method you wish to choose.
        At this point, press the F3 key to get to the command prompt.

     Once you get to the command prompt, change to the drive where the OS/2 
     system files are located (usually Drive C:).  You may now use a text
     editor to again modify the OS/2 CONFIG.SYS file on the hard drive to add
     the /PCIHW switch to the BASEDEV=AIC7870.ADD line as shown in step e.
     OS/2 should then boot normally from the hard disk.

  g) After the computer has restarted, OS/2 displays a screen. You have the
     option to view online information while the OS/2 desktop is building.
     Allow OS/2 to finish building, and follow the onscreen instructions to
     restart the computer. Again, if the computer fails to boot up, and locks
     up while displaying the OS/2 logo screen, repeat the process specified
     in step g to correct the problem.

  Note: The CONFIG.SYS, IBMINT13.I13, and OS2LDR files may be overwritten
  by equivalent files from the CD-ROM. If this occurs, follow step g above
  to recover those files. 


4) First-Time Installation of OS/2 Warp From CD-ROM
---------------------------------------------------

a) Run the OS/2 installation program; follow the instructions in your 
   OS/2 documentation.
 
After reboot, update the AIC7870.ADD on the
boot drive from DISK #1 (this file will be overwritten from the CD-ROM).

NOTE: The update files OS2LDR and IBMINT13.I13 included in the 
AS2940UW CD are not needed when installing OS/2 Warp.


Additional Notes:
-----------------

OS/2 2.1X currently does not identify PCI systems and handles them
in the same way it would an ISA system. This can cause several different
problems: trouble installing OS/2 2.1X and an inability to share a single
interrupt between multiple PCI adapters.

IBM is aware of these problems and has open APARs (PJ14230 and PJ14710)
tracking them. They will be fixed in a future release of OS/2; please check
the list of closed APARs accompanying each future release.

Currently, we have files which can be used as interim fixes for both these
problems:

   OS2LDR - A new PCI aware version of the loader. This file can be used
   during installation or installed after the installation of OS/2 has
   completed.

   IBMINT13.I13 - A new PCI aware version of the generic INT 13H driver that
   is used during installation from floppy disk.

If you update Disk #1 of the CD-ROM installation to include OS2LDR, please be
aware that this file will be overwritten from the CD-ROM. It may have to be
updated again on the boot drive when the installation has completed.

The update files OS2LDR and IBMINT13.I13 included in the 7800 Family Manager
Set are not needed when installing OS/2 Warp.

This driver added a new switch named /PCIHW which enables the driver to 
ignore the PCI BIOS and access the PCI hardware registers directly. This
switch could be useful for the users having problems loading the AIC7870.ADD
included with OS/2 Warp, if their system has a non-compliant
system BIOS. 
                                                        
        BASEDEV=AIC7870.ADD /PCIHW

Intel Errata #8511 lists known data integrity issues with the 
processor cache on the Saturn-1 chipset (82424TX).  For this reason 
Adaptec recommends that processor cache be disabled via the CMOS 
setup to avoid data corruption.  For more information, see Intel 
Errata #8511.  You may get this from Intel's FaxBack system at 
800.628.2283 or 916.356.3105.  For more detailed information see 
Errata #8512 and 8513.  
                                            
There is currently no support for installing OS/2 2.0 on a hard drive
attached to an AIC-7870, due to limitations in the installation procedure. 
Upgrading to OS/2 2.1 or higher is recommended.


=============================================================================
                      Configuration Information:
=============================================================================

Generic Command Line Switches for Adaptec Drivers and OS/2 2.1X and Above
-------------------------------------------------------------------------

OS/2 adapter device drivers (.ADD files) are normally installed 
automatically and require no further information from the user. However,
in certain situations the user may wish to modify the behavior of the 
driver to meet their specific needs.

***** IMPORTANT *****
Please proceed cautiously with the following information. If you have
purchased software which requires you to use switches, it should include
instructions on how to use them. Most software requires no switches and
you do not need to concern yourself with the information about switch 
settings.

The standard format for command line switches is :
BASEDEV=AIC7870.ADD [Universal Parameter][Adapter ID][Unit Parameter]
          {[SCSI Target ID]}

  [Universal Parameter] - An option that applies to all adapters 
           controlled by the driver.

  [Adapter ID] - /A:n, where n is the number (zero relative) of the adapter
           installed in the system. The adapter ID is determined when 
           the driver is loaded based on the order that adapters are 
           found in the system. (See below, AIC7870.ADD Specific Command
           Line Switches.)

  [Unit Parameter] - Modifies the behavior of the selected host adapter.

  [SCSI Target ID] - The targets to which the Unit Parameter will be applied.
           This parameter may be a single ID (d) or list of IDs (d,d,d).


Universal Parameters:
---------------------

   /ET - Allow embedded targets.  This parameter indicates that the ADD
      should assume that all targets have more than one logical unit (LUN)
      defined.

   /!ET - Do not allow embedded targets (DEFAULT). This parameter indicates
      that the ADD should assume that all targets have only one logical 
      unit (LUN) defined.

   /V - Load driver verbosely. This parameter will display the driver
      name as well as the version number and Adaptec copyright if the driver
      loads successfully. Information on all targets found in the system
      will also be displayed.

   /PCIHW  Enables driver to access PCI configuration hardware registers.
           This switch is implemented because in some PCI systems accessing
           PCI configuration space through PCI BIOS function calls causes
           problem.

   /INSTR  Enables I/O Performance monitoring. This switch allows the
           AIC7870.ADD driver to record I/O statistics and errors.


           
General Unit Parameters:
------------------------

   /I - Ignore the specified adapter. This allows another driver to
      share the adapters that the ADD would normally use.

   /DM - Enable DASD manager support (DEFAULT). This parameter allows
      OS2DASD.DMD to control the specified target(s) if they are 
      identified as DASD (hard disk) devices.

   /!DM - Disable DASD manager support. This parameter prevents
      OS2DASD.DMD from controlling the specified target(s).

   /SM - Enable SCSI manager support (DEFAULT). This parameter allows
      OS2SCSI.DMD to control the specified target(s) if they are 
      identified as NON-DASD SCSI devices. All SCSI hard drives 
      will be controlled by OS2DASD.DMD.

   /!SM - Disable SCSI manager support. This parameter prevents
      OS2SCSI.DMD from controlling the specified target(s).


Configuration Examples:
-----------------------

Example 1

   Suppose that you had a removable hard drive as target 3 and you wanted
   to control the hard drive with an ASPI application and driver.
   Normally OS2DASD will allocate this device, treat it as a large
   floppy and prevent you from sending any SCSI commands via ASPI.

   BASEDEV=AIC7870.ADD /A:0 /!DM:3 will prevent OS2DASD.DMD from
   accessing the target and still allow OS2SCSI.DMD and OS2ASPI.DMD to
   share access to it.

Example 2

   Suppose that you had a multi-disk CD-ROM as target 4 on host adapter 0 and
   two DASD devices as targets 1 and 5 on host adapter 1.

   BASEDEV=AIC7870.ADD /ET /A:0 /!SM:4 /A:1 /!DM:1,5 will prevent
   OS2SCSI.DMD from accessing the CD-ROM and prevent OS2DASD.DMD from
   controlling the DASD devices. The driver will also search for multiple
   LUNs on all host adapters.


Important Tips:
---------------

  1) There are no switches for controlling OS2ASPI.DMD directly. IBM did
    not define them in their specification and we cannot be sure that other
    host adapters will have the same switches.

  2) OS2SCSI.DMD will only allocate devices when a device driver
    requests it, but this will prevent OS2ASPI from accessing it. There is
    nothing in the ASPI specification regarding device allocation so
    OS2ASPI must rely on other managers to fairly share targets. This
    should only be a problem if you have two drivers that use different
    managers and you want them both to access the same target at the same
    time.

  3) Do NOT disable DASD manager access to target 0 if you are booting
    from your SCSI host adapter. This will prevent the system from booting!


AIC7870.ADD-Specific Command Line Switches
------------------------------------------

This driver supports the AIC-7800 Family of Host Adapters.
Adapter numbers are first assigned to boards with their BIOS enabled.
The numbers are assigned from lowest BIOS address to highest address.
Any remaining boards are assigned numbers by scanning slots.  
Each slot is a combination of a bus number and a device number pair 
starting from lowest to higest numbers, and the adapters are assigned a 
number in the order they are found.  


Special Unit Parameters:
------------------------

      /TAG: - Sets the number (1-16) of tagged commands for all target
              devices on the host adapter. A value of one disables 
              tagged queuing. 16 is the maximum number allowed and 8 is
              the default value.

      /TAG:1  Disables tagged queuing for all target devices on a given
              host adapter. The driver maintains a maximum of 2 non-
              tagged commands per target internally. The driver treats
              all target devices as non-tagged devices, and sends only
              one command at a time per target to the host adapter.

       Example:

       BASEDEV=AIC7870.ADD /A:0 /TAG:8
               will set the number of tagged commands for all target
               devices on the first host adapter to 8.
               

==============================================================================
                            Limitations:
==============================================================================

     Fault Tolerance is now supported in the driver. However, ABORT and 
     SCSI BUS RESET will only work for targets that are properly
     behaved.

