Copyright 2000, Compaq Computer Corporation

Compaq SCSI Controller Support for IBM OS/2

Table Of Contents

1.0 Introduction
2.0 Controller Ordering
2.1 SCSI ID's
2.2 Partitioning
3.0 Installing IBM OS/2 from CD-ROM
3.1 Using the Compaq CD-ROM Installation Setup Utility
3.2 Manual process to modify the CD-ROM installation Diskette 1
4.0 Compaq SCSI Controllers
4.1 Supported controllers
4.2 Installing IBM OS/2 with a Compaq SCSI Controller
4.3 Ultra-SCSI support
4.4 Maximum number of controllers
4.5 Resource Manager awareness
4.6 Tracing capability
5.0 Command Line Switches
6.0 Hot-plug and Online Redundancy
7.0 Troubleshooting

1.0 Introduction
This document contains information on the use of the SCSI controller drivers for
IBM OS/2 as published by IBM Corporation. These drivers work with the
ADD driver architecture and are not meant to be stand-alone drivers. All Storage controller
drivers are located on the OS/2 SSD in the \ADD directory of the OS/2 SSD
System and Storage Diskette.

The drivers are described briefly below:
CPQ53CX.ADD: The CPQ53CX.ADD driver supports disk, tape, and CD-ROM drives
with these SCSI Controllers

AMSIO2.ADD: The AMSIO2.ADD driver supports disk, tape, and CD- ROM drives
with the Integrated PCI SCSI-2 Controller located on Compaq PC systems (e.g. the
Compaq Deskpro XL). This driver is not available on SSD 3.01A and later. For more
information read History.

2.0 Controller Ordering

See here for Configuring Controller Order.

The following set of rules must be followed for the driver to function properly with other
storage controllers configured in the system.

NOTE: These rules are NOT automatically enforced by the Compaq System Configuration
Utility. Follow them carefully when configuring the system.

1. All Compaq SCSI Controllers must be configured in consecutive controller order. This
includes the following SCSI Controllers:
2. To boot from a Compaq SCSI Controller, it must be configured as `First` for the
controller order.
3. If an Integrated SCSI-2 Options Port is part of the system, configure it as the last controller.
The Integrated SCSI-2 Options Port CANNOT be configured as `First` for controller order.

2.1 SCSI ID's

The system will always try to boot from the hard drive with the lowest SCSI ID. Set the
boot drive as SCSI ID zero (0). It is possible to have a tape drive or CD-ROM drive with a
SCSI ID lower than the boot drive, but it is not recommended.

The CPQ53CX.ADD driver supports up-to 14 target ID'S. For this support it is
necessary to have a back plane controller that can drive 14 targets.

2.2 Partitioning

See here for Partitioning Information. 

3.0 Installing IBM OS/2 from CD-ROM

To install IBM OS/2 from CD-ROM on Compaq Servers may require modifying
Diskette labeled OS/2 Diskette 1. Please follow the instructions given below

3.1 Using The Compaq CD-ROM Installation Setup Utility
 
The Compaq OS/2 SSD, v2.05 or later, ships with a utility to update the IBM installation
Diskette 1. The utility requires a computer already running OS/2. For complete
instructions, refer Cpqsetup Utility.
 
3.2 Manual Process to Modify the CD-ROM Installation Diskette 1

To install IBM OS/2 from a CD-ROM drive on one of the systems listed in servers.
complete the following:

1. Make a copy of the IBM installation diskette labeled Diskette 1. This diskette ships with the
CD- ROM from IBM.

2. The appropriate ADD driver must be added to Diskette 1. Locate a machine with an operating
system already installed and insert the Compaq OS/2 System and Storage Drivers Diskette
into one of the floppy drives.

3. Copy the appropriate ADD driver to the hard disk and then to the Installation Diskette 1. If there
is not enough room on the Diskette 1, delete any ADD drivers or other files that are not required.
This may include, IBM2*.ADD, SONY*.ADD, SB*.ADD, LM*.ADD, and FD*.ADD.

4. Edit the CONFIG.SYS file located on Diskette 1. At the end of file, add the appropriate line for the
driver that was expanded in step 3:

BASEDEV=CPQ53CX.ADD or

Insert the letters REM before any lines in the CONFIG.SYS file located on Diskette 1 that refer
to the files deleted in step 4.

5. Return to the machine on which IBM OS/2 is to be installed. Begin the installation by inserting the
Installation Diskette into drive A and starting the computer.

NOTE: During the installation process it is not necessary to modify the default value for
"CD-ROM Device Support" or "SCSI Adapter Support" on the System Configuration screen.

4.0 Compaq SCSI Controllers

4.1 Supported Controllers

The following is a list of SCSI Controllers supported by the CPQ53CX.ADD driver:

4.2  Updating the Drivers

Please follow the steps mentioned in Installing a Compaq OS/2 Driver OR
Compaq Support Software Setup Utility

