IBM T200F manual

Ul tri um In t ern al T a p e Dri v e M o d e ls T2 00 an d T2 00F an d 3 580 Ul tri um T a p e Dri v e SC SI R ef e re n ce WB1 109-02 [...]

[...]

Ul tri um In tern al T a p e Dri v e M o d e ls T2 00 an d T2 00F an d 3 580 Ul tri um T a p e Dri v e SC SI R ef e re n ce WB1 109-02 [...]

Note Before using this information and the product it supports, be sure to read the general information under “Appendix. Notices” on page 103. Fifth Edition (October 2001) This edition applies to the IBM ® Ultrium ™ Internal T ape Drive Models T200 and T200F and 3580 Ultrium T ape Drive SCSI Reference and to all subsequent releases and modif[...]

Contents T ables ............................ v i i Preface ............................ x i Organization .......................... x i Related Publications ....................... x i Chapter 1. Introduction ...................... 1 Supported Servers and Operating Systems ............... 3 SCSI Attachment ....................... 3 Fibre Channel A[...]

READ BUFFER ........................ 4 9 Error Log Buffer ....................... 5 1 READ POSITION ........................ 5 2 RECEIVE DIAGNOSTIC RESUL TS ................. 5 3 RELEASE UNIT ........................ 5 4 REPORT DENSITY SUPPOR T ................... 5 5 REPORT LUNs ......................... 5 8 REQUEST SENSE ....................... 5[...]

How to Send Y our Comments ................... 1 0 4 T rademarks .......................... 1 0 5 Index ............................ 1 0 7 Contents v[...]

vi Ultrium Internal T ape Drive and 3580 Ultrium T ape Drive: SCSI Reference[...]

T ables 1. Supported Common Commands ......................... 5 2. ERASE Command ............................... 6 3. INQUIRY Command .............................. 7 4. Standard Inquiry Data V alid LUN ......................... 8 5. Standard Inquiry Data Invalid LUN ......................... 9 6. Supported V ital Product Data Inquiry Page .......[...]

54. Parameter Data for a Partition List Service Action Request ............... 4 5 55. Format for Medium Auxiliary Memory Attribute .................... 4 5 56. Attribute Descriptions ............................. 4 5 57. Device Common Attributes ........................... 4 6 58. Device V endor/Serial Number Attribute ....................... 4 6 [...]

1 10. Abort Condition Handling ............................ 9 4 1 1 1. Status Codes ................................ 9 6 1 12. Supported Outbound Messages ......................... 9 8 1 13. Supported Inbound Messages .......................... 9 9 1 14. Supported Extended Messages ......................... 1 0 0 T ables ix[...]

x Ultrium Internal T ape Drive and 3580 Ultrium T ape Drive: SCSI Reference[...]

Preface This publication contains information about how to use and program the IBM Ultrium Internal T ape Drive Models T200 and T200F and the IBM 3580 Ultrium T ape Drive. Organization The information in this book is organized as follows: v “ Chapter 1. Introduction ” on page 1 describes the tape drives. v “ Chapter 2. Command Support ” on [...]

v SCSI Stream Commands-2 (SSC-2) , published by the American National Standards Institute and available on the web at http://www.t10.org . v SCSI Primary Commands-2 (SPC-2) , published by the American National Standards Institute and available on the web at http://www.t10.org . v SCSI Primary Commands-3 (SPC-3) , published by the American National [...]

Chapter 1. Introduction The IBM Ultrium Internal T ape Drive Models T200 and T200F and the IBM 3580 Ultrium T ape Drive are high-performance, high-capacity data-storage devices that connect to and provide additional storage for supported servers. The Model T200 uses a Small Computer Systems Interface (SCSI) and the Model T200F uses a Fibre Channel [...]

Designed to perform unattended backups as well as to retrieve and archive files, the Ultrium Internal T ape Drives feature: v Native storage capacity of 100 GB per cartridge (200 GB at 2:1 compression) 1 v Native sustained data transfer rate of 15 MB per second (30 MB at 2:1 compression) 2 v RS-422 interface for enhanced performance in automated ta[...]

Supported Servers and Operating Systems The IBM Ultrium Internal T ape Drive Models T200 and T200F and the IBM 3580 Ultrium T ape Drive are supported by a wide variety of servers and operating systems, as well as adapters. These attachments can change throughout the products ’ life cycles. T o determine the latest supported attachments: v For the[...]

Supported Device Drivers IBM maintains the latest levels of device drivers and driver documentation for the 3580 Ultrium T ape Drive on the Internet. Y ou can access this material from your browser or through the IBM FTP site by doing the following: Note: If you do not have Internet access and you need information about device drivers, contact your[...]

Chapter 2. Command Support Notes: 1. For this chapter , a megabyte (MB) is equal to 1 048 576 bytes. 2. Binary numbers are represented by numbers followed by b . Hexadecimal numbers are represented by 0 - 9 and A - F followed by h . Numbers with no suffix can be assumed to be decimal. T able 1. Supported Common Commands Command Name Operation Code [...]

T able 1. Supported Common Commands (continued) Command Name Operation Code SCSI Class 1 SCSI Spec 2 Page Applicable Conditions 3 RVC UA T NRD WRP MFC DCC WRITE A TTRIBUTE 8Dh O SPC-3 84 yyyy - y WRITE BUFFER 3Bh O SPC-2 83 y y ---- WRITE FILE MARKS 10h M SSC 86 yyyyyy Note 1: O=optional M=mandatory Note 2: SCSI specifications are as follows: v SSC[...]

