This publication contains information about how to use and program the IBM
Ultrium Internal Tape Drive Models T200 and T200F and the IBM 3580 Ultrium Tape
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 page 5 lists the SCSI commands that are
v “Chapter 3. Error Sense Information” on page 87 describes the error sense
v “Chapter 4. Sense Keys and Additional Sense” on page 89 describes the sense
v “Chapter 5. Attachment Features” on page 93 describes the features of the SCSI
Related Publications
v IBM 3580 Ultrium Tape Drive Setup, Operator, and Service Guide, GA32-0415,
|
|
|
|
|
|
|
|
|
|
|
v IBM Ultrium Internal Tape Drive Models T200 and T200F Setup, Operator, and
v IBM Ultrium Device Drivers Installation and User’s Guide, GA32-0430, provides
v IBM Ultrium Device Drivers Programming Reference, WB1304, supplies
v Fibre Channel Arbitrated Loop (FC-AL-2), published by the American National
v Fibre Channel Tape and Tape Medium Changes (FC-TAPE), published by the
v Fibre Channel Protocol for SCSI, Second Version (FCP-2), published by the
v Proposed Addition of Read and Write Attribute Commands to SPC-2, available
v SCSI-3 Stream Commands (SSC), published by the American National
supported by the tape drives.
information for the tape drives.
keys and additional sense information for the tape drives.
and Fibre Channel tape drives.
tells how to install and run the IBM 3580 Ultrium Tape Drive. The guide also
describes how to administer basic service procedures.
Service Guide, GA32-0435, tells how to install and run the IBM Ultrium Internal
Tape Drive. The guide also describes how to administer basic service
procedures.
instructions for attaching IBM-supported hardware to open-systems operating
systems. It indicates what devices and levels of operating systems are
supported, gives the requirements for adapter cards, and tells how to configure
servers to use the device driver with the Ultrium family of devices.
information to application owners who want to integrate their open-systems
applications with IBM-supported Ultrium hardware. The reference contains
information about the application programming interfaces (APIs) for each of the
various supported operating-system environments.
Standards Institute (ANSI) as NCITS 332:1999.
American National Standards Institute. Final draft available as T11/99-069v4 on
the web at http://www.t11.org; actual document available from ANSI as NCITS
TR-24:1999.
American National Standards Institute and available on the web at
http://www.t10.org.
on the web at http://www.t10.org.
Standards Institute and available on the web at http://www.t10.org.
The IBM Ultrium Internal Tape Drive Models T200 and T200F and the IBM 3580
Ultrium Tape 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 interface.
|
|
The 3580 Ultrium Tape Drive contains the Ultrium Tape Drive Model T200 (the SCSI
drive).
Designed to perform unattended backups as well as to retrieve and archive files,
the Ultrium Internal Tape Drives feature:
v Native storage capacity of 100 GB per cartridge (200 GB at 2:1 compression)
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 tape libraries.
1
|
|
|
|
|
|
|
The Ultrium Internal Tape Drive Model T200 uses an Ultra2 SCSI Low Voltage
Differential/Single Ended (LVD/SE) interface. It features a burst data transfer rate of
80 MB per second.
The Ultrium Internal Tape Drive Model T200F uses a Fibre Channel interface with a
SC-Duplex, multimode optical connector and SCSI protocol. It features a burst data
transfer rate of 100 MB per second and can attach to Storage Area Network (SAN)
components.
The 3580 Ultrium Tape Drive is available in two models. The models vary according
to the type of SCSI interface that each uses to communicate with the server:
v Model L11 uses the Ultra2, Low Voltage Differential/Single Ended (LVD/SE)
interface. It has a burst data transfer rate of 80 MB per second.
v Model H11 uses the Ultra, High Voltage Differential (HVD) interface. It has a
The IBM Ultrium Internal Tape Drive Models T200 and T200F and the IBM 3580
Ultrium Tape 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. To determine the latest supported attachments:
v For the Ultrium Tape Drive Models T200 and T200F, visit the Web at
http://www.ibm.com/storage/storagesmart/lto
v For the 3580 Ultrium Tape Drive, visit the Web at
http://www.ibm.com/storage/lto
Attachments to the drives include (but are not limited to) the servers and operating
systems in the following sections.
The Ultrium Tape Drive Model T200 and the 3580 Ultrium Tape Drive use a SCSI
interface and attach to the following servers. For specific instructions about
attachment, see the IBM Ultrium Device Drivers Installation and User’s Guide.
ServerOperating System
®
IBM AS/400
IBM RS/6000
eserver pSeries
Hewlett-PackardHP-UX 11.0 PCI 64-bit or HP-UX 11i
®
SUN
Intel-compatible serversMicrosoft
or IBM eserver iSeries
®
, IBM RS/6000 SP™,orIBM
™
™
IBM OS/400®Level V4R4 or later
IBM AIX®4.3.3 or 5.1
Solaris Version 2.6, 7, or 8
®
Windows®2000 Level 2195 or
later, or Windows NT
Service Pack 6 or later
®
Red Hat
Linux®7.1 kernel 2.4.2-2
®
Server Version 4 with
Fibre Channel Attachment
|
|
|
|
|
|
|
||
||
|||
|
||
||
||
The Ultrium Tape Drive Model T200F uses a Fibre Channel interface and attaches
to the following servers. For specific instructions about attachment, see the IBMUltrium Device Drivers Installation and User’s Guide. For more information, visit the
Web at
http://www.storage.ibm.com/hardsoft/products/sangateway/supserver.htm.
ServerOperating System
IBM AS/400 or IBM eserver iSeriesIBM OS/400 Level V5R1 or later
IBM RS/6000, IBM RS/6000 SP, or IBM
eserver pSeries
Hewlett-PackardHP-UX 11.0
SUNSolaris Version 2.6, 7, or 8
Intel-compatible serversMicrosoft Windows 2000 Level 2195 or later,
|
|
|
|
|
Supported SAN Components
IBM 2103 Fibre Channel hub (distance solution, only one target per hub
IBM 2109 Fibre Channel switches
|
IBM AIX 4.3.3 with APARs IY10452 and
IY15766, or AIX 5.1
or Windows NT Server Version 4 with
Service Pack 6a or later
Chapter 1. Introduction3
|
Supported Device Drivers
IBM maintains the latest levels of device drivers and driver documentation for the
3580 Ultrium Tape Drive on the Internet. You 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
|
v Using a browser, type one of the following:
v Using an IBM FTP site, enter the following specifications:
IBM provides PostScript- and PDF-formatted versions of its documentation in the
/storage/devdrvr directory:
v IBM_ultrium_tape_IUG.ps and IBM_ultrium_tape_IUG.pdf contain the current
v IBM_ultrium_tape_PROGREF.ps and IBM_ultrium_tape_PROGREF.pdf contain
drivers, contact your IBM Marketing Representative.
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.
Table 1. Supported Common Commands
Command Name
ERASE19hMSSC6yyyyyy
INQUIRY12hMSPC-27-----LOAD/UNLOAD1BhOSSC14yy--yy
LOCATE2BhOSSC15yyy-yy
LOG SELECT4ChOSPC-216yy---y
LOG SENSE4DhOSPC-217y----MODE SELECT (6)15hMSPC-226yy---y
MODE SELECT (10)55hOSPC-226yy---y
MODE SENSE (6)1AhMSPC-227yy---MODE SENSE (10)5AhOSPC-227yy---PERSISTENT
RESERVE IN
PERSISTENT
RESERVE OUT
PREVENT ALLOW
MEDIUM REMOVAL
READ08hMSSC42yyy-yy
READ ATTRIBUTE8ChOSPC-343yyy--y
READ BLOCK LIMITS05hMSSC48yy---READ BUFFER3ChOSPC-249y----READ POSITION34hMSSC52yy---RECEIVE
DIAGNOSTIC
RESULTS
RELEASE UNIT (6)17hMSPC-254-y---RELEASE UNIT (10)57hMSPC-254-y---REPORT DENSITY
SUPPORT
REPORT LUNsA0hMSSC58-----REQUEST SENSE03hMSPC-259-----RESERVE UNIT (6)16hMSPC-263yy---RESERVE UNIT (10)56hMSPC-263yy---REWIND01hMSSC64yyy-yy
SEND DIAGNOSTIC1DhMSPC-265yyy-yy
SPACE11hMSSC81yyy-yy
TEST UNIT READY00hMSSC82yyy--y
VERIFY13hOSSC82yyy-yy
WRITE0AhM SSC 83 yyyyyy
v SSC = SCSI-3 Stream Commands (SSC)
v SPC = SCSI Primary Commands-2 (SPC-2)
Note 3: Applicable Conditions are as follows:
v RVC = reservation conflict
v UAT = unit attention
v NRD = not ready
v WRP = write protect
v MFC = medium format corrupted
v DCC = deferred check condition
Note 4: Reported as appropriate for the type of Service Action and Reservation Type requested and the current reservation state of
the drive.
Operation
Code
SCSI
Class
SCSI
Spec
1
Page
2
RVCUATNRDWRPMFCDCC
Applicable Conditions
3
ERASE
Table 2. ERASE Command
76543210
0Operation Code (19h)
1Logical Unit Number (0)ReservedImmedLong
2Reserved
3Reserved
4Reserved
5Control
If the Long bit is set, EOD is written at the current position. A Data Set Separators
pattern is written from EOD to the end of the medium to overwrite any data
currently on the tape. If the Long bit is clear, then an EOD is written at the current
position and marks it as end of data.
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 complete, including any
immediate commands that are currently being processed. It also waits for any
buffered data to be flushed to tape. It then reports a deferred error for any
preceding command or buffered data, if appropriate. If there is no deferred error,
the drive reports Good status and initiates the command. If the Immediate (Immed)
flag is set to 0, status is not returned until after the command has completed.
After the command is successfully completed, the drive is positioned immediately
before End Of Data (not End Of Tape).
0Operation Code (12h)
1Logical Unit Number (0)ReservedEVPD
2Page Code
3Reserved
4Allocation Length
5Control
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 returned.
If the Enable Vital Product Data (EVPD) flag is set and the Page Code is 0, the
Supported Vital Product Data Pages page is returned.
If the Enable Vital Product Data (EVPD) flag is set, if the Page Code is not 0, and if
there is a vendor-defined Inquiry data page that corresponds to that page code,
then that page is returned. Supported pages are 03h, 80h, 83h, C0h, and D0h. The
contents of pages 03h and D0h are not specified in this document.
If the preceding conditions do not apply, Check Condition status is returned. The
Sense Key is set to Illegal Request (5) and the ASC/ASCQ is set to Invalid Field in
CDB (2400).
Chapter 2. Command Support7
Standard Inquiry Data Valid LUN
Table 4. Standard Inquiry Data Valid LUN
76543210
0Peripheral Qualifier (000b)Peripheral Device Type (01h)
1RMB(1)Device-type modifier (0)
2ISO version (0)ECMA version (0)Version (3)
3AENC(0) Obsolete NACA(0) HiSup(0)Response Data Format (2)
4Additional length (33)
5Reserved
6BQue(0) EncSrv(0)VS(0)MultiP(0)MCh-
7RelAdr(0) ObsoleteWBs16SyncLinked(0)Trans-
8
15
16
31
32
35
36ReservedAutDis
37Reserved
Obsolete Adr32(0)Adr16
ngr(0)
CmdQ(0)VS(0)
Dis(0)
Vendor Identification
Product Identification
Product Revision Level: YMDV
Values for the Adr16 bit are 1 (for SCSI) or 0 (for Fibre Channel).
Values for the WBs16 bit are 1 (for SCSI) or 0 (for Fibre Channel).
Values for the Sync bit are 1 (for SCSI) or 0 (for Fibre Channel).
The AutDis or Automation Disabled bit indicates that this drive is not capable of full
automation function.
The Standard Inquiry Data is based on the SCSI-3 standard for Standard Inquiry
Data.
The Vendor Identification returns IBM in ASCII with trailing blanks.
The Product Identification returns ULT3580-TD1 in ASCII with trailing blanks. TD
stands for tape drive and 1 stands for Generation 1 of this product family.
The Product Revision Level has four values: Y represents year, M represents month,
D represents day, and V is a suffix. For V, values of 0 through 9 and A through Z are
valid; a value of 0 is designated as earliest or least significant, and Z is designated
as most significant.
Values for the Adr16 bit are 1 (for SCSI) or 0 (for Fibre Channel).
Values for the WBs16 bit are 1 (for SCSI) or 0 (for Fibre Channel).
Values for the Sync bit are 1 (for SCSI) or 0 (for Fibre Channel).
The Vendor Identification returns IBM in ASCII with trailing blanks. Product
Identification and Product Revision Level are set to vendor-specific strings.
The Vendor Identification returns IBM in ASCII with trailing blanks.
The Product Identification returns ULT3580-TD1 in ASCII with trailing blanks.
The Product Revision Level has four values: Y represents year, M represents month,
D represents day, and V is a suffix. For V, values of 0 through 9 and A through Z are
valid; a value of 0 is designated as earliest or least significant, and Z is designated
as most significant.
Chapter 2. Command Support9
Supported Vital Product Data Page
Table 6. Supported Vital Product Data Inquiry Page
The Unit Serial Number Page contains a single value that is a 10-byte ASCII string.
The string, with the Vendor Identification and Product Identification fields in the
standard Inquiry data, uniquely identifies the drive. Valid Serial Number values are 0
through 9, A through D, and F.
The device Identification Descriptor Page contains a series of device Identification
Descriptors that uniquely identify the particular device. The format of each is given
in Table 9.
Table 9. Identifier Descriptor Format
76543210
0ReservedCode Set (2h)
1ReservedIdentifier Type
2Reserved
3Identifier Length (n-3)
4
:
n
Identification Descriptor
The device Identification Descriptor is returned by both the Parallel SCSI- and
Fibre-Channel-attached devices.
The Code Set field is 2, indicating the Identification Descriptor contains only ASCII
data.
This device supports Identifier Type of 1. In this case, the Identification Descriptor is
the Vendor ID followed by the Product Identification field from the standard inquiry
data and the Serial Number field from the Serial Number Inquiry Page (see “Unit
Serial Number Page” on page 10).
The Parallel SCSI drive reports only the single Identification descriptor of Identifier
Type 1.
Chapter 2. Command Support11
The Fibre Channel Identification descriptor is returned only on Fibre-Channelattached devices. The format is given in Table 10.
Table 10. Fibre Channel Identification Descriptor
76543210
0ReservedCode Set (1h)
1Reserved
2Reserved
3Identifier Length (8)
4Name Format (0101b)OUI Format Identifier
5
Association Type (
00b)
Identifier Type (3h)
:
6
7OUI Format Identifier (continued)Vendor-specific Identifier
8Vendor-specific Identifier (continued)
9Port/Node ID (0)Serial Number
The Drive Component Revision Levels Pages contain details of the revisions of
|
|
|
each of the components of the drive. This device supports only one Drive
Component Revision Levels Page (Page C0h). The values returned by the device in
this page are unique to the vendor and are not specified in this document.
This page contains four null-terminated ASCII strings. The Component entry has a
twelve-character entry to identify the component that the revision is for. The Version
entry has a seven-character version code, with a three-digit major revision number,
a period, and a three-digit minor version number. The date entry has the date of the
version, in year-first order. The Variant entry has a variant identifier, indicating the
version of the product.
Chapter 2. Command Support13
LOAD/UNLOAD
Table 12. LOAD/UNLOAD Command
76543210
0Operation Code (1Bh)
1Logical Unit Number (0)ReservedImmed
2Reserved
3Reserved
4ReservedEOT(0)Reten(0)Load
5Control
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
returned. The Sense Key is set to Not Ready (2) and the ASC/ASCQ is set to
Parameter Medium Not Present (3A00).
If the Load flag is clear, there is a tape in the drive, and medium removal prevention
has not been set, then the tape is unloaded and ejected. If the Load flag is clear,
there is a tape in the drive, and medium removal prevention has been set, then
Check Condition status is returned. The Sense Key is set to Illegal Request (5) and
the ASC/ASCQ is set to Medium Removal Prevented (5302).
|
|
|
|
|
If the Load flag is clear and the tape is in the ejected position, the command is
presented with Check Condition status and associated sense data of 2/0402 (Not
Ready, Initialization Required). If the Load flag is clear and there is no cartridge
present, the command is presented with Check Condition status and associated
data of 2/3A00 (Not Ready, Medium Not Present).
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 complete, including any
immediate commands that are currently being processed. It also waits for any
buffered data to be flushed to tape. It then reports a deferred error for any
preceding command or buffered data, if appropriate. If there is no deferred error,
the drive reports Good status and initiates the command. If the Immediate (Immed)
flag is set to 0, status is not returned until after the command has completed.
The End Of Tape (EOT) and Retension (Reten) flags are not supported and should
be set to 0.
The LOCATE 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 the command and
waits for any previous command from any server to complete, including any
immediate commands that are currently being processed. It also waits for any
buffered data to be flushed to tape. It then reports a deferred error for any
preceding command or buffered data, if appropriate. If there is no deferred error,
the drive reports Good status and initiates the command. If the Immediate (Immed)
flag is set to 0, status is not returned until after the command has completed.
Table 13. LOCATE Command
76543210
0Operation Code (2Bh)
1Logical Unit Number (0)ReservedBT(0)CP(0)Immed
2Reserved
3
:
6
7Reserved
8Partition (0)
9Control
Block Address
The Block Type (BT) and Change Partition (CP) flags are not supported and should
be set to 0. The Partition field is not supported and should be set to 0.
Chapter 2. Command Support15
LOG SELECT
Table 14. LOG SELECT Command
76543210
0Operation Code (4Ch)
1Logical Unit Number (0)ReservedPCRSP(0)
2PCReserved
3Reserved
4Reserved
5Reserved
6Reserved
7
8
9Control
Parameter List Length
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 Parameter Code Reset (PCR) flag is set, the Parameter List Length is 0, and
the Page Control (PC) field is 01b or 11b, then all the logs on the drive that can be
reset are reset to their default values.
If the Parameter Code Reset (PCR) flag is set, the Parameter List Length is 0, and
the Page Control (PC) field is 00b or 10b, then no action is taken and Good status
is returned.
If the Parameter Code Reset (PCR) flag is clear, the Parameter List Length is not 0,
and the Page Control (PC) field is 01b or 11b, then data is sent from the server and
is written to the indicated logs, provided those logs are writable.
If the preceding conditions do not apply, Check Condition status is returned. The
Sense Key is set to Illegal Request and the ASC/ASCQ is set to Invalid Field in
CDB (2400).
The Save Page (SP) flag is not supported and must be set to 0.