README.TXT =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Micro-Code Update Utility for Tape Drives Version 1.2 (c) Copyright IBM Corporation - 1997 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= This README.TXT file contains the following information. =-=-=-=-=-=-=-=-= CONTENTS =-=-=-=-=-=-=-=-= 1. Introduction 2. Restrictions 3. System Requirements 4. Files 5. Usage Notes 6. Error Codes 7. Service Information Note: For RAID Subsystems restrictions, refer to item 3. in Section 2. =-=-=-=-=-=-=-=-=-=-=-= 1. Introduction =-=-=-=-=-=-=-=-=-=-=-= DISKETTE USE This Diskette Set supports the Microcode update process for the IBM internal 3.5" & 5.25" 4mm 4/10GB SCSI tape Drives. This update utility updates the tape drive controlling microcode only. No change or affect will be made to the system BIOS, SCSI Adapter BIOS, Operating System, or application software. Additionally, only the correct tape drive type/model will be updated. This utility is developed for DOS platform only. The product codes of the tape drives are 74G8632 (3.5" drive) and 76G8631 (5.25" drive). This utility uses the SCSI host adapter card used to connect the tape drives to the PC, to update the micro code of the tape drive for non- RAID systems. Two diskettes are supplied, one for each of the two variants of the tape drive encountered: 1. MU_TAPE4, supports only the ARCHIVE drives (with switches) 2. MU_TAPE5, supports only the CONNOR & SEAGATE drives (with jumpers) (The jumpers or switches are used to set the SCSI address, etc. and are visible from the rear of the drive). A utility is included on these diskettes to assist in identifying the drive without having to physically inspect it. Each diskette will boot DOS 6.3, and prompt the user for the type of SCSI controller to be used (RAID or non-RAID) The correct ASPI drivers will then be loaded. Since the diskette is multipurpose, multiple ASPI device drivers, supporting many IBM SCSI and RAID adapters, are supplied. Only the proper driver will load; all others will generate error messages, which is normal and should be ignored. Once DOS is booted & the correct driver installed, the MU_TAPE?.EXE should be run in display mode. If you know the drive type, the diskette supporting it should be used. If not, either diskette will work in display mode, as: C:>MU_TAPE? /d where ? is either 4 or 5 The exec will return the adapter information & pause for the operator. The next screen will contain the drive identification. NOTE: The original drive firmware was never updated to reduce possibility of errors. Accordingly, the information returned by the /d display option will always indicate an ARCHIVE drive in the Vendor Identification field. The correct indicator is the Product Revision Level field, which will return the current microcode level ( starting with 4 for drives with switches & 5 for drives with jumpers ). The microcode succession from older to newer is as follows: ARCHIVE drives (with switches) 4.75 - 4.AC - 4.AP - 4.BK - 4BKA - 4BKC CONNOR & SEAGATE drives (with jumpers) 5.50 - 5.77 - 5AJ Note that regardless of the level found on the drive, the most current level will be installed. =-=-=-=-=-=-=-=-=-=-=-=-=-= 2. Restrictions =-=-=-=-=-=-=-=-=-=-=-=-=-= The known restrictions of the utility are listed below. 1. DOS versions above 6.3 will give, Error : MTAPE-302 File Not found : V4???-42.BIN even if the file V4BK-42.BIN is supplied along with the utility. Please use DOS version 6.3 or below. 2. The IBM-FAST SCSI Adapter card by Future Domain (Patriot), with BIOS level version BELOW 3.61 will hang the system during down- loading of micro-code. See RETAIN TIP H015029 for additional information. 3. During updates of the tape drive micro code on systems which have the tape drive attached to either a PCI or a Micro Channel RAID Controller Adapter, the following error message will be received and the micro code WILL NOT be updated: Error : ATAPE-207 Error during down-loading micro-code. Target bus phase sequence failure. Due to design parameters of the RAID controllers, the tape drive firmware must be updated from the tape drive itself using a special firmware update tape cartridge, available free from the appropriate technical support center (see note below). However, the utility MU_TAPE? /D provided on this diskette will query tape drives attached to RAID controllers and provide the exact firmware level currently installed on that tape drive. With this information, the correct stand-alone Update Tape Cartridge may be ordered and used to update the tape drive firmware. Please provide the physical size of the tape drive (3.5" or 5.25" wide) to insure receiving the correct microcode update tape cartridge. =-=-=-=-=-=-=-=-=-=-=-=-=-= 3. System Requirements =-=-=-=-=-=-=-=-=-=-=-=-=-= The Micro-Code update utility is developed for DOS platform. Also this utility uses the services of the Advance SCSI Programming Interface (ASPI) Managers to handle a wide variety of SCSI host adapter cards. The minimum system requirements are: a) DOS Version 4.0 to 6.3 b) 300 kb of free memory (RAM) (This can be checked with DOS command MEM) c) Properly configured and terminated SCSI sub-system with Tape drive attached. d) ASPI Managers for DOS supplied with SCSI host adapter card or the utility diskette An example of the config.sys file having ASPI Managers: DEVICE=IBMRAID.SYS DEVICE=IBMASPI.SYS The above two lines are for the RAID card controlled by ASPI Manager. The actual device driver names depend upon the Host Adapter. =-=-=-=-=-=-= 4. Files =-=-=-=-=-=-= This section gives information on the files supplied along with the utility. The files supplied include micro-code files, the Micro-Code update utility and the readme.txt file. The complete list of the files is shown below. Diskette # 1 Contains: a) README.TXT (This file) b) MU_Tape4.EXE (Micro-Code update utility) c) V4BKC-42.BIN (Micro-Code for 3.5" ARCHIVE drives) d) V4BKC-47.BIN (Micro-Code for 5.25" ARCHIVE drives) e) ASPI Device drivers (a long list of them) Diskette # 2 Contains: a) README.TXT (This file) b) MU_Tape5.EXE (Micro-Code update utility) c) V5AJ-42. BIN (Micro-Code for 3.5 " CONNOR/SEAGATE drives) d) V5AJ-47. BIN (Micro-Code for 5.25 " CONNOR/SEAGATE drives) e) ASPI Device drivers (a long list of them) All the above files will be supplied in zipped self-extractable files , labeled: 4MMREAD.TXT An introductory read me file 4MMDAT4.EXE for ARCHIVE Drives 4MMDAT5.EXE for CONNOR/SEAGATE drives Once you expand the self-extracting file, you will find the above files in the current directory. =-=-=-=-=-=-=-=-=-=-= 5. Usage Notes =-=-=-=-=-=-=-=-=-=-= This section gives information on how the utility is used to update the micro code of the tape drives to the latest revision, or used as a query utility to determine which firmware update tape must be ordered to update tape drives attached to any RAID controller (See Restrictions, section 2., item # 3.) The micro code utility can be invoked to give its functionally. If the user is using the utility for the first time, invoke the utility with the help option. Example : Suppose the utility is in drive A. Then type, A:\MU_TAPE? /H and press The utility then displays the usage of the utility. Other possible ways of getting the usage are, MU_Tape? /H and MU_Tape? /? The following usage information is displayed by the utility. Command Sequence : Usage : MU_Tape [Options] where [Options] include [-D|d] - Display the Tape Drive's information. Micro-Code will not be updated. [-S|s ] - The directory where Micro-Code files are present. Default is A:\ [-U|u] - Update Micro-Code for all the Tape Drives. Default is first Tape Drive encountered. [-H|h|?] - Display this help. The [-D|d] option can used to display the information on the SCSI host adapter card and the tape drives present in the system. If the [-D|d] option is given the micro code of the tape drive(s) will not be updated. The [-S|s] option is used to specify the location of the micro-code files. The specified with [-S|s] option can be a full path name or a partial path name of the directory, with respect to current directory. The [-U|u] option is used to update the micro code of all the valid tape drives present in the system. The Micro-Code update utility can handle multiple, valid tape drives connected through multiple SCSI host adapter cards also. NOTE : 1. If the Micro Code update utility is invoked without any options, it will try to down-load the latest revision of appropriate micro code from drive A: onto the first tape drive encountered in its query with the system. 2. The micro code revision supplied in the form of files is compared with the revision of micro code present in the tape drive(s). 3. If the micro code revision supplied in the form of files, is older than the revision of micro code present in the tape drive(s), the micro code will not be updated. =-=-=-=-=-=-=-=-=-=-= 6. Error Codes =-=-=-=-=-=-=-=-=-=-= This section gives all the error codes given by the Micro Code update utility. The error codes are classified into 3 categories. They are, 1. Command Line error codes. 2. ASPI communication error codes. 3. Micro-code related error codes. The error code contains the information on the error category, error value and a message string explaining the error occurred. All the above categories can be identified by the first character present in the error code. The 'Command Line' category of error codes start from 100. The 'ASPI communication' category error codes start from 200 and the 'Micro- code' category from 300. Example : CTAPE-100 The first character 'C' in CTAPE stands for Command Line error category. ATAPE-200 The first character 'A' in ATAPE stands for ASPI communication category. MTAPE-300 The first character 'M' in MTAPE stands for Micro-code files category. Now the error codes present in each category are given along with the message strings. 1. Command Line Error Codes : A) CTAPE-100 Invalid number of arguments. B) CTAPE-101 Invalid argument : . C) CTAPE-102 Invalid combination of options. D) CTAPE-103 The option : : requires an argument. E) CTAPE-104 Unknown option : . F) CTAPE-105 The option : : is specified multiple times. G) CTAPE-106 Invalid directory : 2. ASPI Communcation Error Codes : A) ATAPE-200 No ASPI Managers are present. B) ATAPE-201 Error in getting Host Adapter information. C) ATAPE-202 Error in getting Device information. Host Adapter : Device SCSI ID : D) ATAPE-203 No Tape Drives found for Adapter : E) ATAPE-204 Tape is present in the Tape Drive. F) ATAPE-205 No Valid IBM 4/10 GB Tape Drives found for Adapter : G) ATAPE-206 Hardware error. H) ATAPE-207 Error in down-loading micro-code. 3. Micro Code related Error Codes : A) MTAPE-300 Error in opening the micro-code file : B) MTAPE-301 Error in reading file : C) MTAPE-302 File not found : D) MTAPE-303 Micro code in Tape Drive is of new revision. If the utility encounters any other error which can not be identified, it displays the following error message. TAPE-000 Unknown error. =-=-=-=-=-=-=-=-=-=-=-=-=-= 7. Service Information =-=-=-=-=-=-=-=-=-=-=-=-=-= Preparing for the Call ---------------------- In order to speed up the service, please have available as much of the following information as possible. a) Computer Manufacturer and Model b) SCSI Host Adapter card information (Use this utility) c) ASPI Managers present in the system d) Hardware and software configuration of the system e) Exact wording of the error message f) Description of the problem Placing the Call to IBM ----------------------- Use one of the following numbers : Within the United States, call the Options by IBM HelpCenter at, 1-800-772-2227 Within Canada, call HelpPC at, 1-800-465-7999 Outside the United States and Canada, contact your IBM Helpware number, or your local branch office.