INQUIR Y T able 3. INQUIR Y Command 76543210 0 Operation Code (12h) 1 Logical Unit Number (0) Reserved EVPD 2 Page Code 3 Reserved 4 Allocation Length 5 Control The INQUIRY command instructs the drive to return data about itself to the initiator . If the Enable Vital Product Data (EVPD) flag is clear and the Page Code is 0, standard Inquiry Data is[...]

Standard Inquiry Data V alid LUN T able 4. Standard Inquiry Data Valid LUN 76543210 0 Peripheral Qualifier (000b) Peripheral Device T ype (01h) 1 RMB(1) Device-type modifier (0) 2 ISO version (0) ECMA version (0) V ersion (3) 3 AENC(0) Obsolete NACA(0) HiSup(0) Response Data Format (2) 4 Additional length (33) 5 Reserved 6 BQue(0) EncSrv(0) VS(0) M[...]

Standard Inquiry Data Invalid LUN T able 5. Standard Inquiry Data Invalid LUN 76543210 0 Peripheral Qualifier (01 1b) Peripheral Device T ype (1Fh) 1 RMB(0) Device-type modifier (0) 2 ISO version (0) ECMA version (0) V ersion (3) 3 AENC(0) Obsolete NACA(0) HiSup(0) Response Data Format (2) 4 Additional length (21) 5 Reserved 6 BQue(0) EncSrv(0) VS([...]

Supported V ital Product Data Page T able 6. Supported Vital Product Data Inquiry Page 76543210 0 Peripheral Qualifier (000b) Peripheral Device T ype (01h) 1 Page Code (00h) 2 Reserved 3 Page Length (6h) 4 Supported Vital Product Data Page Code (00h) 5 V endor-Unique Page Code (03h) 6 Unit Serial Number Page Code (80h) 7 Device Identification Page [...]

Device Identification Page T able 8. Device Identification Inquiry Page 76543210 0 Peripheral Qualifier (000b) Peripheral Device T ype (01h) 1 Page Code (83h) 2 Reserved 3 Page Length (n-3) 4 : n Identification Descriptors The device Identification Descriptor Page contains a series of device Identification Descriptors that uniquely identify the par[...]

The Fibre Channel Identification descriptor is returned only on Fibre-Channel- attached devices. The format is given in T able 10. T able 10. Fibre Channel Identification Descriptor 76543210 0 Reserved Code Set (1h) 1 Reserved Association T ype ( 00b) Identifier T ype (3h) 2 Reserved 3 Identifier Length (8) 4 Name Format (0101b) OUI Format Identifi[...]

Drive Component Revision Levels Pages T able 1 1. Drive Component Revision Levels Pages 76543210 0 Peripheral Qualifier (000b) Peripheral Device T ype (01h) 1 Page Code (C0h) 2 Reserved 3 Page Length (27h) 4 : 15 Component (CCCCCCCCCCCC) 16 : 22 V ersion (RRR.VVV) 23 : 30 Date (YYYYMMDD) 31 : 42 V ariant (XXXXXXXXXXXX) The Drive Component Revision [...]

LOAD/UNLOAD T able 12. LOAD/UNLOAD Command 76543210 0 Operation Code (1Bh) 1 Logical Unit Number (0) Reserved Immed 2 Reserved 3 Reserved 4 Reserved EOT(0) Reten(0) Load 5 Control If the Load flag is set and there is a tape in the drive, it is positioned to BOM. If the Load flag is set and there is no tape in the drive, Check Condition status is re[...]

LOCA TE The LOCA TE command causes the logical position on tape to be set to the value indicated by the Block Address field. The value indicates the total number of records and marks between BOM and the desired logical position. A value of 0 causes the tape to be positioned at BOM. If the Immediate (Immed) flag is set to 1, then the drive validates[...]

LOG SELECT T able 14. LOG SELECT Command 76543210 0 Operation Code (4Ch) 1 Logical Unit Number (0) Reserved PCR SP(0) 2 PC Reserved 3 Reserved 4 Reserved 5 Reserved 6 Reserved 7 Parameter List Length 8 9 Control The LOG SELECT command causes log data on the drive to be reset to its default value or to be set to an initiator-specific value. If the P[...]

LOG SENSE T able 15. LOG SENSE Command 76543210 0 Operation Code (4Dh) 1 Logical Unit Number (0) Reserved PPC(0) SP(0) 2 PC Page Code 3 Reserved 4 Reserved 5 Parameter Pointer (0) 6 7 Allocation Length 8 9 Control The LOG SENSE command causes log data to be sent to the initiator . If the Page Control (PC) field is 00b or 10b, the maximum value for [...]

Log Page Format All log pages (except page 0) consist of a log page header , followed by a number of log parameters. The log page header has the format indicated in T able 16. T able 16. Log Page Header Format 76543210 0 Reserved Page Code 1 Reserved 2 Page Length 3 The Page Code is a byte value that uniquely identifies what log page is being retur[...]

Supported Log Pages The Supported Log Pages Log Page code is 00h. The parameter list contains a series of 1-byte entries for the log pages that are supported. At least those logs described in this document must be listed. Any additional logs that are supported must also be listed. The format of this page is give in T able 18. T able 18. Supported L[...]

W rite Error Counters Log The Write Error Counters log is page 02h. Parameters 0 through 2 are not supported and are returned as 0. All parameter lengths are 4 bytes long, except parameter 8000 which is 8 bytes long. The supported fields are listed in T able 19. T able 19. Write Error Log Parameters Parameter Definition Description DU LP LBIN 0 Err[...]

Read Error Counters Log The Read Error Counters log is page 03h. Parameters 0 through 2 are not supported and are returned as 0. All parameter lengths are 4 bytes long, except parameter 8000 which is 8 bytes long. The supported fields are listed in T able 20. T able 20. Read Error Log Parameters Parameter Definition Description DU LP LBIN 0 Errors [...]

Sequential Access Device Log The Sequential Access Device Log Page is 0Ch. T able 21. Sequential Access Device Log Parameters Parameter Description Length DU LP LBIN 0h Write Data Bytes Received, before compression 8000 1h Write Data Bytes Received, after compression 8000 2h Read Data Bytes Sent, before compression 8000 3h Read Data Bytes Sent, aft[...]

T apeAlert Log The T apeAlert log page is page 2Eh. There are 64 parameters, numbered from 1 through 64. Only parameters 1 through 18, 20 through 23, and 29 through 39 have definitions for tape drives without attached loaders. The remaining parameters are always 0. All parameters are 1 byte long. Each parameter is either 0 to indicate the correspon[...]

T able 22. T apeAlert Log Parameters (continued) Parameter Description T ype DU LP LBIN 38 Predictive Failure Critical 1 0 0 39 Diagnostics Required Warning 1 0 0 See the T apeAlert specification for more complete descriptions of the flags. This data can be neither written nor reset. The flags are cleared by the action of reading the log. T ape Usa[...]

Note: For this command, a megabyte is equal to 1 048 576 bytes. As an example, a value of 17487h in Parameter 3 is equal to 95 367 megabytes, which is equal to 100 000 000 000 bytes. Data Compression Log The Data Compression Log Page Code is 32h. Parameter byte fields 0 and 1 are 2 bytes long. Parameter byte fields 2 through 9 are each 4 bytes long[...]

MODE SELECT T able 26. Byte MODE SELECT Command 76543210 0 Operation Code (15h) 1 Logical Unit Number (0) PF Reserved SP(0) 2 Reserved 3 Reserved 4 Parameter List Length 5 Control T able 27. Byte MODE SELECT Command 76543210 0 Operation Code (55h) 1 Logical Unit Number (0) PF Reserved SP(0) 2 Reserved 3 Reserved 4 Reserved 5 Reserved 6 Reserved 7 P[...]

MODE SENSE Both the 10-byte and the 6-byte versions of the command are supported. T able 28. Byte MODE SENSE Command 76543210 0 Operation Code (1Ah) 1 Logical Unit Number (0) Reserved DBD Reserved 2 PC Page Code 3 Reserved 4 Allocation Length 5 Control T able 29. Byte MODE SENSE Command 76543210 0 Operation Code (5Ah) 1 Logical Unit Number (0) Rese[...]

Mode Data Format Mode data returned by a MODE SENSE command or sent with a MODE SELECT command consists of a Mode Parameter Header , an optional Mode Block Descriptor , and zero or more Mode Parameter Pages. T able 30. Mode Data Format 76543210 0 : 3 Mode Parameter Header 4 : 11 Mode Block Descriptor 12 : n Mode Parameter Pages Mode Parameter Heade[...]

If the Buffered Mode is 0, then the drive does not report Good status on WRITE and WRITE FILE MARKS commands until the data is written to tape. If Buffered Mode is 1, then the drive reports Good status as soon as data has been transferred into the drive ’ s data buffer . The default value is 1. The Speed field is not used and should be set to 0. [...]

Read-W rite Error Recovery Page T able 34. Read-Write Error Recovery Page 76543210 0 PS (0) Reserved Page Code (01h) 1 Additional Page Length (0Ah) 2 Reserved TB (0) Reserved EER(1) PER DTE(0) DCR(0) 3 Read Retry Count (FFh) 4 Reserved 5 Reserved 6 Reserved 7 Reserved 8 Write Retry Count (FFh) 9 Reserved 10 Reserved 1 1 Reserved The only supported [...]

The Maximum Burst Size field for the SCSI parallel interface indicates (in multiples of 512 bytes) the number of bytes that the drive should attempt to send or receive between disconnects. The default is 0, which implies that the drive may send bursts of data at any size. The Maximum Burst Size field for the Fibre Channel interface indicates the se[...]

Sequential Access Device Configuration Page The Write Delay T ime field indicates the time (in 100-ms increments) that the drive should wait with unwritten data in the buffer and no activity on the interface before forcing data to tape. The Change Active Partition (CAP) flag and the Active Partition field should be 0, since multiple partitions are [...]

The Enable EOD Generation flag should be set, since EOD generation is always enabled. The Buffer Size at Early W arning field should be 0, as this cannot be set. The default value for the Select Data Compression Algorithm is 1 and indicates that data compression is enabled. If Select Data Compression Algorithm is 0, the drive uses Scheme 2 of the L[...]

Fibre Channel Port Control Page There is one copy of this page per Fibre Channel port. This page is defined for Fibre-Channel-attached devices only . T able 39. Fibre Channel Port Control Page 76543210 0 PS (0) Reserved Page Code (19h) 1 Page Length (0Eh) 2 Reserved 3 DTFD (0) PLPB (0) DDIS (0) DLM (0) RHA (0) AL WI (0) DTIPE (0) DTOLI (0) 4 : 5 Re[...]

Information Exceptions Mode Page T able 40. Information Exceptions Mode Page 76543210 0 PS (0) Reserved Page Code (1Ch) 1 Page Length (0A) 2 Perf (0) Reserved DExcept T est Reserved LogErr(0) 3 Reserved MRIE (3) 4 : 7 Interval T imer (0) 8 : 11 Report Count (0) The Information Exceptions mode page is used to control Exception Reporting by using the[...]

PERSISTENT RESER VE IN T able 41. PERSISTENT RESERVE IN Command 76543210 0 Operation Code (5Eh) 1 Reserved Service Action 2 Reserved 3 Reserved 4 Reserved 5 Reserved 6 Reserved 7 : 8 Allocation Length 9 Control The PERSISTENT RESER VE IN command is used for reservation management to show what types of Reservations and Reservation Keys exist. Servic[...]

The PERSISTENT RESER VE IN parameter data for Read Keys is defined in T able 42. T able 42. PERSISTENT RESERVE IN Parameter Data for Read Keys 76543210 0 : 3 Generation 4 : 7 Additional Length 8 : 15 First Reservation Key 16 : n Additional Reservation Keys Generation is a counter for PERSISTENT RESER VE OUT command requests. Additional Length is a [...]

Reservation Descriptors are defined in T able 44. The PERSISTENT RESER VE IN Read Reservations Descriptor is defined in T able 44. T able 44. PERSISTENT RESERVE IN Read Reservations Descriptor 76543210 0 : 7 Reservation Key 8 : 11 Scope-specific address (0) 12 Reserved 13 Scope (0h) T ype 14 : 15 Extent Length (0) A Scope value of 0h indicates that[...]

PERSISTENT RESER VE OUT T able 45. PERSISTENT RESERVE OUT Command 76543210 0 Operation Code (5Fh) 1 Reserved Service Action 2 Scope ( 0) T ype 3 Reserved 4 Reserved 5 Reserved 6 Reserved 7 : 8 Parameter List Length (18h) 9 Control The PERSISTENT RESER VE OUT command is used for reservation management to allow different types of Reservations and Res[...]

The PERSISTENT RESER VE OUT parameter list is defined in T able 46. T able 46. PERSISTENT RESERVE OUT Parameter List 76543210 0 : 7 Reservation Key 8 : 15 Service Action Reservation Key 16 : 19 Scope-specific Address (0) 20 Reserved APTPL (0) 21 Reserved 22 : 23 Obsolete (0) Any value is allowed for the Reservation Key and the Service Action Reserv[...]

PREVENT/ALLOW MEDIUM REMOV AL T able 47. PREVENT/ALLOW MEDIUM REMOV AL Command 76543210 0 Operation Code (1Eh) 1 Logical Unit Number (0) Reserved 2 Reserved 3 Reserved 4 Reserved Prevent 5 Control The PREVENT/ALLOW MEDIUM REMOV AL command is used to prevent accidental removal of the medium while it is required by an initiator . If the Prevent flag [...]

READ T able 48. READ Command 76543210 0 Operation Code (08h) 1 Logical Unit Number (0) Reserved SILI Fixed 2 : 4 T ransfer Length 5 Control The READ command causes data to be transferred from the tape medium to the initiator . If the Fixed flag is clear and T ransfer Length is not 0, then a single block of the length in T ransfer Length is to be tr[...]

READ A TTRIBUTE T able 49. READ A TTRIBUTE Command 76543210 0 Operation Code (8Ch) 1 Reserved (0) Service Action 2 : 3 Reserved 4 Reserved 5 V olume Number (0) 6 Reserved 7 Partition Number (0) 8 : 9 First Attribute ID 10 : 13 Allocation Length 14 Reserved 15 Control Until the SCSI Primary Commands-3 (SPC-3) is published, refer to SCSI proposal T10[...]

T able 51. Parameter Data for an Attribute V alues Service Action Request 76543210 0 : 3 Available Data (n-3) 4 : x Attribute #1 m : n Attribute #y T able 52 describes the format of the data returned for an Attribute List service action request. T able 52. Parameter Data for an Attribute List Service Action Request 76543210 0 : 3 Available Data (n-[...]

T able 54 describes the format of the data returned for a Partition List service action request. T able 54. Parameter Data for a Partition List Service Action Request 76543210 0 : 1 Available Data (2) 2 First Partition Number (0) 3 Number of Partitions Available (1) Medium Auxiliary Memory Attribute Data The Medium Auxiliary Memory Attribute data i[...]

T able 57 describes Device Common attributes. All Device Common attributes are read only . T able 57. Device Common Attributes ID Attribute Name Number of Bytes Format 0000h Remaining Capacity in Partition 8 Binary 0001h Maximum Capacity in Partition 8 Binary 0002h T apeAlert Flags 8 Binary 0003h Load Count 8 Binary 0004h MAM Space Remaining 8 Bina[...]

T able 59 describes the Medium Common Attributes. T able 59. Medium Common Attributes ID Attribute Name Number of Bytes Format 0400h Medium Manufacturer 8 ASCII 0401h Medium Serial Number 32 ASCII 0402h Medium Length 4 Binary 0403h Medium Width 4 Binary 0404h Assigning Organization 8 ASCII 0405h Medium Density Code 1 Binary 0406h Medium Manufacture[...]

READ BLOCK LIMITS T able 61. READ BLOCK LIMITS Command 76543210 0 Operation Code (05h) 1 Logical Unit Number (0) Reserved 2 Reserved 3 Reserved 4 Reserved 5 Control The READ BLOCK LIMITS command requests that the drive return the maximum and minimum block sizes that it supports. The maximum block size is set to 0xFFFFFF and the minimum block size i[...]

READ BUFFER T able 63. READ BUFFER Command 76543210 0 Operation Code (3Ch) 1 Logical Unit Number (0) Reserved Mode 2 Buffer ID 3 : 5 Buffer Of fset 6 : 8 Allocation Length 9 Control The READ BUFFER command reads data from the memory on the drive and sends it to the initiator . Modes 000b, 010b and 01 1b are supported. If it is set to 010b, then jus[...]

T able 65. Drive Buffers Supported Buffers ID Offset Boundary Main Data 0 4 Dump Data (Read Only) 1 4 T est 2 4 VPD 3 4 Firmware 4 4 Cartridge Memory (Read Only) 5 4 Error Log (Read Only) 6 4 50 Ultrium Internal T ape Drive and 3580 Ultrium T ape Drive: SCSI Reference[...]

Error Log Buffer The error log buffer contains zero or more entries described in T able 66. T able 66. Error Log Buffer Command 76543210 0 : 3 T ime Stamp 4 Entry Number 5 Error Code 6 Fsc 1st T ext 7 8 Fsc 1st Data 9 10 Fsc 2nd T ext 11 12 Fsc 2nd Data 13 14 : 21 Cartridge Serial Number 22 : 27 EC Level 28 : 31 Hardware Level Chapter 2. Command Su[...]

READ POSITION T able 67. READ POSITION Command 76543210 0 Operation Code (34h) 1 Logical Unit Number (0) Reserved BT(0) 2 Reserved 3 Reserved 4 Reserved 5 Reserved 6 Reserved 7 Reserved 8 Reserved 9 Control The READ POSITION command returns current position information to the initiator . The data returned has the format in T able 68. T able 68. REA[...]

The First Block Location and the Last Block Location are both set to the number of blocks and file marks between BOM and current logical position. If the tape is at BOM, 0 is returned in these fields. The Beginning of Partition (BOP) flag is set if the Block Location fields are 0. The End of Partition flag is not supported and is set to 0. The Bloc[...]

RELEASE UNIT T able 70. Byte RELEASE UNIT Command 76543210 0 Operation Code (17h) 1 Logical Unit Number (0) 3rdPty Third Party Device ID (0) Element 2 Reservation Identification 3 Reserved 4 Allocation Length (0) 5 Control T able 71. Byte Release Unit Command 76543210 0 Operation Code (57h) 1 Logical Unit Number (0) 3rdPty (0) LongID (0) Reserved 2[...]

REPORT DENSITY SUPPORT T able 72. REPORT DENSITY SUPPOR T Command 76543210 0 Operation Code (44h) 1 Logical Unit Number (0) Reserved Media 2 Reserved 3 Reserved 4 Reserved 5 Reserved 6 Reserved 7 Allocation Length 8 9 Control The REPORT DENSITY SUPPOR T command returns details about the tape formats supported by the drive. The data is returned as a[...]

The header is followed by one or more REPORT DENSITY SUPPOR T descriptor blocks with the format in T able 74. T able 74. REPORT DENSITY SUPPOR T Descriptor Block 76543210 0 Primary Density Code 1 Secondary Density Code 2 WRTOK DUP(0) DEFL T Reserved 3 Reserved 4 Reserved 5 : 7 Bits per mm 8 Media Width 9 10 T racks 11 12 : 15 Capacity 16 : 23 Assig[...]

The values reported for the Ultrium format are as follows: T able 75. Density Information for L T O Formats Field Ultrium 1 Primary density code 40h Secondary density code 40h Bits per mm 4880 Media width (in tenths of mm) 127 T racks 384 Capacity (in megabytes) 95367 Assigning organization L TO-CVE Density name U-18 Description Ultrium 1/8T The Wr[...]

REPORT LUNs T able 76. REPORT LUNs Command 76543210 0 Operation Code (A0h) 1 Reserved 2 Reserved 3 Reserved 4 Reserved 5 Reserved 6 : 9 Allocation Length 10 Reserved 1 1 Control The server uses this command to retrieve information about the Logical Units that the drive supports. The allocation length is at least 16 bytes. If this is not the case, t[...]

REQUEST SENSE T able 78. REQUEST SENSE Command 76543210 0 Operation Code (03h) 1 Logical Unit Number (0) Reserved 2 Reserved 3 Reserved 4 Allocation Length 5 Control The sense data returned is described in T able 79 on page 60. Chapter 2. Command Support 59[...]

Sense Data Format T able 79. Sense Data Format 76543210 0 V alid Error Code 1 Segment Number (0) 2 File Mark EOM ILI Reserved Sense Key 3 : 6 Information 7 Additional Sense Length 8 : 11 Command Specific Information 12 Additional Sense Code 13 Additional Sense Code Qualifier 14 Field Replaceable Unit Code 15 SKSV C/D Reserved BPV Bit Pointer 16 : 1[...]

The V alid flag is set if the Information field contains valid information. The descriptions that follow serve only as an overview of sense reporting in the tape drive. This tape drive conforms to all sense field reporting, as specified in the SCSI standards. The Error Code field is set to 70h to indicate a current error that is associated with the[...]

The V olume Label Fields V alid (V olV alid) bit is set if the V olume Label being reported is valid. The V olume Label field reports the volume label if a cartridge is loaded in the drive and V olume Label Fields V alid is set. The Current Wrap reports the physical wrap of the tape. The least significant bit reflects the current physical direction[...]

RESER VE UNIT T able 80. Byte RESERVE UNIT Command 76543210 0 Operation Code (16h) 1 Logical Unit Number (0) 3rdPty(0) Third Party Device ID (0) Reserved 2 Reserved 3 Reserved 4 Reserved 5 Control T able 81. Byte Reserve Unit Command 76543210 0 Operation Code (56h) 1 Logical Unit Number (0) 3rdPty(0) Reserved LongID (0) Reserved 2 Reserved 3 Third [...]

REWIND T able 82. REWIND Command 76543210 0 Operation Code (01h) 1 Logical Unit Number (0) Reserved Immed 2 Reserved 3 Reserved 4 Reserved 5 Control The REWIND command causes the logical position to be set to BOM. If the Immediate (Immed) flag is set to 1, then the drive validates the command and waits for any previous command from any server to co[...]

SEND DIAGNOSTIC T able 83. SEND DIAGNOSTIC Command 76543210 0 Operation Code (1Dh) 1 Logical Unit Number (0) PF Reserved SelfT est DevOfL UnitOfL 2 Reserved 3 Parameter List Length 4 5 Control Self-T est For the Self-T est Diagnostic, the CDB values should be set as follows: v P F-1 v SelfT est - 1 v DevOfl - Any value allowed and ignored v UnitOfl[...]

SIM Data Structure The following data structure is used in several of the diagnostics. Its purpose is to give detailed error information about drive problems: T able 84. SIM Data Structure 76543210 0 Page Code (31h) 1 Reserved 2 Page Length (0044h) 3 4 Parameter Code (0000h) 5 6 Parameter Control (061h) 7 Parameter Length (040h) 8 Indicator (01h) 9[...]

T able 84. SIM Data Structure (continued) 76543210 42 : 45 Product ID (8000h) 46 : 48 V endor ID “ IBM ” 49 Plant of Manufacture 50 51 Product ID3 ’ - ’ 52 : 63 Serial Number 64 : 71 Device T ype//Dev SIM_MESSAGE_TYPE The SIM Message Code may be one of six values: v ’ 00 ’ =No Message v ’ 41 ’ =Device Degraded v ’ 42 ’ =Device H[...]

The Service Message may be one of four values: v ’ 1 ’ =Repair Impact is Unknown v ’ 7 ’ =Repair will Disable Access to Device Servo v ’ 9 ’ =Clean Device v ’ A ’ =Device Cleaned The Severity Code may be one of four values: v ’ 0 ’ =Service v ’ 1 ’ =Moderate v ’ 2 ’ =Serious v ’ 3 ’ =Acute MIM Data Structure The foll[...]

T able 85. MIM Data Structure (continued) 76543210 30 : 33 Error Code 34 : 39 V olume ID V olume Serial Number 40 V olume ID Flag 41 Reserved 42 : 45 Product ID (8000h) 46 : 48 V endor ID “ IBM ” 49 Plant of Manufacture 50 51 Product ID3 ’ - ’ 52 : 63 Serial Number 64 : 71 Device T ype The MIM Message Code may be one of four values: v ’ 0[...]

The Severity Code may be one of four values: v ’ 0 ’ =Service v ’ 1 ’ =Moderate - T emporary Read/Write Errors v ’ 2 ’ =Serious - Permanent Read/Write Errors v ’ 3 ’ =Acute - CM Error The V olume ID Flag may be one of four values: v ’ 0 ’ =VOLID not valid v ’ 1 ’ =VOLID valid - obtained from tape (CM) v ’ 3 ’ =VOLID vali[...]

Force Dump For the Force Dump Diagnostic, the CDB values should be set as follows: v P F-1 v SelfT est - 0 v DevOfl - Any value allowed and ignored v UnitOfl - Any value allowed and ignored v Parameter List Length - X0008 T able 86 shows the parameter data to be sent with the Force Dump diagnostic. T able 86. Force Dump Diagnostic Parameter Data 76[...]

W rite Dump T o Cartridge T able 87. Write Dump to Cartridge Send Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (0004h) 3 4 Diagnostic ID (0161h) 5 6 Flags (0000000b) Cartridge Required (1b) 7 Reserved T able 88. Write Dump to Cartridge Receive Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Le[...]

Post A Self T est Diagnostic T able 89. Post A Self T est Send Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (0004h) 3 4 Diagnostic ID (0100h) 5 6 Flags (0000000b) Cartridge Required (bx) 7 Reserved T able 90. Post A Self T est Receive Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (000[...]

Post B T ape T est Diagnostic T able 91. Post B T ape T est Send Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (0004h) 3 4 Diagnostic ID (0101h) 5 6 Flags (0000000b) Cartridge Required (1b) 7 Reserved T able 92. Post B T ape T est Receive Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length ([...]

Post C Media T est Diagnostic T able 93. Post C Media T est Send Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (0004h) 3 4 Diagnostic ID (0102h) 5 6 Flags (0000000b) Cartridge Required (1b) 7 Reserved T able 94. Post C Media T est Receive Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length ([...]

Post D Head T est Diagnostic T able 95. Post D Head T est Send Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (0004h) 3 4 Diagnostic ID (0103h) 5 6 Flags (0000000b) Cartridge Required (1b) 7 Reserved T able 96. Post D Head T est Receive Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserved 2 Page Length (004[...]

Set T raps For the Set T raps Diagnostic, the CDB values should be set as follows: v P F-1 v SelfT est - 0 v DevOfl - Any value allowed and ignored v UnitOfl - Any value allowed and ignored v Parameter List Length - X000A T able 97 shows the parameter data to be sent with the Set T raps diagnostic. T able 97. Set T raps Diagnostic Parameter Data 76[...]

Remove T raps For the Remove T raps Diagnostic, the CDB values should be set as follows: v P F-1 v SelfT est - 0 v DevOfl - Any value allowed and ignored v UnitOfl - Any value allowed and ignored v Parameter List Length - X000A T able 98 shows the parameter data to be sent with the Remove T raps diagnostic. If all that is desired is to inspect whic[...]

Receive Diagnostics Results - T able 99 shows the diagnostic results data returned for the Remove T raps diagnostic. T able 99. Reset Drive Diagnostic Results Data 76543 2 10 0 Page Code (80h) 1 Reserved 2 Page Length (n - 4) 3 4 Diagnostic ID (0191h) 5 6 Flags (0) 7 Reserved 8 Reserved Diagnostic Blocked Reserved Error 9 : n List of Fault Symptom [...]

Reset Drive For the Reset Drive Diagnostic, the CDB values should be set as follows: v P F-1 v SelfT est - 0 v DevOfl - 1 v UnitOfl - Any value allowed and ignored v Parameter List Length - 0008h T able 100 shows the parameter data to be sent with the Reset Drive. T able 100. Reset Drive Diagnostic Parameter Data 76543210 0 Page Code (80h) 1 Reserv[...]

SP ACE T able 101. SP ACE Command 76543210 0 Operation Code (1 1h) 1 Logical Unit Number (0) Reserved Code 2 : 4 Count 5 Control The SP ACE command instructs the drive to set a new logical position relative to the current logical position. How this is done depends on the value of the Code field and the Count field. The Count field is a signed value[...]

TEST UNIT READY T able 102. TEST UNIT READY Command 76543210 0 Operation Code (00h) 1 Logical Unit Number (0) Reserved 2 Reserved 3 Reserved 4 Reserved 5 Control The TEST UNIT READY command returns Good status if a cartridge is loaded and ready . VERIFY T able 103. VERIFY Command 76543210 0 Operation Code (13h) 1 Logical Unit Number (0) Reserved Im[...]

WRITE T able 104. WRITE Command 76543210 0 Operation Code (0Ah) 1 Logical Unit Number (0) Reserved Fixed 2 : 4 T ransfer Length 5 Control The WRITE command causes data to be transferred to the drive in a Data Out and written to tape. If the Fixed flag is clear , the initiator transfers a single block of the length indicated in T ransfer Length. If [...]

WRITE A TTRIBUTE T able 105. WRITE A TTRIBUTE Command 76543210 0 Operation Code (8Dh) 1 : 4 Reserved 5 V olume Number (0) 6 Reserved 7 Partition Number (0) 8 : 9 Reserved 10 : 13 Allocation Length 14 Reserved 15 Control Until the SCSI Primary Commands-3 (SPC-3) is published, refer to SCSI proposal T10/99-148r7 for support for the WRITE A TTRIBUTE c[...]

WRITE BUFFER T able 107. WRITE BUFFER Command 76543210 0 Operation Code (3Bh) 1 Logical Unit Number (0) Reserved Mode 2 Buffer ID 3 : 5 Buffer Of fset 6 : 8 Parameter List Length 9 Control The WRITE BUFFER command transfers data into the memory on the drive for the purpose of diagnostics, tests, or firmware upgrade. If the Mode field is 000b, then [...]

WRITE FILE MARKS The Write Set Mark (WSmk) field must be 0. Set marks are not supported. T able 108. WRITE FILE MARKS Command 76543210 0 Operation Code (10h) 1 Logical Unit Number (0) Reserved WSmk(0) Immed 2 : 4 Count 5 Control The WRITE FILE MARKS command causes a sequence of file marks to be written at the current logical position. The number of[...]

Chapter 3. Error Sense Information Sense Data For a description of Sense data, see “ Sense Data Format ” on page 60. Sense Data Management The drive maintains three types of Sense data: Current Sense The Sense data associated with the last command received from the initiator . Deferred Sense The Sense data from a command that has been reported [...]

Persistent Errors When errors occur that prevent tape operation, they are reported persistently until the problem is cleared. For medium-related errors (usually reported with a Sense Key of 3), the error is reported until the cartridge is successfully unloaded. For hardware-related errors (usually reported with a Sense Key of 4), the error is repor[...]

Chapter 4. Sense Keys and Additional Sense Note: If temporary error reporting is enabled, many combinations of the Additional Sense Code and Additional Sense Code Qualifier (ASC/ASCQ) are possible. T able 109. Sense Keys and Additional Sense Sense Key Additional Sense (ASC/ASCQ) Explanation No Sense (0h) No Additional Sense (0000h) The flags in the[...]

T able 109. Sense Keys and Additional Sense (continued) Sense Key Additional Sense (ASC/ASCQ) Explanation Medium Error (3h) Write Error (0C00h) A WRITE operation has failed. This is probably due to bad media, but may be related to hardware. Medium Error (3h) Unrecovered Read Error (1 100h) A READ operation failed. This is probably due to bad media,[...]

T able 109. Sense Keys and Additional Sense (continued) Sense Key Additional Sense (ASC/ASCQ) Explanation Illegal Request (5h) Medium Removal Prevented (5302h) An UNLOAD command has failed to eject the tape because medium removal has been prevented. Illegal Request (5h) Bad Microcode Detected (8283h) The data transferred to the drive during a firmw[...]

T able 109. Sense Keys and Additional Sense (continued) Sense Key Additional Sense (ASC/ASCQ) Explanation V olume Overflow (Dh) EOM (0002h) A WRITE or WRITE FILE MARKS command failed because the physical end of tape was encountered. A READ or SP ACE command encountered EOM. The EOM flag is set. 92 Ultrium Internal T ape Drive and 3580 Ultrium T ape[...]

Chapter 5. Attachment Features T ypes of Interface Attachments The Ultrium T ape Drive communicates with servers that use SCSI parallel or Fibre Channel interfaces. The interfaces share certain tape LUN behaviors, but also possess unique features. This chapter describes the common and unique features of both types of interfaces. Common T ape LUN Be[...]

Attention Check Condition from each initiator gets a Check Condition status, with Unit Attention sense data for the reset. However , other commands may not be processed until the internal state of the drive has been reset. Any commands that allow Disconnects and cannot be processed are accepted and queued until the drive is ready to process them. T[...]

T able 1 10. Abort Condition Handling (continued) Command Abort Processing RECEIVE DIAGNOSTIC RESUL TS None. RELEASE UNIT The command completes. REPORT DENSITY SUPPORT None. REPORT LUNs None. REQUEST SENSE Sense data is discarded. RESERVE UNIT The command completes. REWIND The command completes. SEND DIAGNOSTIC V endor unique. SP ACE The logical po[...]

Multi-initiator Support SCSI-attached drives support a maximum of two initiators on the same bus. Fibre-Channel-attached drives support a minimum of two initiators. The drive supports untagged queuing when operating with multiple initiators. If a command from one initiator is being processed when a command other than INQUIRY , REPORT LUNs, REQUEST [...]

Features of the SCSI Interface The Ultrium T ape Drive ’ s SCSI parallel interface features the following: v LUN identification v Bus parity errors v Disconnect strategy v Messages LUN Identification Identify messages are used to identify the LUN to which an initiator is connecting and to identify which LUN is reconnecting to an initiator . These[...]

Messages Message Out T able 1 12. Supported Outbound Messages Name Code Support Abort 06h An abort condition is generated (see “ Abort Handling ” on page 94). Bus Device Reset 0Ch A reset condition is generated (see “ Abort Handling ” on page 94). Extended Message 01h See “ Unit Attention Conditions ” on page 87 for extended message sup[...]

Message In T able 1 13. Supported Inbound Messages Name Code Support Command Complete 00h This message is sent by the drive at the end of the Status phase to indicate that a command is complete. Once the message is sent, the drive releases the bus and goes to Bus Free. Disconnect 04h This message is sent by the drive to indicate that it is about to[...]

Extended Messages T able 1 14. Supported Extended Messages Name Code Support Synchronous Data T ransfer Request 01h The default mode is for the drive to never initiate a Synchronous data transfer negotiation. The initiator is expected to do so. Since this mode is most important at power-on, no SCSI method of changing this mode is provided. Instead,[...]

Features of the Fibre Channel Interface The Ultrium T ape Drive Model T200F (Fibre Channel drive) is an Arbitrated-Loop-only device (also known as an NL port). The drive supports Fibre Channel Arbitrated Loop (FC-AL) protocol, and uses Class 3 Service frames. The drive also supports both public (switch-attached) and private loops. The World Wide No[...]

102 Ultrium Internal T ape Drive and 3580 Ultrium T ape Drive: SCSI Reference[...]

Appendix. Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, pr[...]

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements, or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility , or any other claims related to non-IBM products. Questions on the capabilities of non-IBM pro[...]

T rademarks The following terms are trademarks of International Business Machines Corporation in the United States or other countries or both: AIX iSeries AS/400 OS/400 eserver pSeries IBM SP IBMLink RS/6000 The following are U. S. trademarks of Hewlett-Packard Company , International Business Machines Corporation, and Seagate T echnology: Linear T[...]

106 Ultrium Internal T ape Drive and 3580 Ultrium T ape Drive: SCSI Reference[...]

Index A abort condition, handling 94 AS/400 device driver support 4 requirements for attaching tape drive to 3 attaching tape drive to server 3 B bus parity errors, handling 97 C capacity 1 common commands, supported 5 compressed capacity 1 Current Sense data 87 D Data Compression Log 25 Data Compression Mode Page 31 data transfer rate 1 Deferred S[...]

P persistent errors 88 PERSISTENT RESER VE IN command 5, 36 PERSISTENT RESERVE OUT command 5, 39 Post A self test diagnostic 73 Post B tape test diagnostic 74 Post C media test diagnostic 75 Post D Head T est diagnostic 76 power-on procedure 93 PREVENT/ALLOW MEDIUM REMOV AL command 5, 41 pSeries, requirements for attaching tape drive to 3 R READ A [...]

Readers’ Comments — We’d Like to Hear from Y ou Ultrium Internal T ape Drive Models T200 and T200F and 3580 Ultrium T ape Drive SCSI Reference Publication No. WB1 109-02 Overall, how satisfied are you with the information in this book? V ery Satisfied Satisfied Neutral Dissatisfied V ery Dissatisfied Overall satisfaction hhhhh How satisfied a[...]

Readers ’ Comments — We ’ d Like to Hear from Y ou WB1 109-02 WB1 109-02  Cut or Fold Along Line Cut or Fold Along Line Fold and T ape Please do not staple Fold and T ape Fold and T ape Please do not staple Fold and T ape NO POST AGE NECESSARY IF MAILED IN THE UNITED ST A TES BUSINESS REPL Y MAIL FIRST -CLASS MAIL PERMIT NO. 40 AR[...]

[...]

 Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber .[...]