4.3 Ultra-SCSI Support

The CPQ53CX.ADD driver supports Ultra speeds (up to 40 MBps)
on Ultra-SCSI hard disk drives. The hardware and software
that are required for running Ultra speeds are:

1. Ultra SCSI hard disk drives connected to

- Compaq Integrated Wide-Ultra SCSI-2 Controller
- Compaq Integrated Dual Channel Wide-Ultra SCSI-3 Controller
- Compaq Dual Channel Wide-Ultra SCSI-3 Controller Option
- Compaq Integrated Dual Channel Wide-Ultra SCSI Controller
- Compaq 32 Bit Wide Ultra SCSI-2 Controller/P option
- Compaq 64 Bit Dual Channel Wide Ultra2 SCSI Controller

2. Compaq SCSI Driver for OS/2, Version 2.28 or later

3. Compaq System Configuration Utility, Version 2.33A or later.

4. Compaq ProLiant Storage /U and /F Boxes for external controllers.

4.4 Maximum Number Of Controllers

The CPQ53CX.ADD v2.50 and later can support up to 14 Compaq SCSI controllers on
single Compaq server.

4.5 Resource Manager Awareness

The CP53CX.ADD v2.40 and later is Resource Manager aware. The physical and logical
configuration information registered by the driver can be accessed using the "rmview.exe"
utility available at the OS/2 command prompt.

4.6 Tracing Capability

The CPQ53CX.ADD v2.40 and later logs information to the system trace buffer. This trace
information can be viewed using the "tracefmt.exe" utility. The Trace Major code of the
driver is 252.

5.0 Command Line Switches

In certain situations you may want to modify the standard behavior of a SCSI ADD driver.
Software that requires the uses of command line switches should include instructions for
their uses. Most software does not require any switch settings.
The syntax of the command line switches is:

BASEDEV=<DRIVER>.ADD /A:[adapter index] [unit parameters]

[adapter index] The adapter index of the controller. Adapters are numbered
consecutively, starting with 0. Adapter index "0" corresponds to the controller with the
lowest controller order. The controller order is assigned when running the Compaq System
Configuration Utility.

[unit parameters] Parameters to disable either OS2DASD.DMD or OS2SCSI.DMD support
or ignore a controller.

The following unit parameters are available:

/!DM:<SCSI ID> where <SCSI ID> is the SCSI ID of the device for which you want to disable
OS2DASD.DMD support. This may be a single SCSI ID or a list of IDs <SCSI ID>,<SCSI ID>.

/!SM:<SCSI ID> where <SCSI ID> is the SCSI ID of the device for which you want to disable
OS2SCSI.DMD support. This may be a single SCSI ID or a list of IDs <SCSI ID>,<SCSI ID>.

/I Ignore the specified adapter; do not control the adapter with this driver.
This parameter prevents the ADD driver from recognizing the specified adapter.
Use when you want to have another driver control a specific adapter.

/V Load the driver in verbose mode. This parameter causes the driver to print information
to the screen when it loads. The driver will identify itself along with the current revision.
Then information concerning the adapters and the devices attached them will
be displayed. (CPQ53CX.ADD only)

Example 1
You are running NetWare on your IBM OS/2 system and you want a NetWare NLM to
control adapter 1 instead of the ADD driver. The following statement would prevent the
ADD driver from claiming adapter 1.

BASEDEV=CPQ53CX.ADD /A:1 /I

Example 2
You have a tape drive on adapter 1 with a SCSI ID of 2 and two fixed disks on adapter 0
with a SCSI of 3 and 4. To prevent OS2SCSI.DMD from controlling the tape drive and
prevent OS2DASD.DMD from controlling the fixed disks, use the following statement:

BASEDEV=CPQ53CX.ADD /A:1 /!SM:2 /A:0 /!DM:3,4

The Syntax of the command line parameter to configure for Controller redundancy
/RBP:[Primary Slot]:[primary Port],[Secondary Slot]:[Secondary Port];
This Option is used to configure a duplex pair for controller redundancy.
The Primary Slot and Primary Port parameters specify the slot and port of the
active/primary controller. The Secondary Slot and Secondary Port parameters specify the
slot and port of inactive/redundant controller.
The slot and Port of each controller in a duplex pair should be separated by a colon and
the option should always end with a semicolon.
Example:
BASEDEV=CPQ53CX.ADD /RBP:2:1,3:2;
This specifies that the controller on slot 2 and port 1 is primary and the controller on
on slot 3 and port 2 is redundant.
Basedev=cpq53cx.add /RBP:2:1,3:2;6:2,5:1
More than one pair can be specified in the same line, separating them by a semicolon, as
shown above. Here, controllers on slot 2, port 1, and slot3,port2 form the first duplex
pair and controllers on slot 6, port 2 and slot 5, port 1 form the second duplex pair.

