IBM SAS Controller Driver for DOS NOTE TO SERVICE - Reference RETAIN N/A (C) Copyright International Business Machines Corporation 1999, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Note: Before using this information and the product it supports, read the general information in "Notices and trademarks" in this document. CONTENTS ________ 1.0 Overview 2.0 Installation and setup instructions 3.0 Configuration information 4.0 Unattended mode 5.0 Web information and support phone Number 6.0 Notices and trademarks 7.0 Disclaimer 1.0 Overview _____________ 1.1 Initial release of the DOS ASPI driver for the IBM SAS controller. 1.2 Limitations - None 1.3 Problem(s) fixed: - See change history for more details. 1.4. Level of Recommendations and Prerequisites for the update: - none 1.5 Dependencies - One blank diskette. 1.6 Update Contents - The following files are associated with this update: o ibm_dd_mptsas_6.01.00_dos_noarch.zip - zip file that contains the DOS ASPI driver o ibm_dd_mptsas_6.01.00_dos_noarch.chg - Change history 2.0 Installation and setup instructions ________________________________________ This ASPIMPT.SYS driver is an ASPI manager that provides an interface to popular ASPI applications. It is required when you want to use SYMDISK.SYS or SYMCD.SYS, or whenever you want to run an ASPI application. This interface replaces a Fusion-MPT BIOS (if present), and fully supports all devices supported by the BIOS. If a Fusion-MPT BIOS is not present, only an ASPI interface is provided. *********************** Installing Your ASPIMPT.SYS Driver ******************** To install the ASPIMPT.SYS driver, follow these steps: 1. Use the COPY command to copy the ASPIMPT.SYS driver from the Fusion-MPT software package to your boot disk. 2. Add this line to the system's CONFIG.SYS file: DEVICE=C:[path]ASPIMPT.SYS This line must appear before any line loading other Fusion-MPT drivers (such as, SYMCD.SYS, SYMDISK.SYS), or any other ASPI compliant driver/application. ***************************** Command Line Options **************************** The ASPIMPT.SYS driver has several configurable features that are set by using switches on the command line in your CONFIG.SYS file. The command line options are as follows and the usage is detailed below: /ASK, /DISCONNECT (or /DC), /EXCLUDE (or /X), /HOST_ID (or /ID), /NORST, /MIRROR, /RAID, /PARITY (or /P), /SYNCH_RATE (or /SR), /SYNCH_OFFSET (or /SO), /SBN, /TIMEOUT (or /T), /VERBOSE (or /V), /WIDTH (or /W) In the following descriptions, "path" refers to the adapter number (boot order designation), and "id" refers to the SCSI ID. The following conventions are also used: [ ] items in brackets are optional * means repeat item 0 or more times IMPORTANT: No spaces are allowed within a single command line option, but spaces are required between different command line options. Using these command line options will override the settings in the SCSI BIOS Configuration Utility. 3.0 Configuration information ______________________________ ********* Using the /ASK Option ********** This option prompts at system boot-up time about loading the ASPIMPT.SYS driver. Option Syntax: /ASK For example, to activate this option, the line in your CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /ASK ********* Using the /DISCONNECT (or /DC) Option ********* This option allows a device to disconnect since SCSI devices have the ability to disconnect from the bus during an I/O transfer. If a particular host adapter has parity checking disabled, all devices attached to it must have disconnects disabled, since parity is required during the reselection phase. Valid options are ON (allow disconnects) or OFF (do not allow disconnects). The default for all devices is ON. Option Syntax: /DISCONNECT=n[,n]* n = ON | OFF For example, to disable disconnects on the device attached to the first host adapter (boot order designation = 0) at SCSI ID 2, the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /DISCONNECT=OFF<0:2> ********* Using the /EXCLUDE (or /X) Option ********* This option allows you to exclude support for an adapter that does not currently have BIOS support. You may not exclude an adapter that is supported (included) by the BIOS when you boot your system. This option has three required parameters: a. PCI Device ID b. PCI Bus Number c. PCI Device/Function Number These parameters identify the specific adapter you want to exclude. To obtain these parameters, boot your system using the /VERBOSE command line option (explained later in this section). Option Syntax: /EXCLUDE[,]* a = PCI Device ID b = PCI Bus Number c = PCI Device/Function For example, if you found the adapter you wish to exclude to have PCI Device ID 30, PCI Bus Number 0, and PCI Device/Function Number 68, then the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /EXCLUDE<30:0:68> ********* Using the /HOST_ID (or /ID) Option ********* This option lets you alter the SCSI ID for a host adapter. On an 8-bit adapter, the SCSI IDs are 0-7. On a 16-bit adapter, the SCSI IDs are 0-15 (it is suggested that IDs 8-15 not be used for your adapter). This option will not allow you to select a SCSI ID already in use. If the host adapter allows connection of both 8-bit and 16-bit devices to the same bus, and the adapter number is changed to greater than 7, then the 8-bit SCSI devices will not be able to reselect the initiator. NOTE: You are not allowed to change the SCSI ID of any adapter currently supported by the BIOS. Option Syntax: /HOST_ID=n[,n]* n = SCSI ID Desired (within the guidelines suggested) For example, to change the SCSI ID of your second host adapter (path=1) to ID=6 (providing that adapter is not controlled by the BIOS), the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /HOST_ID=6<1> ********* Using the /NORST Option ********* This option prevents a SCSI bus reset during loading of ASPIMPT.SYS. For example, if a SCSI bus reset is not desired during load, the line in the CONFIG.SYS file that loads ASPIMPT.SYS would look like this: DEVICE=C:[PATH]ASPIMPT.SYS /NORST ********* Using the /MIRROR Option ********* This option tells the host adapter to disable the Integrated Mirror (TM) feature. If an Integrated Mirror (IM) volume is present, the driver will disable access to the "Logical" drive, and, will provide access to the physical drives that comprise the IM Volume. WARNING: This option should be used with caution. Typically, this option will only be used in the manufacturing environment to install software, or, for testing operations. If an IM volume is present, it can be made unusable if the physical disks are modified while using this option. Option Syntax: /MIRROR=n n = ON | OFF For example, to turn off Integrated Mirroring on the first host adapter (boot order designation = 0), the line in your CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /MIRROR=OFF<0> NOTE on ACCESSING Physical Drives when the IM volume is disabled: When the IM volume is disabled, SYMDISK.SYS must be loaded to get access to physical drives other than the physical drive with the IM volume's target ID. ********* Using the /RAID Option ********* This option tells the host adapter to disable the Integrated RAID (TM) feature. If an Integrated RAID (IR) volume is present, the driver will disable access to the "Logical" drive, and, will provide access to the physical drives that comprise the IR Volume. WARNING: This option should be used with caution. Typically, this option will only be used in the manufacturing environment to install software, or, for testing operations. If an IR volume is present, it can be made unusable if the physical disks are modified while using this option. Option Syntax: /RAID=n n = ON | OFF For example, to turn off Integrated RAID on the first host adapter (boot order designation = 0), the line in your CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /RAID=OFF<0> NOTE on ACCESSING Physical Drives when the IR volume is disabled: When the IR volume is disabled, SYMDISK.SYS must be loaded to get access to physical drives other than the physical drive with the IR volume's target ID. ********** Using the /PARITY (or /P) Option ********* This option tells the host adapter to disable the SCSI bus data integrity checking feature known as parity. Some SCSI devices do not generate parity. Valid options are ON (check parity) or OFF (do not check parity). The default for all devices is ON. Warning: When disabling parity checking, also disable disconnects for that adapter since you cannot disable parity checking for reselection. If a device does not generate parity, and it disconnects, the I/O will never complete. Option Syntax: /PARITY=n[,n]* n = ON | OFF For example, to turn off parity checking on the first host adapter (boot order designation = 0), the line in your CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /PARITY=OFF<0> ********** Using the /SYNCH_RATE (or /SR) Option ********* This option sets the maximum synchronous transfer rate (in mega-transfers per second) to negotiate with a particular device. The allowable values are 0, 5, 10, 20, 40, 80 and 160 providing the host adapter is capable of the specified speed. Specify 0 (zero) to turn off synchronous transfers for a particular device. The default value is the fastest rate supported by your host adapter. Option Syntax: /SYNCH_RATE=n[,n]* n = 0 | 5 | 10 | 20 | 40 | 80 | 160 For example, to turn off synchronous transfers to the device attached to the first host adapter (boot order designation = 0) at SCSI ID 3, the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /SYNCH_RATE=0<0:3> Note: When executing synchronous transfers using an 8-bit SCSI bus, mega bytes per second = mega transfers per second. Also, when you are doing synchronous transfers using a 16-bit SCSI bus, mega bytes per second = 2 * mega transfers per second. ********** Using the /SYNCH_OFFSET (or /SO) Option ********* This option sets the maximum synchronous offset in bytes used to negotiate with a particular device. The maximum allowable values are 0, 8, 16, 31, 62 and 127 provided the host adapter is capable of the specified offset. Specify 0 (zero) to turn off synchronous transfers for a particular device. The default value is the fastest rate supported by your host adapter. Option Syntax: /SYNCH_OFFSET=n[,n]* n = 0 | 8 | 16 | 31 | 62 | 127 For example, to turn off synchronous transfers to the device attached to the first host adapter (boot order designation = 0) at SCSI ID 3, the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /SYNCH_OFFSET=0<0:3> ********* Using the /SBN Option ********* This option tells the host adapter to enable Single Bit Negotiation (SBN). SBN is used to enable communication with certain SAF-TE processors. To communicate with these SAF-TE processors, enable SBN and send commands to the device by using the Adapter's SCSI ID for the Target's ID. Option Syntax: /SBN=n n = ON | OFF For example, to enable SBN on the first host adapter (boot order designation = 0), the line in your CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /SBN=OFF<0> ********* Using the /TIMEOUT (or /T) Option ********* The ASPIMPT.SYS driver uses a time-out mechanism to detect certain errors. When the driver issues a command to a SCSI device, a timer is started. If the timer expires before the command completes, the driver assumes something has gone wrong, and takes steps to recover. The default for this option is 10 seconds, if the device is BIOS controlled. If the device is not BIOS controlled, the default is 0. Also, non-volatile memory settings can alter these defaults. The maximum setting is 0, which is no time-out. The range of allowable values is 0-65535 seconds. Option Syntax: /TIMEOUT=n[,n]* n = 0-65535 For example, you might have a particularly slow device (with SCSI ID 3) on the first host adapter (boot order designation = 0). If you wish to extend the time-out for this device to 60 seconds, the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /TIMEOUT=60<0:3> ********* Using the /VERBOSE (or /V) Option ********* This option causes more detailed information to appear on your monitor, after the ASPIMPT.SYS driver is initialized, during a system boot. For example, the following may be displayed after using the /VERBOSE or /V option: LSI53C1030 Rev 0 at PCI ID 0030, Bus 0, Dev/Func 0x69, CMD=0x0117 This option is useful if you have multiple adapters in the system and need to know the PCI Device ID, the PCI Bus number, and the PCI Device/Function number for each adapter. This information is required to use the /EXCLUDE option already described in this section. Option Syntax: /VERBOSE For example, to see more detailed adapter information displayed when you boot, the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /VERBOSE ********* Using the /WIDTH (or /W) Option ********** The width parameter defines the maximum data width negotiated with a device. This option is used with host adapters capable of 16-bit data transfers. Valid settings are 8 or 16. Option Syntax: /WIDTH=n[,n]* n = 8 | 16 For example, if your first host adapter (boot order designation = 0) is a 16-bit adapter, and you wish to force 8-bit transfers to a device at SCSI ID 2, the line in the CONFIG.SYS file that loads ASPIMPT.SYS should look like this: DEVICE=C:[PATH]ASPIMPT.SYS /WIDTH=8<0:2> 4.0 Unattended Mode ____________________ N/A 5.0 Web information and support phone number _____________________________________________ 5.1 IBM Support Web Site: http://www.ibm.com/support/. You can receive hardware service through IBM Services or through your IBM reseller, if your reseller is authorized by IBM to provide warranty service. See http://www.ibm.com/planetwide/ for support telephone numbers, or in the U.S. and Canada, call 1-800-IBM-SERV (1-800-426-7378). In the U.S. and Canada, hardware service and support is available 24 hours a day, 7 days a week. In the U.K., these services are available Monday through Friday, from 9 a.m. to 6 p.m. 5.2 IBM eserver xSeries Web Site: http://www.ibm.com/eserver/xseries 5.3 If you have any questions about this update, or problems applying the update, go to the following Help Center World Telephone Numbers and URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html. 6.0 Notices and trademarks ___________________________ 6.1 The following terms are trademarks of the IBM Corporation in the United States, or other countries or both: * IBM Other company, product, and service names may be trademarks or service marks of others. 7.0 Disclaimer _______________ 7.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. S 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. HTS.