SCSIMODE User's Guide Document Number 1.0 May 2, 1995 Contents Getting Started . . . . . . . . . . . . . . . . . . . . 1 Introduction . . . . . . . . . . . . . . . . . . . . 1 Requirements . . . . . . . . . . . . . . . . . . . . 1 The SCSIMODE Package . . . . . . . . . . . . . . . . 2 Installation . . . . . . . . . . . . . . . . . . . . 2 Hardware Installation . . . . . . . . . . . . . . . 2 ASPI Manager Installation . . . . . . . . . . . . . 3 Working With IBM Storage Systems Division Hard Drives . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Using SCSIMODE . . . . . . . . . . . . . . . . . . . . . 4 Starting SCSIMODE . . . . . . . . . . . . . . . . . . 4 Using The Interface . . . . . . . . . . . . . . . . . 4 Main Screen . . . . . . . . . . . . . . . . . . . . . 5 Start/Stop Unit . . . . . . . . . . . . . . . . . . . 6 Request Sense . . . . . . . . . . . . . . . . . . . . 7 Inquiry . . . . . . . . . . . . . . . . . . . . . . . 7 Test Unit Ready . . . . . . . . . . . . . . . . . . . 7 Read Capacity . . . . . . . . . . . . . . . . . . . . 8 Mode Sense/Select . . . . . . . . . . . . . . . . . . 9 Diagnostics . . . . . . . . . . . . . . . . . . . . . 10 Tables 1. Various keys and their actions. . . . . . . . . . . 5 2. Main Menu Options . . . . . . . . . . . . . . . . . 6 ii SCSIMODE User's Guide Getting Started ______________________________________________________ Introduction The SCSI architecture allows a variety of devices to coexist on a SCSI bus, linked to the host computer with an adapter. The Adaptec SCSI card provides a standard hardware interface which supports major types of SCSI peripherals. The Advanced SCSI Programming Interface (ASPI) provides a protocol for SCSI device drivers and programs to submit I/O requests to host computer systems. The ASPI manages host adapter resources and provides the hardware independent ASPI for SCSI application and device drivers. Installation of different adapters to the system differs between operating systems. SCSIMODE is a hardware/software interface that allows the user in the field to change SCSI mode parameters and perform basic SCSI functions on the IBM SCSI disk drives. The following drives are supported:  0661 (Lightning/Turbo)  0663 (Corsair I/Corsair II)  0663E (Corsair II Enhanced)  0664 (Allicat S10/Allicat S20)  0662 (Spitfire)  DFHS/DFMS (Starfire) SCSI drives other than the ones listed above can also be used. They will be recognized by the program as "Generic" drives. The mode parameters on generic drives may not correspond to the supported drives. _____________________________________________________ Requirements  IBM PC/XT/AT/PS2 compatible computer with at least 640K RAM.  A SCSI controller with ASPI support or an IBM SCSI Adapter.  The disk drive that needs to be updated. Getting Started 1  Controlled 5/12 volt power supply. If the hard drive is installed in the PC, the PC power supply can be used.  SCSIMODE Package _____________________________________________________ The SCSIMODE Package The SCSIMODE package has all the necessary files on it for updating the microcode and dumping error logs on the drive. A brief description of these files is given. SCSIMODE.EXE The executable form of the SCSIMODE program. SCSIMODE.OPT Contains user specified parameters. SCSIMODE.HLP Contains SCSIMODE help text. SCSIMODE.TXT This documentation. SMLEGAL.TXT Legal documentation and disclaimer. _____________________________________________________ Installation _____________________________________________________ Hardware Installation This section contains information pertaining to the installation of an Adaptec 1542B SCSI controller card. Refer to the documentation provided with the SCSI controller you are using for installation instructions and further details. The Adaptec card should be correctly configured and installed in the computer slot per the instructions given in the Adaptec card user's manual. Note: The Adaptec 1542B card requires special EPROMS to function properly with IBM drives. The correct microcode for the EPROMS can be obtained from the Adaptec BBS ((408)945-7727) or from your local Adaptec representative. 2 SCSIMODE User's Guide _____________________________________________________ ASPI Manager Installation The ASPI (Advanced SCSI Programming Interface) Manager must be installed before using SCSIMODE. Most SCSI card manufacturers, including Adaptec, Bus Logic support an ASPI Manager. Refer to the documentation that came with your card to confirm that the ASPI manager is installed correctly. _____________________________________________________ Working With IBM Storage Systems Division Hard Drives IBM drives should only be handled in an ESD safe environment and connected to the Adaptec card in the following manner 1. Turn the power supply off. 2. Plug the SCSI cable from the Adaptec card into the 50-pin or 68-pin SCSI connector on the hard drive. 3. Plug the power cable into the 4-pin power connector on the hard drive. 4. Turn the power supply on. Using Code Update 3 Using SCSIMODE _____________________________________________________ Starting SCSIMODE Insert the diskette containing the SCSIMODE program into the floppy drive and make that drive the current drive. Execute SCSIMODE.EXE. _____________________________________________________ Using The Interface SCSIMODE provides the user with a consistent, easy-to-use interface. The user first provides SCSIMODE information about the operation to perform and then requests that SCSIMODE perform that operation through the use of the function keys. In this way, SCSIMODE avoids unexpectedly performing an action without the user's permission. The user describes the parameters of an operation through the use of three types of display elements  Menus  Numeric and Text Entry Fields  Toggle Items Menus are boxes which display two or more items from which the user can choose. The highlighted item indicates the currently selected item. The cursor keys change the selected item. Numeric and text entry fields allow the user to enter numbers and text, respectively. In these fields, the user can use the cursor keys to change the cursor position or the insert key to toggle the insert mode. Pressing the backspace and delete keys remove characters. Holding the control and the pressing the backspace key deletes the entire entry. Hexadecimal values can be entered into a numeric entry field by preceding the number with"0x." Toggle items are single words or phrases which are usually YES/NO or 1/0 questions. These items can be changed by pressing the space bar on them. At any given time there is only one screen item accepting input. This active item is highlighted to distinguish it from the inactive items. Pressing the tab and shift-tab keys changes the active item. It is also possible to move between fields using the cursor keys, but not as convenient as the tab keys. For example, moving between entry fields can only be done using the up and down cursor keys since the 4 SCSIMODE User's Guide left and right cursor keys only reposition the cursor in the field. The valid operations are listed across the bottom of the screen. The F2 key causes an operation to be performed and the F3 key exits the current screen. Table 1. Various keys and their actions. Key Action Tab Move cursor forwards through different fields Shift + Tab Move cursor backwards through different fields. Function Keys Choose particular action or menu option. The action keys are specified at the bottom of each screen. Cursor Keys Move highlighted bar through options. Move between fields. Enter Accept the highlighted option. Ctrl + Backspace Erase a field. 0x Enter a hex value in a field which accepts a number. _____________________________________________________ Main Screen The main screen displays the types of drives SCSIMODE has sensed are attached to the SCSI bus. An entry of "NO CONNECTION" indicates the program did not detect a drive connected to the bus at the corresponding target address. An entry of "GENERIC" means a drive was detected, but the type of drive could not be determined. SCSIMODE seldom rescans the SCSI bus. After removing or attaching drives to the SCSI bus, it is important to tell SCSIMODE to rescan the SCSI bus. This can be done from the main screen by pressing the F4 key. The main screen contains a menu of operations Code Update can perform. These operations can be selected by entering the appropriate menu number and pressing the enter key. Pressing tab to highlight the menu, pressing the cursor keys to select an operation, and then pressing the enter key has the same effect. Table 2 shows the main menu options. Using Code Update 5 Table 2. Main Menu Options # Option Explanation 1 Start/Stop Unit Start/Stop the motor driver on the disk drive. 2 Request Sense SCSI Request Sense command. 3 Inquiry SCSI Inquiry command. 4 Test Unit Ready SCSI Test Unit Ready command. 5 Read Capacity SCSI Read Capacity command. 6 Mode Sense/Select SCSI Mode Sense/Select command. 7 Diagnostic SCSI Send/Receive Diagnostics commands. Pressing F3 ends the SCSIMODE program . Pressing F4 tells SCSIMODE to rescan the SCSI bus. Pressing F10 causes the system to go to a DOS shell from which DOS commands can be entered. Entering Exit from the DOS shell will return control of the system back to SCSIMODE. _____________________________________________________ Start/Stop Unit Code Update can perform a SCSI Start/Stop Unit command. The options are as follows: Target ID SCSI ID of the drive. Start A "YES" in this field indicates that the motor of the selected target is to be started. A "NO" in this field indicates that the motor of the selected target is to be stopped. Immediate When this field is set to "YES", the drive returns a good status to the system immediately. When this field is set to "NO", the drive waits until the operation has completed. 6 SCSIMODE User's Guide _____________________________________________________ Request Sense Code Update can perform a SCSI request sense command. The options are as follows Target ID SCSI ID of the drive. Length The number of sense bytes to return. IBM 066x family drives define only the first 32 bytes, but lengths from 0 to 255 bytes are valid. _____________________________________________________ Inquiry Code Update can perform a SCSI inquiry command. The options are as follows: Target ID SCSI ID of the drive. EVPD "Enable Vital Product Data". Setting this field to "YES" indicates that the "Page Code" field is to be used. Setting this field to "NO" indicates that the "Page Code" field will not be used. Page selects the page to return. Length indicates the number of bytes to return. Using Code Update 7 ____________________________________________________ Test Unit Ready Code Update can perform a SCSI test unit ready command. This command only requires a SCSI target ID. _____________________________________________________ Read Capacity Code Update can perform a SCSI read capacity command. This command returns the block size and total number of blocks a drive is currently formatted to. The options are as follows: Target ID SCSI ID of the drive. PMI "Partial Medium Indicator" This field when set to "OFF" indicates that the capacity of the entire drive is to be returned. When this field is set to "ON", the last LBA on the cylinder the LBA in the "LBA" field indicates. LBA is the LBA to be used when the "PMI" bit is set "ON" 8 SCSIMODE User's Guide _____________________________________________________ Mode Sense/Select Code Update integrates the mode sense and mode select SCSI commands to provide a quick means of examining the mode pages' settings and modifying them. To use the "Mode Sense/Select" operations, first choose the "Mode Sense/Select" operation from the main menu and press Enter. Next select the appropriate page by keying in the appropriate hex digit (use the "/" character for the header) or by pressing tab and then using the cursor keys to select the menu item. At this point, two prompts will be displayed: Target ID SCSI ID of the drive. Current Values/ Default Values / Saved Values This option refers to which of the mode parameters are to be reported. "Current Values" indicates that the mode parameters the drive is presently using should be reported. "Default Values" indicates that the default values are to be reported. Selecting "Saved Values" means that the mode parameters saved and used when the drive is first started will be reported. Pressing F2 will sense the values for the selected target and page. Refer to the product SCSI specification for details about the specific page parameters. At this point modifiable parameters can be changed or the page can be sensed again by pressing F2. After a page has been sensed, it is now possible to select the page by pressing F4. Code Update will ask if the parameters are to be saved or are only to be used as the current values. Pressing F2 selects the page and F3 aborts the select operation. Using Code Update 9 ___________________________________________________ Diagnostics Code Update can perform a SCSI send diagnostic command. The options are as follows: Target ID SCSI ID of the drive. Self Test Setting this field to "YES" causes the drive to perform a series of self-tests. Setting this field to "NO" causes the drive to perform a translation as indicated by additional options. Translate from selects whether a LBA is translated to its corresponding physical address or vice versa. (This option only appears if Self Test is set to "NO.") If Self Test is "NO," entry fields for the physical or logical address appear, depending on what is to be translated. Note: The translate function of send diagnostic is not supported by Lightning, Turbo, and Corsair drives. 10 SCSIMODE User's Guide