The /SW:[hours] Switch to specify the duration of switchover of duplex pairs:
This switch is used in conjunction with /RBP option. this option enables switch
over to the secondary/redundant controller every specified hours. This is to ensure
that the secondary is healthy. If this option is not specified, the switch over to the
redundant controller will be set to default i.e one hour.
Example :
BASEDEV=CPQ53CX.ADD /RBP:2:1,3:2; /SW:1 This indicates that the controller
switchover from active to redundant takes place every one hour to ensure that
the back-up controller is healthy.
The following statement in CONFIG.SYS disables periodic switchover to the redundant
controller.
BASEDEV=CPQ53CX.ADD /RBP:2:1,3:2; /SW:0

6.0 Hot-Plug and Online Redundancy

The driver supports Hot-replacement of PCI SCSI Controllers present in Hot plug slots
of a system.
The controllers that supports Hot replacement are listed below:
- Compaq Stand-alone 32 Bit Fast-Wide SCSI-2 Controller/P option
- Compaq Stand-alone 32 Bit Wide-Ultra SCSI-2 Controller/P Option
- Compaq Stand-alone Dual Channel Wide-Ultra SCSI-3 Controller Option
- Compaq 64 Bit Dual Channel Wide Ultra2 SCSI Controller

The driver also supports Online making/dissolving of redundant back-up
pair of controllers present in the system. To make a redundant back-up pair, one
controller should be a standalone controller and the other should be an offline
controller.

To support the Hot plug feature, it is necessary to have installed the following drivers :
 * Compaq 32-bit Helper Driver for OS/2 (CPQB32.SYS v3.20 or later)

For more help on Hot replace of the controllers,
please refer Compaq Storage Configuration Utility help file.

7.0 Troubleshooting

*  The CPQ53CX.ADD SCSI driver supports multiple Logical Unit Numbers (LUNs) per target
SCSI ID; but, the LUNs must be in sequential order starting at LUN 0.

*  The driver MUST be loaded by a BASEDEV= statement in the CONFIG.SYS file, i.e.
BASEDEV=CPQ53CX.ADD.

*  When using IBM OS/2 v2.1 or later and CD-ROM devices, it is necessary to use the IBM
OS2CDROM.DMD driver (included with the base product). For SCSI tape support with
IBM OS/2 2.1, the IBM OS2SCSI.DMD driver is required. Check CONFIG.SYS for the required
DMD driver.

Example: DEVICE=OS2CDROM.DMD

*   For CD-ROM support, the standard IBM OS/2 2.0 product provides a CD-ROM device
driver for IBM and Toshiba CD-ROM SCSI devices. Contact IBM for a more general
purpose CD-ROM driver (for data access only, no audio). The name of this general purpose
device driver is CDROM_G.SYS. IBM OS/2 2.1 has improved third party SCSI CD-ROM
support that includes audio support.

*   When using IBM OS/2 2.0 and CD-ROM or SCSI tape devices, it is necessary to use the
IBM OS2SCSI.DMD driver (included with the base product). This driver should be referenced
in the CONFIG.SYS file. Check CONFIG.SYS and add this line if it is not already present.

Example: BASEDEV=OS2SCSI.DMD

*   When a ProLiant Storage System or the drive cage in a ProLiant Server is attached to an
adapter controlled by CPQ53CX.ADD, the disk tray on-line LED will be illuminated during
initialization unless the drive fails the test unit ready command. If a failure occurs during
initialization the failed LED will be illuminated. if this occurs, run the Compaq
Diagnostics Utility.

*  While OS/2 is running, the disk tray on-line LED will remain illuminated. If you suspect
a drive is failing, shutdown the system using the shutdown command. At this point, the
on-line LEDs will be turned off, and if the last read or write command to a drive failed,
the failed LED will be illuminated. If any failed LED is illuminated, run the Compaq
Diagnostic Utility.

*  Prior to Compaq OS/2 Support Software Diskette v1.11, the Fast-SCSI-2 driver was named
CPQC710.ADD. On v1.11 the name was changed to CPQ53CX.ADD. Use caution when switching
between CPQC710.ADD and CPQ53CX.ADD. Do not load both of these into your
CONFIG.SYS file at the same time. You only need one or the other.

*  The Integrated SCSI-2 Options Port cannot be the primary controller.

*  When using the /V verbose command line option on a system running IBM OS/2 SMP v2.11,
the text is not reliably displayed.

*  The driver requires the Compaq BIOS-32 driver (CPQB32.SYS) in the system configuration
to support the Integrated Management Log (IML) on the Compaq servers that support IML.

Note : The statement 'BASEDEV=CPQB32.SYS' MUST be present in CONFIG.SYS for
making use of the Driver Management Log. Refer Installing CPQB32 for loading
Compaq 32 Help driver driver. 

Copyright 2000, Compaq Computer Corporation
All rights reserved.

* OS/2 is a registered trademark of the IBM Corporation.
Other product names mentioned herein may be trademarks or registered trademarks
of their respective companies.