Summary of Contents for Sun Oracle StorageTek T10000
Page 1
StorageTek T10000 Tape Drive Fibre Channel Interface Reference Manual Part Number: E20425-02 July 2011 Submit comments about this document to STP_FEEDBACK_US@ORACLE.COM.
Page 2
Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Table of Contents ............................9 Figures List of Tables .......................... 11 ............................15 Preface Access to Oracle Support ......................15 What’s New ..........................17 ......................19 General Information Overview ..........................20 Implementation ........................22 Tape Drive Description ......................23 Specifications ........................... 25 External Power Supply Module ..................
Page 5
REC Timeout ........................65 Upper Level Protocol Timeout .................... 65 FCP Feature Set........................66 Process Login Parameters ....................66 FCP Information Units ......................68 Command Information Unit ....................69 Transfer Ready Information Units ..................69 Data Information Unit ......................70 Response Information Unit ....................
• 4FC = T10000A or T10000B or T10000C with a 4 Gb interface • T10000A or T10000B or T10000C • FC = Fibre Channel Access to Oracle Support Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html or visit http:// www.oracle.com/accessibility/support.html...
Page 16
Access to Oracle Support 16 T10000: Interface Reference Manual July 2011...
• Removed the front and back cover pages • Replaced the title page • Revised the copyright page The part number was changed to an Oracle part number. Removed the Summary of Changes and added a What’s New section in the frontmatter of the manual.
Page 18
18 T10000: Interface Reference Manual July 2011...
General Information This chapter contains an overview about the Fibre Channel specifications for Oracle’s StorageTek T10000 Tape Drive, which conforms to the: • American National Standards Institute (ANSI) • National Committee for Information Technology Standards (NCITS) TABLE 1-1 lists the documents that help define this implementation.
Implementation Implementation Tape Drive: • NL_Port Arbitrated loop (conforming to the FC–Tape) • FCP (SCSI-3) command set for tape (serial) devices • Class 3 level of service • Class 2 level of service (future) • Private Loop NL_Port attach operation •...
Tape Drive Description Tape Drive Description Size: The T10000 tape drive is a small, modular, high-performance tape drive designed for high-capacity storage of data. The drive is: • Height = 8.89 cm (3.5 in.) • Width = 14.6 cm (5.75 in.) •...
Page 24
Tape Drive Description FIGURE 1-1 T10000A and T10000B Tape Drive Rear View 1. Drive status LED 2. Ethernet port 3. Recessed switch (service only) 4. Encryption status LED 5. Tape transport interface (TTI) connector 6. Power supply connector 7. Fibre Channel, LC interface ports (2) A & B FIGURE 1-2 T10000C Tape Drive Rear View 1.
Specifications Environmental Requirements Note – Although the T10000 tape drive will function over the full list of ranges as specified below, optimal reliability will be achieved if the environment is maintained between the recommended ranges. TABLE 1-7 Environmental Specifications Description Optimum Recommended Ranges...
Physical Interface This chapter describes how the StorageTek tape drives attach to a Fibre Channel (FC) interface and includes recommendations for hubs, cables, and connectors. Topologies StorageTek tape drives support the following topologies with either single or dual port attachments: •...
Arbitrated Loop Arbitrated Loop FIGURE 2-1 is an example of a hub producing an arbitrated loop. FIGURE 2-1 Arbitrated Loop Hubs Because of the fast growth and the increase in demand of fibre channel attachments, hubs can provide cascading (multiple) loops within a fibre channel network. StorageTek tape drives are designed to use hubs to provide for an arbitrated loop which provides the following capabilities: •...
Giga-Bit Interface Converters Giga-Bit Interface Converters Hubs use Giga-bit Interface Converters (GBICs) to provide the physical connection to the tape drives. GBIC connectors are available for: • High speed serial data (HSSDC) • Copper, 9-pin shielded “D” (DB9) • Shortwave non-OFC •...
Cables and Connectors Redundant Paths The tape drive interface cards are dual port to support redundant paths. FIGURE 2-4 is an example of one server using hubs to provide redundant paths to the same device. FIGURE 2-4 Redundant Paths Cables and Connectors Because the link to a port can be driven either optically or electrically, the term “fibre”...
Cables and Connectors Interface Ports The T10000 tape drive can support either short or long wavelength interface ports. The tape drive is designed to accept the small form-factor pluggable (SFP) transceivers in to the interface ports. It is acceptable to use one port as short wave and one port as long wave (mixed).
Page 36
Cables and Connectors 36 T10000: Interface Reference Manual July 2011...
Operations This chapter describes how StorageTek tape drives operate using a Fibre Channel (FC) interface. Note – This document is defined by the requirements in FC-Tape Revision 1.17. As updates occur to the FC-Tape document, this document will be updated accordingly. Connections The T10000 tape drives support connections for both: •...
Direct N_Port Attachment Direct N_Port Attachment The T10000 tape drives support direct attachment to a host through a host bus adapter (HBA) that creates an N-Port. The HBA sends and receives to and from the tape drive. Addressing StorageTek tape drives use: Port name, Node name, and Port ID for login validation. The StorageTek registration ID is 24 bits consisting of: •...
Terms and Definitions Terms and Definitions Tables throughout this chapter use the following terms for compliance with the American National Standards Institute (ANSI) Fibre Channel Tape (FC–Tape) Technical Report for the StorageTek implementation. FC–Tape Terms Allowed (A) Can be used between an initiator and a target (tape drive). For tape drives, this is typically dependent on the particular feature or parameter and its applicability to the request from an initiator.
Loop Initialization Features Loop Initialization Features Arbitrated loop initialization protocol assigns up to a possible 126 addresses to different ports on the loop and builds a map of these addresses. The following pages describe some loop initialization features StorageTek tape drives perform. Loop initialization must occur before operations on the loop can begin.
Loop Initialization Features Loop Failures A loop failure is any of the following: • A loss of Signal • A loss of Synchronization for longer than R_T_TOV If a Loop Failure occurs, the L_Port which detects the failure issues a LIP(F8,AL_PS) if it has a valid AL_PA, or LIP(F8,F7) if it doesn’t.
Loop Initialization Features Loop Initialization Report Position StorageTek tape drives support the mapping process to build a map of the AL_PA values according to their position on the loop. The temporary loop master begins the procedure to create a Loop Initialization Report (LIRP). This initialization report and map is done by using a 1-word frame identifier with an offset value of one (1).
Loop Initialization Features Fabric F_PORT Attachment Initialization In the absence of a loop environment the StorageTek tape drives will attempt to initialize with a fabric. This is accomplished by doing a Fabric Login (FLOGI). The FLOGI process will be attempted in each class of service that the tape drive supports. Once the FLOGI process is successful the tape drive will attempt to login (PLOGI) with the fabric attached name server, if it exists.
Arbitrated Loop Feature Set Arbitrated Loop Feature Set StorageTek tape drives implement the following Fibre Channel feature set: TABLE 3-2 FC-AL Feature Set FC-TAPE Feature Initiator Target StorageTek Notes Attempt to acquire Hard Address during LIHA sequence of loop initialization following loss of power, power-on reset, or recognition of LIP (AL_PD or AL_PS) LILP/LIRP:...
Arbitrated Loop Feature Set Login_BB_Credit Equals Zero StorageTek tape drives advertise Login_BB_Credit =0. When Login_BB_Credit=0 at the other L_Port, the following rules apply: • The OPN originator must receive R_RDYs (receiver readys) from the tape drive before transmitting a frame. •...
Common Service Parameters Common Service Parameters TABLE 3-3 lists the Common Service Parameters for Port Login (PLOGI): TABLE 3-3 NL_Port Common Service Parameters, Port Login StorageTek Value Parameter Word Bits N_Port NL_Port N_Port FC-Tape FC-PH Version: Highest Version 31–24 x ‘09’ x ‘09’...
Common Service Parameters TABLE 3-4 lists the Common Service Parameters the tape drive supports for Fabric Login (FLOGI): TABLE 3-4 NL_Port Common Service Parameters, Fabric Login StorageTek Value NL-Port Parameter Word Bits N_Port NL_Port N_Port Originator FC-PH Version: Highest Version 31–24 x ‘09’...
FC Class 3 FC Class 3 Fibre Channel provides several different strategies to ensure reliable communications between devices. These strategies are called Classes of Service. The tape drive supports the Class 3 level of service which provides no notification of frame delivery or non-delivery.
Page 49
FC Class 3 TABLE 3-6 Class 3 Service Parameters, Port Login (Continued) StorageTek Value Parameters Word Bits N_Port NL_Port N_Port FC- Tape Sequence Initiator ACK_N Capable – ACK generation assistance – Initiator Data compression capable Initiator Data compression history 7–6 –...
FC Class 3 Class 3 Service Parameters, Fabric Login TABLE 3-7 lists Class 3 Service Parameters the tape drives support for Fabric Login (FLOGI): TABLE 3-7 Class 3 Service Parameters, Fabric Login StorageTek Value Parameters Word Bits N_Port NL_Port N_Port FC- Tape Class validity Service Options:...
FC-2 Features FC-2 Features The FC-2 level provides the signaling protocol and specifies the rules and requirements to transfer blocks of data. The FC-2 level is the most complex level in Fibre Channel protocols and provides the different classes of service, packetizing, sequencing, error detection, and reassembling the transmitted data.
Link Service Commands Link Service Commands Fibre Channel uses link service commands to manage functions such as port management, Login, Logout, and abort operations. The tape drives support both basic and extended link service commands to perform these operations. Basic Commands TABLE 3-9 lists the Basic Link Service commands: TABLE 3-9 Basic Link Services...
Link Service Commands Extended Commands TABLE 3-10 lists the Extended Link Service commands: Note – If the tape drive receives a request for Extended Link Services which are not supported, the tape drive returns a Link Services Command Reject (LS_RJT) with a reason code of “Command Not Supported”.
Page 54
Link Service Commands TABLE 3-10 Extended Link Services (Continued) FC-TAPE StorageTek From Target From Initiator Command Initiator Response Target Response Drv Orig. Drv Resp. N_Port Login (PLOGI) Process Login: (PRLI) PRLI Common Service – Parameters Single Service Parameter page per request Multiple Service...
Link Service Commands TABLE 3-10 Extended Link Services (Continued) FC-TAPE StorageTek From Target From Initiator Command Initiator Response Target Response Drv Orig. Drv Resp. State Change Notification – (SCN) State Change Registration (SCR) Test – Test Process Login State – Third Party Process Logout (TPRLO) TABLE 3-11 FC-4 Link Services...
Link Service Commands Responses to Link Services TABLE 3-12 summarizes the response the tape drives generate when receiving different Link Service requests when the drive NL_Port is not currently logged in with the sending Port. TABLE 3-12 Response to Link Services from Ports Not Logged-In Frame Received Port Not Logged In...
Frame Transmission Frame Transmission FIGURE 3-1 shows the frame format for transmission of data and commands over Fibre Channel. FIGURE 3-1 Frame and Frame Header Format R_CTL Routing Control: Indicates the type of frame functions Destination ID Identifies the port destination CS_CTL Class specific control field Source ID...
Exchange Management RX_ID Responder Exchange ID: Identifies responder of exchange Parameter Contains unique parameters for exchange Exchange Management Exchange (X) management is the overall control of operations over the Fibre Channel interface between the originator and responder. Refer to the FC–PH documents for rules and guidelines pertaining to Class 2 operation.
Sequence Management Exchange Responder The exchange responders assign unique RX_ID values or use the value of “FFFF.” The exchange responder considers an exchange open from the time it receives the first frame of the first information unit until one of the following occurs: •...
Sequence Management Sequence Open The tape drive considers a Sequence open from the time that the first frame of the Sequence (the frame with the SOFi3 delimiter) is sent until one of the following occurs: • An end-of-frame (EOF) delimiter is sent with the last sequence bit set •...
Error Detection and Management Sequence Errors Sequence errors are managed as defined in FC–Tape with the following additions: 1. If a frame with an SOFi3 delimiter is received and the SEQ_CNT is not equal to zero or +1 from the SEQ_CNT of the last frame of the previous Sequence of that Exchange.
Error Detection and Management • Successfully receiving write data by: • FCP Transfer Ready was received • A response was received However, FCP data and FCP responses cannot always be detected. Currently, the FCP-2 defines detection of these missing frames by using timeouts. For FCP responses, the target may request the initiator to send an FCP confirmation to confirm receipt of the response.
Error Detection and Management Because the running disparity within a frame is variable, two different EOF delimiters are used depending on the content of the frame following the transmission of the CRC. TABLE 3-15 End of Frame Delimiters Delimiter Abbreviation Transmission Word Characters EOF Normal EOFn...
Fibre Channel Timers Fibre Channel Timers StorageTek tape drives use the timer values in TABLE 3-16. TABLE 3-16 Timer Summary Implemented By Timer Value Initiator Target StorageTek AL_TIME 15 ms R_T_TOV 100 ms E_D_TOV Private = 2 sec. (note 2) Public = supplied + 2 sec.
Fibre Channel Timers E_D_TOV includes the time required to gain access to the loop in addition to the actual frame transmission time. Resource Allocation Timeouts The Resource Allocation Timeout (R_A_TOV) has two components: • Sequence Qualifiers (SEQ_QUAL) defines the minimum time that an initiator waits before reusing the sequence qualifiers (SEQ_ID and SEQ_CNT).
FCP Feature Set FCP Feature Set Fibre Channel Protocol (FCP) provides functions such as login and logout parameters and the transfer of commands and data through the use of Information Units. The FCP command set for the tape drives is SCSI-3. Process Login Parameters TABLE 3-17 TABLE 3-18 on page 67...
FCP Information Units FCP Information Units Information units transfer data to and from the SCSI Initiator and SCSI Target and include the following required units: • T1 = Command and Task Management • T6 = Write Data (such as Mode Select and Write commands) •...
FCP Information Units Command Information Unit The Command Information Unit (T1) is a single-frame sequence. TABLE 3-19 FCP 8-Byte LUN Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 For all commands that transfer data to the tape drive: FCP_DL (data length) in the FCP_CMND payload always equals the number of bytes being transferred for the command.
FCP Information Units For read operations: The FCP_XFER_RDY IU (I2) is not used during read type (data in) operations. This is indicated by setting the ‘READ XFER_RDY DISABLED’ bit during process login. Data Information Unit The Data Information Units (T6 and I3) are either single- or multiple-frame sequences.
FCP Information Units Residual Checking Residual checking falls under the following categories: • SCSI Targets that transfer exactly FCP_DL data bytes during the FCP_DATA IUs set the FCP_RESID_UNDER to a value of ‘0’b. When FCP_RESID_UNDER is set to ‘0’b, the SCSI Initiator tries to determine if all of the expected data was transferred by comparing the FCP_DL to the actual number of bytes transferred.
FCP Information Units Response Codes The Response Code field (FCP_RSP_INFO) contains information that describes the failures detected during the execution of an I/O Operation and conforms to the following rules: • The FCP_RSP_INFO does not contain link error information because FC-PH provides the mechanisms for presenting these errors.
FCP Information Units Task Management Flags and Information Units All SCSI Initiators send Task Management functions using T1. All SCSI Targets return FCP_RSP to Task Management functions using I4. The RSP_CODE in the FCP_RSP_INFO field indicates the result of the Task Management function.
SCSI Features Other Features TABLE 3-24 lists other FCP features supported: TABLE 3-24 Other FCP Features FC-TAPE Feature Initiator Target StorageTek FCP_LUN (in FCP_Command) FCP_LUN (0) Inquiry of FCP_LUN (0) Inquiry of FCP_LUN (>0) Auto Contingent Allegiance (ACA) SCSI Features The following sections describe the SCSI features supported by the tape drives.
Status Byte Busy Busy (08) status occurs when the target: • Is busy performing another operation • Cannot accept a command The normal initiator recovery from a Busy status is to reissue the command. Check Condition Check Condition (02) status occurs when any error, unit exception, or abnormal condition that generates sense data occurs.
Public Loop SCSI Target Discovery Public Loop SCSI Target Discovery The following private loop discovery is used except that discovery of SCSI Targets will be performed via the Simple Name Server or RSCN and the function performed by ADISC/PDISC will be replaced by FAN. Private Loop SCSI Target Discovery When the possibility of a configuration change exists, a SCSI Initiator may want to rediscover the new configuration.
Page 77
Private Loop SCSI Target Discovery Using this SCSI Target Discovery procedure, the SCSI Initiator has the ability to assemble a database consisting of Node name, Port name, and Port ID. There are several confirmations a SCSI Initiator can perform on that database to determine which SCSI Targets it can continue to communicate with that are not defined by this document.
Private Loop SCSI Target Discovery TABLE 3-25 Clearing Effects (Continued) FCP SCSI Target Object Device Reservations For all SCSI initiators Only for SCSI Initiator port – – – – – initiating action Persistent Device Reservations For all SCSI initiators Only for SCSI Initiator port –...
Private Loop SCSI Target Discovery Device Reservations The T10000 tape drives support the Reserve/Release management method and also the Persistent Reservations management method. These methods are defined in the ANSI SCSI-3 Primary Commands (SPC-2) standard. • See TABLE 3-26 for the reservation restrictions placed on commands for the Reserve/Release management method.
Page 81
Private Loop SCSI Target Discovery TABLE 3-26 Reserve/Release Management Method (Continued) Command Action when Reserved by a different Initiator Report LUNs (A0h) Allowed Report Supported Operations Codes (A3h–0Ch) Conflict Report Supported Task Management Conflict Functions (A3h–0Dh) Report Target Port Groups (A3h–0Ah) Allowed Request Sense (03h) Allowed...
Commands This chapter defines the SCSI-3 commands for the StorageTek T10000 Tape Drive with a Fibre Channel interface. Overview StorageTek uses the SCSI-3 command set to transfer commands and data over Fibre Channel. The following describes how StorageTek implements these SCSI commands: •...
Page 86
Commands TABLE 4-1 Supported SCSI Commands (Continued) Command Code Reference Page Log Sense SPC-2 Mode Select 15h / 55h SPC-2 Mode Sense 1Ah / 5Ah SPC-2 Persistent Reserve In SPC-2 Persistent Reserve Out SPC-2 Prevent/Allow Media Removal Read Read Attribute SPC-4 Read Block Limits Read Buffer...
Implementation Requirements Implementation Requirements The initiator sends commands to the target using Command Descriptor Blocks (CDBs). The CDBs contain a format that includes: • Operation code • Command parameters • Control byte For some commands, a list of parameters accompanies the request during subsequent FCP_DATA Information Units.
Command Descriptor Block Command Descriptor Block Initiators use three types of CDBs to communicate commands to the targets: • 6–Byte commands (TABLE 4-2) • 10–Byte commands (TABLE 4-3) • 12-Byte commands (TABLE 4-4) The first byte in the command descriptor block contains an operation code. TABLE 4-2 6-Byte Command Descriptor Block Byte Operation Code...
Command Descriptor Block Control Byte The control byte is the last byte of every Command Descriptor Block and has the following structure: TABLE 4-5 Control Byte Byte 5/9/11 Vendor-specific Reserved Flag Link Parameter Value These bits provide specific information about the device Vendor-specific (shall be zero).
Erase Command Erase Command The Erase command erases the remainder of the tape starting at the current, logical position. Any buffered write data and filemarks are written on the tape before the erase operation starts. Note – At the completion of the Erase command, the tape is positioned at the physical end-of-volume (PEOV) if the data security erase (DSE) configuration option is set to full.
Inquiry Command Inquiry Command The Inquiry command returns information about the type and capabilities of a SCSI device. TABLE 4-7 Inquiry Command Byte Operation Code (12h) Reserved CmdDt EVPD Page Code (MSB) thru Allocation Length (LSB) Control Byte Parameter Value CmdDt: Command support Data 0 = Do not return command support data EVPD: Enable Vital Product Data...
Inquiry Command Inquiry Data Format The Inquiry data format contains 74 bytes shown in TABLE 4-8. TABLE 4-8 Inquiry Data Format Byte Peripheral Qualifier Peripheral Device Type Reserved ECMA Version AERC RSVD NormAC HiSup Response Data Format Additional Length (n - 4) SCCS TGPS Reserved...
Page 93
Inquiry Command Parameter Value 000b = Peripheral device is connected to this logical unit Peripheral Qualifier 011b = Not capable of supporting a device on this logical unit 01h = Device is a sequential access device (tape drive) Peripheral Device Type 1Fh = Device does not exist or is offline RMB: Removable Medium Bit...
Page 94
Inquiry Command Parameter Value Product Revision: For example: 1.23.456 Indicates: 8 byte ASCII field • Major release 1, • Revision 23, • Minor release 456 This field will change with each drive firmware release. Vendor Specific VS: Vendor Specific 0 = Not supported Key Management (KM) 0 = None...
Inquiry Command Vital Product Data Pages There are three vital product data pages that contain specific information: 00h = Supported vital product data pages (TABLE 4-9) 4-10) 80H = Device serial number page (TABLE 4-11) 83h = Device identification page (TABLE 85h = Management Network Address page (TABLE...
Inquiry Command TABLE 4-11 Device Identification Page Byte Peripheral Qualifier Peripheral Device Type Page Code (83h) Reserved Page Length (28h) Node Name Identifier Reserved Code Set (1) Reserved Association (0) Identifier Type (3) Reserved Identifier Length (08h) (MSB) thru Node Identifier (binary) (LSB) Port Name Identifier Reserved...
Page 97
Inquiry Command TABLE 4-11 Device Identification Page (Continued) Byte (MSB) thru Target Port Group Identifier (binary) (LSB) Parameter Value Page Code 83h returns four identifying numbers. • World Wide Name (WWN) for the tape drive • WWN for the port that accepted the Inquiry command •...
Load Display Command Load Display Command The Load Display command (vendor specific) displays ASCII messages on the virtual operator panel for that device. This command transfers 17 bytes of data to the display. The data transferred contains one byte of display control data and two, eight- byte ASCII messages.
Page 101
Load Display Command Parameter Value Overlay: New message overlay 000 = Display the message in bytes 1–8 or 9–16 until the next command that initiates tape motion or the next Load Display Command. 001 = Maintain the message in bytes 1–8 until the cartridge is unloaded.
Load/Unload Command Load/Unload Command The Load/Unload command loads or unloads tape from the device. Any buffered write data and filemarks are written on the tape before an unload starts. Caution – If the drive is in Buffered Mode and a previous command terminated with Check Condition status (such as buffered data unwritten to tape and the condition was not cleared or otherwise recovered), the drive will discard any unwritten...
Locate Command • When the drive needs cleaning, an unload will return Check Condition status with a Sense Key of 0h and an ASC/ASCQ of 0017h indicating the tape drive requires cleaning. Locate Command The Locate command requests the tape drive to position the tape to a specified block address.
Log Select Command Log Select Command The initiator uses the Log Select command to manage information about the device or media. TABLE 4-18 Log Select Command Byte Operation Code (4Ch) Reserved Reserved (MSB) thru Reserved (LSB) (MSB) thru Parameter List (LSB) Control Byte Parameter...
Log Sense Command Log Sense Command The Log Sense command returns device statistical data to the host. TABLE 4-19 Log Sense Command Byte Operation Code (4Dh) Reserved Page Code (MSB) thru Reserved (LSB) (MSB) thru Parameter Pointer (LSB) (MSB) thru Allocation Length (LSB) Control Byte...
Log Sense Command Log Sense Page Format Each log page begins with a four–byte page header followed by variable–length log parameters. TABLE 4-20 Log Sense Page Format Byte Reserved Page Code Reserved (MSB) thru Page Length (n-3) (LSB) Log Parameter(s) Log Parameter (First) x + 3 (Length = x)
Log Sense Command Parameter Value Parameter Code Identifies the log parameter being transferred DU: Disable Update 0 = Drive updates log parameter value DS: Disable Save 1 = saving the log is not supported TSD: Target Save Disable 0 = Target provides a target defined method for saving log parameters 1 = Target does not provide a target defined method for saving the log parameters...
Log Sense Command Read Error Counter Page The Read Error Counter page (03h) reports statistical errors for read operations. Each parameter is a counter that the target increments when an event occurs. TABLE 4-25 Read Error Counter Page Codes Parameter Length Default Code...
Log Sense Command Sequential Access Device Page The Sequential Access Device page (0Ch) returns counts of data bytes transferred to and from tape and information about cleaning in binary format. TABLE 4-27 Sequential Access Device Page Codes Parameter Length Default Code Description (bytes)
Log Sense Command TapeAlert Flags TABLE 4-28 TapeAlert Flags Length Code Flag Name Description (bytes) 0001h Read Warning Drive has difficulty reading 0002h Write Warning Drive has difficulty writing Write or read hard error has occurred 0003h Hard Error (flags 4, 5, 6) 0004h Media...
Page 112
Log Sense Command TABLE 4-28 TapeAlert Flags (Continued) Length Code Flag Name Description (bytes) 001Ah Cooling fan failure Not supported 001Bh Power supply failure Not supported 001Ch Power consumption Not supported 001Dh Drive Maintenance Preventive maintenance of the drive is required 001Eh Hardware A...
Page 113
Log Sense Command TABLE 4-28 TapeAlert Flags (Continued) Length Code Flag Name Description (bytes) 003Ah Firmware failure The tape drive has reset itself due to a detected firmware fault. 003Bh thru Reserved 0040h July 2011 Commands 113...
Log Sense Command Vendor Unique Port Statistics Page The Vendor Unique Port Statistics page (3Bh) reports error counts and small form- factor plug (SFP) information for each Fibre Channel port on the drive. TABLE 4-30 Vendor Port Statistics Page Codes Parameter Length Default...
Mode Select Command Mode Select Command The Mode Select command specifies options and parameters for a device. StorageTek recommends the host system perform a Mode Sense command before each Mode Select command to determine the current settings and to avoid any unwanted alterations to other Mode Select fields.
Mode Select Command Parameter Value PF: Page Format 0 = Vendor specific format (same as PF = 1) 1 = Page formatted data follows block descriptor, or header SP: Save Parameters 0 = Not supported Parameter List Length Contains the total number of bytes in the header, block descriptor, and all pages.
Mode Select Command TABLE 4-35 Mode Select (10) Header Data Byte (MSB) thru Reserved (LSB) Buffered Mode Speed Code (MSB) thru Reserved (LSB) (MSB) thru Block Descriptor Length (LSB) Page data may follow header if 00 is returned for block descriptor length. Parameter Value Not applicable or not defined...
Mode Select Command Parameter Value FAStat: Loop Fairness Algorithm Status 0 = Target chooses DImm: Disconnect Immediate 0 = Target chooses DTDC: Data transfer disconnect control 0 = Target chooses First Burst Size 0 = No limit Control Data Protection Mode Page This Mode Select page returns information about the current Data Integrity Validation (DIV) mode.
Mode Select Command Parameter Value LBP_W 0 = Protection Information is not included with the data Logical Blocks Protected during transferred when writing. 1 = Protection Information is included with the data transferred when writing. Notes: • If the Logical Block Protection Method field is set to zero, the LBP_W bit is set to zero.
Mode Select Command Device Configuration Page TABLE 4-42 Mode Select Device Configuration Page Byte SPF (0) Page Code (10h) Page Length (0Eh) RSVD Active Format Active Partition Write Buffer Full Ratio Read Buffer Empty Ratio (MSB) thru Write Delay Time (LSB) RSMK SOCF...
Page 131
Mode Select Command Parameter Value SOCF: Stop On Consecutive Filemarks 00b = Stop read ahead when buffer is full RBO: Recover Buffer Order 0 = Not supported 0 = Report early warning only on REW: Report Early Warning Write and Write Filemarks commands Gap Size 0 = Gap size not selectable EOD Defined: End Of Data...
Mode Sense Command Mode Sense Command The Mode Sense (6) and Mode Sense (10) commands return the current operating modes and parameters of a device to the host. The Mode Sense commands also return the default parameters or information on which fields and bits can be changed using the Mode Select command.
Page 138
Mode Sense Command Parameter Value LLBAA: Long LBA Accepted 0 = Normal DBD: Disable Block Descriptor 0 = Return block descriptor after header 1 = Do not return the block descriptor PC: Page Control 00b = Current values 01b = Changeable values 10b = Default values Page Code: Mode page to return 00h = No page data...
Mode Sense Command Mode Sense Header Data Mode Sense—6 Byte Command returns a 4-byte header. TABLE 4-50 Mode Sense (6) Header Data Byte Mode Data Length Medium Type Buffered Mode Speed Block Descriptor Length Mode Sense—10 Byte Command returns an 8-byte header TABLE 4-51 Mode Sense (10) Header Data Byte (MSB)
Mode Sense Command Mode Sense Block Descriptor Data TABLE 4-52 Mode Sense Block Descriptor Data Byte Density Code (MSB) thru Block Count (LSB) Reserved (MSB) thru Block Length (LSB) Parameter Value Density Code 4Ah = T10000A default density 4Bh = T10000B default density 4Ch = T10000C default density Block Count Will always be 0...
Mode Sense Command Parameter Value FAStat: Loop Fairness Algorithm Status 0 = Target chooses DImm: Disconnect Immediate 0 = Target chooses DTDC: Data transfer disconnect control 0 = Target chooses First Burst Size 0 = No limit Control Data Protection Mode Page This Mode Sense page returns information about the current Data Integrity Validation (DIV) mode.
Mode Sense Command Parameters Value LBP_W 0 = Protection Information is not included with the data Logical Blocks Protected during transferred when writing. 1 = Protection Information is included with the data transferred when writing. Note – If the Logical Block Protection Method field is set to zero, the LBP_W bit is set to zero.
Mode Sense Command Device Configuration Page TABLE 4-58 Mode Sense Device Configuration Page Byte SPF (0) Page Code (10h) Page Length (0Eh) RSVD Active Format Active Partition Write Buffer Full Ratio Read Buffer Empty Ratio (MSB) thru Write Delay Time (LSB) RSMK SOCF...
Page 147
Mode Sense Command Parameters Value SOCF: Stop On Consecutive Filemarks 00b = Stop read ahead when buffer is full RBO: Recover Buffer Order 0 = Not supported REW: Report Early Warning 0 = Report early warning only on Write and Write Filemarks commands Gap Size 0 = Gap size not selectable...
Mode Sense Command Fibre Channel Port Control Page TABLE 4-60 Fibre Channel Port Control Page (19h) Byte SPF (0) Page Code (19h) Page Length (06h) Reserved DTFD PLPB DDIS ALWI DTIPE DTOLI (MSB) thru Reserved (LSB) Reserved RR_TOV units Resource Recovery Time Out Value (RR_TOV) Parameter Value PS: Parameters Savable...
Persistent Reserve In Command Persistent Reserve In Command The Persistent Reserve In command returns information about registered persistent reservation keys and the currently active persistent reservations. TABLE 4-64 Persistent Reserve In Command Byte Operation Code (5Eh) Reserved Service Action (MSB) thru Reserved (LSB)
Persistent Reserve In Command Read Keys Parameter Data A Persistent Reserve In command with a Service Action of 00h (Read Keys) will return a list of the reservation keys for all currently registered initiators. TABLE 4-65 Read Keys Parameter Data Byte (MSB) thru...
Persistent Reserve In Command Read Reservations Parameter Data A Persistent Reserve In command with a Service Action of 01h (Read Reservations) will return information about the currently active persistent reservation. TABLE 4-66 Read Reservations Parameter Data Byte (MSB) thru Generation (LSB) (MSB) thru...
Persistent Reserve In Command Parameter Value Scope Specific Address 0 = Not supported Scope 0 = Persistent Reservation is for the Logical Unit Type Persistent Reservation type 3h = Exclusive Access for one initiator 6h = Exclusive Access by all registered initiators Report Capabilities Parameter Data A Persistent Reserve In command with a Service Action of 02h (Report Capabilities) will return information about persistent reservation features.
Persistent Reserve Out Command Persistent Reserve Out Command The Persistent Reserve Out command is used to register Reservation Keys and create Persistent Reservations using these keys. TABLE 4-70 Persistent Reserve Out Command Byte Operation Code (5Fh) Reserved Service Action Scope Type (MSB) thru...
Persistent Reserve Out Command Registering a Reservation Key An initiator must register a key before performing any other Persistent Reserve Out commands. To register a key, the initiator sends a Persistent Reserve Out command with the Service Action field set to Register (0h), and the Parameter List length set to 18h.
Persistent Reserve Out Command Clearing reservations should only be done in an error recovery situation. Pre-empting Reservations Made by Another Initiator A registered initiator can clear active reservations and registration keys by issuing a Persistent Reserve Out command. The Service Action field is set to Pre-empt, the Scope and Type fields are ignored.
Prevent/Allow Medium Removal Command Prevent/Allow Medium Removal Command The Prevent/Allow Medium Removal command enables and disables the unload switch. The switch is enabled unless this command is used. TABLE 4-72 Prevent/Allow Medium Removal Command Byte Operation Code (1Eh) (MSB) thru Reserved (LSB) Reserved...
Read Command Read Command The Read command transfers the next record or records from tape to the host. After successful completion of a Read Command, the tape is positioned after the last block read. TABLE 4-73 Read Command Byte Operation Code (08h) Reserved SILI Fixed...
Read Command • If a filemark is encountered, Check Condition status is returned, the filemark and valid bits in sense data are set, and tape is positioned after the file mark. In variable block mode the Information bytes are set to transfer length. In fixed block mode, Information bytes are set to transfer length minus the actual number of blocks read, not counting the filemark.
Read Attribute Command If there is no PI error then only the requested number of data bytes are returned to the Host, reporting of ILI and residuals as usual. Read Attribute Command The Read Attribute command transfers read attribute values to the host. TABLE 4-74 Read Attribute Command Byte Operation Code (8Ch)
Read Attribute Command Attribute Values—Service Action Returns parameter data containing the requested attributes in ascending numerical order by attribute value and in the following format. TABLE 4-75 Read Attribute with Attribute Values—Service Action Format Byte (MSB) thru Available Data (n-3) (LSB) Attributes Attribute 0...
Read Attribute Command Medium Auxiliary Memory Attribute Format Each medium auxiliary memory (MAM) attribute is communicated between the application client and device server in the following format. TABLE 4-76 Medium Auxiliary Memory Attribute Format Byte (MSB) thru Attribute Identifier (0224h) (LSB) Read Reserved...
Read Attribute Command Attribute List—Service Action Returns parameter data contains the attribute identifiers for the attributes that are not in the unsupported state and not in the nonexistent state in the specified partition and volume number. TABLE 4-77 Read Attribute with Attribute List—Service Action Format Byte (MSB) thru...
Read Attribute Command Volume List—Service Action Returns parameter data identifying the supported number of volumes. The contents of Volume Number, Partition Number, and First Attribute Identifier fields in the CDB shall be ignored. TABLE 4-78 Read Attribute with Volume List—Service Action Format Byte (MSB) thru...
Read Attribute Command Partition List—Service Action Returns parameter data identifying the supported number of partitions supported in the specified volume. The contents of Partition Number, and First Attribute Identifier fields in the CDB shall be ignored. TABLE 4-79 Read Attribute with Partition List—Service Action Format Byte (MSB) thru...
Read Block Limits Command Read Block Limits Command The Read Block Limits command establishes the longest and shortest record size supported by the tape drive. This command returns six bytes of data. • When the DIV feature is not enabled the Maximum Block Length reported by the Read Block Limits command is 2,097,152 bytes.
Read Buffer Command Read Buffer Command The Read Buffer Command retrieves trace dump data. Any buffered write data and filemarks are written on the tape before this operation starts. TABLE 4-82 Read Buffer Command Byte Operation Code (3Ch) Reserved Mode Buffer ID (MSB) thru...
Read Buffer Command • The dump buffer may contain multiple dumps up to a maximum of 12 MB of data. • The maximum amount of permanent error trace data or event log data is 524KB. • If no data remains to be transferred, Check Condition status is returned. The sense key is set to Blank Check with the valid bit set.
Read Media Serial Number Command Read Media Serial Number Command The Read Media Serial Number Command returns the serial number of the currently mounted tape. TABLE 4-85 Read Media Serial Number Command Byte Operation Code (ABh) Reserved Service Action (01h) (MSB) thru Reserved...
Read Position Command Read Position Command The Read Position command returns information about the current logical and physical block address of the tape. This command returns 20 bytes of data from the logical unit. Note – Block addresses are used with the Locate and Recover Buffered Data commands.
Read Position Command Read Position Data TABLE 4-88 Read Position Data Byte BYCU RSVD PERR RSVD Partition Number (MSB) thru Reserved (LSB) (MSB) thru First Block Location (LSB) (MSB) thru Last Block Location (LSB) Reserved (MSB) thru Number of Blocks in Buffer (LSB) (MSB) thru...
Page 177
Read Position Command Parameter Value First Block Address of the next record in the buffer assuming the next host operation is a write. Last Block Address of the next record on tape assuming the next operation is a write. Number of write records separating buffer logical position Number of Blocks in buffer from the actual position of the tape.
Read Position Command Read Position Data Long TABLE 4-89 Read Position Data Long Byte Reserved LONU Rsvd BPEW (MSB) thru Reserved (LSB) (MSB) thru Partition Number (LSB) (MSB) thru Logical Object Number (LSB) (MSB) thru Logical File Identifier (LSB) (MSB) thru Logical File Identifier (LSB)
Read Position Command Physical Position Indicator Data TABLE 4-90 Physical Position Indicator Data Byte Wrap Section Track Density Length Section Layout Cartridge Type Last Tape Speed Next Tape Speed (MSB) thru Partition Size (LSB) (MSB) thru Host Side ID (LSB) (MSB) thru Device Side ID...
Page 180
Read Position Command Length Tape length 2h = Standard cartridge 4h = Sport cartridge Number of sections Section Layout 01 = One section Cartridge Type 10h = Data tape 20h = Code load tape 40h = Dump tape Last Tape Speed 0h = Low speed 1h = High speed Next Tape Speed...
Receive Diagnostic Results Receive Diagnostic Results Page Format TABLE 4-92 Receive Diagnostic Results Page Format Byte Page Code Reserved (MSB) thru Page Length (n-3) (LSB) (MSB) Diagnostic Parameter thru (LSB) Parameter Value Page Code Identifies Diagnostic Page Note – The page length reflects the absolute length of the page, and is not adjusted because of the allocation length.
Release Unit Command Release Unit Command The Release Unit command cancels reservations made by the Reserve Unit Command. If the unit is reserved by another initiator, good status is returned, but the unit is not released. If the unit is not currently reserved, good status is also returned. TABLE 4-93 Release Unit—6 Byte Command Byte Operation Code (17h)
Report Density Support Command Report Density Support Command The Report Density command returns information about the density codes and recording formats. TABLE 4-95 Report Density Support Command Byte Operation Code (44h) Reserved Media (MSB) thru Reserved (LSB) (MSB) thru Allocation Length (LSB) Control Byte Parameter...
Report Density Support Command Report Density Support Data Density Support Header TABLE 4-96 Byte (MSB) thru Available Density Support Length (LSB) (MSB) thru Reserved (LSB) (MSB) thru Density Support Block Descriptor (LSB) Parameter Value Available Density Support Control data that follows. Length 36h = One density support block returned for T10000A 6Ah = Two density support blocks returned for T10000B...
Report Density Support Command Density Support Block Descriptor TABLE 4-97 Density Support Data Block Descriptor Byte Primary Density Code Secondary Density Code WRTOK Deflt Reserved (MSB) thru Reserved (LSB) (MSB) thru Bits per MM (LSB) (MSB) thru Media Width (LSB) (MSB) thru Tracks...
Page 187
Report Density Support Command Parameter Value 0 = Writes not permitted with this density code WRTOK: Write Support 1 = Drive is capable of writing at this density DUP Duplicate Density Support 0 = Only 1 density support data block for this density code Block Deflt: Default density code 1 = This is the default density code...
Report LUNs Command Report LUNs Command The Report LUNs command reports the address of the available logical units. TABLE 4-98 Report LUNs Command Byte Operation Code (A0h) (MSB) thru Reserved (LSB) (MSB) thru Allocation Length (LSB) Reserved Control Byte Parameter Value Allocation Length Maximum allowed length in bytes of returned data.
Report Supported Operation Codes Command All_Commands Parameter Data Format The Report Supported Operation Codes All_Commands Parameter Data Format begins with a four-byte header that contains the length in bytes of the parameter data followed by a list of supported commands. The list of command descriptors contains all commands supported by the logical unit.
Page 191
Report Supported Operation Codes Command Parameter Value Service Action Contains a supported service action for the operation code. If the operation code does not have a service action, this field is set to 00h. CTDP: Command Timeouts Command Timeouts Descriptor Present Descriptor Present 0 = Indicates that the command timeouts descriptor is not included in this command descriptor...
Report Supported Operation Codes Command One_Command Parameter Data Format The Report Supported Operation Codes One_Command Parameter Data Format contains information and a usage map for bits in the CDB for the command and service action field. TABLE 4-103 One_Command Parameter Data Byte Reserved CTDP...
Page 193
Report Supported Operation Codes Command Parameter Value CDB Size Contains the size of the CDB Usage Data field in the parameter data, and the number of bytes in the CDB for command being queried. For example, the command specified by the Reporting Options, Requested Operation Code, and Requested Service Action fields in the Report Supported Operation Codes CDB.
Report Supported Operation Codes Command Command Timeouts Descriptor The Command Timeouts Descriptor returns timeout information for commands supported by the logical unit based on the time from the start of processing for the command to its reported completion. Values returned in the command timeouts descriptor do not include times that are outside the control of the device.
Report Target Port Groups Command Report Target Port Groups Command The Report Target Port Groups command sends target port group information to the host. TABLE 4-107 Report Target Port Groups Command Byte Operation Code (A3h) Reserved Service Action (0Ah) (MSB) thru Reserved (LSB)
Report Target Port Groups Command Report Target Port Group Parameter Data Format The format for the parameter data returned by the Report Target Port Groups command is shown in the following table. TABLE 4-108 Report Target Port Group Parameter Data Format Byte (MSB) thru...
Report Target Port Groups Command Target Port Group Descriptor Format There shall be one target port group descriptor for each target port group. TABLE 4-109 Target Port Group Descriptor Format Byte PREF Reserved Asymmetric Access State T_SUP O_SUP Reserved U_SUP S_SUP AN_SUP AO_SUP...
Report Target Port Groups Command Target Port Descriptor Format TABLE 4-110 Target Port Descriptor Format Byte thru Obsolete (MSB) thru Relative Target Port Identifier (LSB) Parameter Value Relative Target Port Identifier Contains a relative port identifier of a target port in the target port group.
Request Sense Command Request Sense Command The Request Sense command transfers sense data to the initiator. TABLE 4-111 Request Sense Command Byte Operation Code (03h) (MSB) thru Reserved (LSB) Allocation Length Control Byte Allocation Length: Maximum length of sense data to return to the host. The device currently supports 26 bytes of sense data.
Request Sense Command Sense Data: TABLE 4-112 Sense Data Format Byte Valid Response Code (70h or 71h) Reserved Filemark RSVD Sense Key (MSB) thru Information (LSB) Additional Sense Length (n-7) (MSB) thru Command Specific Information (LSB) Additional Sense Code Additional Sense Field Replaceable Unit Code SKSV (MSB)
Request Sense Command Parameter Value 0 = Normal EOM: End of Media 1 = Requested record size did not match actual record size 0 = Normal ILI: Illegal Length Indication 1 = A Forward command encountered End of Media, or a Reverse Space command encountered BOT.
Request Sense Command TABLE 4-114 Progress Indication Sense Key Not Ready or No Sense Specific Data Byte SKSV Reserved (MSB) thru Progress Indication (LSB) Parameter Value SKSV: 0 = Progress indication not valid Sense Key Specific Fields Valid 1 = Progress indication valid.
Request Sense Command Sense Keys TABLE 4-115 lists the Sense Keys that provides basic information about an error. The Sense Key, with the ASC and ASCQ, provides a description about an error. TABLE 4-115 Sense Key Code Descriptions Code Description No Sense...
Request Sense Command Additional Sense Codes and Qualifiers TABLE 4-116 lists the Additional Sense Code and Qualifiers found in Bytes 12 and 13 of the sense data. These codes provide additional information about an error. TABLE 4-116 Sense Key with ASC and ASCQ Byte Description No additional sense information...
Page 207
Request Sense Command TABLE 4-116 Sense Key with ASC and ASCQ (Continued) Byte Description Peripheral device write fault (used when a prior check message locks out a load display command) Drive reported failure Logical unit or communication failure Logical unit timeout Logical block guard check failed Mechanical positioning error (tape lost tension) Firmware corrupted...
Page 208
Request Sense Command TABLE 4-116 Sense Key with ASC and ASCQ (Continued) Byte Description Parameter list length error (mode select or other parameter data was truncated) Invalid command operation code (first byte of CDB is not a supported cmd) Logical block address out of range Invalid field in CDB (unsupported or illegal bits are set, field pointer indicates where) Write command has 1 through 4 as an invalid transfer count for the Data...
Page 209
Request Sense Command TABLE 4-116 Sense Key with ASC and ASCQ (Continued) Byte Description Not ready to ready transition (medium may have changed) Power on or reset occurred Parameters changed Mode parameters changed by another host Log parameters changed by another host Reservation pre-empted by another host Reservations released by another host Reservation pre-empted by another host...
Reserve Command Reserve Command The Reserve Unit command reserves a device for the exclusive use of one initiator. The device returns Reservation Conflict status if any other initiator sends a command to the device except for Sense, Inquiry, or Release Unit Commands. Reservations are canceled with a reset or Release Unit.
Rewind Command Rewind Command The Rewind command causes the device to rewind the media to the beginning-of- tape (BOT). The device writes any buffered write data on tape before the rewind starts. Caution – If the drive is in Buffered Mode and a previous command terminated with Check Condition status (such as, buffered data unwritten to tape and the condition was not cleared or otherwise recovered), the drive will discard any unwritten...
Security Protocol In Command Security Protocol In Command The Security Protocol In (SPIN) command returns information about security and encryption TABLE 4-120 Security Protocol In Command (SPIN) Byte Operation Code (A2h) Security Protocol (MSB) thru Security Protocol Specific (LSB) INC512 Reserved Reserved (MSB)
Page 213
Security Protocol In Command Parameter Value Security Protocol Specific The Security Protocol Specific specifies the type of page being requested. When Security Protocol is 00h; • 0000h = Supported Security Protocol List • 0001h = Certificate Data When Security Protocol is 20h; •...
Security Protocol In Command Security Protocol Information Pages Supported Security Protocol List A request of Security Protocol of 00h and a Security Protocol Specific 0000h will return a list of supported security protocols. TABLE 4-121 Security Protocol List Byte (MSB) Reserved thru (LSB)
Security Protocol In Command Tape Data Encryption Pages Tape Data Encryption In Supported Page A request of Security Protocol of 20h and a Security Protocol Specific 0000h will return a list of supported values for the Security Protocol Specific field supported by the SPIN command.
Security Protocol In Command Tape Data Encryption Out Supported Page A request of Security Protocol of 20h and a Security Protocol Specific 0001h will return a list of supported values for the Security Protocol Specific field supported by the Security Protocol Out (SPOUT) command. TABLE 4-124 Tape Data Encryption Out Supported Page Byte (MSB)
Security Protocol In Command Parameter Value External data encryption control capable EXTDECC: External data encryption control capable 00b = The external data encryption control capability is not supported Configuration prevented CFG_P: Configuration prevented 01b = Drive is configured to allow changes of data encryption parameters Data Encryption Algorithm Descriptor TABLE 4-126 Data Encryption Algorithm Descriptor...
Page 218
Security Protocol In Command Parameter Value Algorithm valid for mounted volume AVFMV 0 = Not valid or no volume mounted 1 = Valid Supplemental decryption key capable SDK_C 0 = Not supported Message authentication code capable MAC_C 0 = Not supported Distinguish encrypted logical block capable ...
Security Protocol In Command Parameter Value DKAD_C Decryption KAD capable when Decryption Mode is Decrypt or Mixed 00b = Not specified (Not supported) 01b = Drive requires a U-KAD provided by the Host for decrypting operations. If not provided with SPOUT command Set Data Encryption page then terminate the command with Check Condition with sense key set to Illegal Request and the ASC set to Incomplete ...
Security Protocol In Command Value Parameter Supported Key Formats 00h = Plain text Keys Data Encryption Management Capabilities Page A request of Security Protocol of 20h and a Security Protocol Specific 0012h will return information about encryption management features supported. TABLE 4-128 Data Encryption Capabilities Management Page Byte (MSB)
Security Protocol In Command Parameter Value LOCAL bit supported in the Set Data Encryption page LOCAL_C 1 = Supported PUBLIC bit supported in the Set Data Encryption page PUBLIC_C 1 = Supported Data Encryption Status Page A request of Security Protocol of 20h and a Security Protocol Specific 0020h will return the current data encryption status.
Page 222
Security Protocol In Command Parameter Value I_T nexus of the saved data encryption parameters I_T Nexus Scope 000b = Public 001b = Local 010b = All I_T Nexus Logical block encryption scope of the saved data encryption parameters Logical Block 000b = Public ...
Security Protocol In Command Key-Associated Data Descriptors List The following key association descriptors are returned in the Key Descriptor Type order. TABLE 4-130 Key Association Descriptor Type Byte Key Descriptor Type Reserved Authenticated (MSB) thru Key Descriptor Length in bytes (LSB) (n-3) (MSB)
Security Protocol In Command Next Block Encryption Status Page A request of Security Protocol of 20h and a Security Protocol Specific 0021h will return the next block encryption status. TABLE 4-131 Next Block Encryption Status Byte (MSB) thru Page Code (0021h) (LSB) (MSB) thru...
Security Protocol In Command Parameter Value Raw decryption mode disabled status RDMDS 0 = Not supported Key-Associated Data The key-associated data descriptors are only returned on Encryption Descriptors List Status 6h. The following key association descriptors are returned in the Key Descriptor Type order: Key-Associated Data Descriptors List The key-associated data descriptors are only returned on Encryption Status 6h and in...
Security Protocol In Command SPIN Implementation Notes The following table lists the possible key-associated data (KAD) parameters reported in the Next Block Encryption Status page. Key-Associated Data Reported Parameters (SPIN) TABLE 4-133 Key-Associated Descriptors Record Decryption Encryption U-KAD A-KAD Nonce Metadata Information...
Security Protocol Out Command Security Protocol Out Command The Security Protocol Out (SPOUT) command specifies the Tape Data Encryption security protocol to be used when encrypting and decrypting. TABLE 4-134 Security Protocol Out Command (SPOUT) Byte Operation Code (B5h) Security Protocol (20h) (MSB) thru Security Protocol Specific (0010h)
Security Protocol Out Command Set Data Encryption Page A request of Security Protocol of 20h and a Security Protocol Specific 0010h will select the data encryption capabilities of the drive. TABLE 4-135 Set Data Encryption Page Byte (MSB) thru Page Code (0010h) (LSB) (MSB) thru...
Page 229
Security Protocol Out Command Parameter Value Scope of the data encryption parameters Scope 000b = Public 001b = Local 010b = All I_T Nexus 0 = Not locked Lock 1 = Locked CEEM Check external encryption mode 00b = Vendor Specific (Ignored) ...
Security Protocol Out Command Key-Associated Data Descriptors List The following key association descriptors must be provided in Key Descriptor Type order. Note – • If the U-KAD descriptor is not present when Encryption Mode is enabled a 30 byte Key Descriptor of all zeroes is used. •...
Security Protocol Out Command SPOUT Implementation Notes The following table lists the possible Key-Associated Data (KAD) parameters supported in the Set Data Encryption page. TABLE 4-137 Key-Associated Data Reported Parameters (SPOUT) Key-Associated Descriptors Record Decryption Encryption U-KAD A-KAD Nonce Metadata Information Mode...
Page 232
Security Protocol Out Command The drive shall terminate the command with CHECK CONDITION status, with the sense key set to ILLEGAL REQUEST, and the additional sense code set to INVALID COMMAND OPERATION CODE. • If the SPOUT command is sent to a drive that has not been configured for DPKM support.
Page 233
Security Protocol Out Command If the bit is set to one and there is no persistent reservation in effect for the I_T nexus associated with the SECURITY PROTOCOL OUT command, the device server shall terminate the command with CHECK CONDITION status and set the sense key to ILLEGAL REQUEST and the additional sense code to INVALID FIELD IN PARAMETER DATA.
Page 234
Security Protocol Out Command If a device server processes a Set Data Encryption page with the ENCRYPTION MODE field set to DISABLE and DECRYPTION MODE field set to DISABLE or RAW, the physical device shall: a. Release any resources that it had allocated to store data encryption parameters for the I_T nexus associated with the SECURITY PROTOCOL OUT command and shall change the contents of all memory containing a key value associated with the data encryption parameters that are released;...
Send Diagnostic Command Send Diagnostic Command The Send Diagnostic command provides a self-test that verifies the operation of the device. Any buffered write data and filemarks are written on the tape before this operation starts. TABLE 4-138 Send Diagnostic Command Byte Operation Code (1Dh) Reserved...
Space Command Space Command The Space command moves the logical position of the tape. Any buffered write data and filemarks are written on the tape before this operation starts. Note: The Space command does not always move tape. TABLE 4-139 Space Command Byte Operation Code (11h) Reserved...
Page 237
Space Command 5. A reverse space operation into BOT returns Check Condition, sets the Valid and EOM bits, and sets the information bytes to the count minus the actual number of blocks or filemarks moved. 6. A space to end of data positions the tape after the last block or filemark. 7.
Test Unit Ready Command Test Unit Ready Command The Test Unit Ready command checks if a device is loaded and ready to receive a command that accesses the media, such as Read or Write commands. TABLE 4-140 Test Unit Ready Command Byte Operation Code (00h) (MSB)
Verify Command Verify Command The Verify command reads one or more blocks of data from the tape without transferring the data to the host. TABLE 4-141 Verify Command Byte Operation Code (13h) Reserved VLBPM Immed BYTCMP Fixed (MSB) thru Verification Length (LSB) SILI Control Byte...
Page 240
Verify Command Parameter Value Fixed Block mode 0 = Variable block 1 = Fixed block Verification Length Number of bytes or blocks to verify SILI: Suppress Illegal Length Suppress Illegal Length Indication Indication 0 = Check condition status is returned if the record length does not match Verification Length.
Write Command Write Command The Write command transfers one or more blocks of data from the host to tape. TABLE 4-142 Write Command Byte Operation Code (0Ah) Reserved Fixed (MSB) thru Transfer Length (LSB) Control Byte Parameter Value Fixed Indicates the block mode for data transfer: 0 = Variable block mode.
Write Command 6. If a Write command returns Check Condition status, the valid bit in the Request Sense data is set. 7. The Request Sense information bytes are zeros if all data was written on tape. In variable block mode, the data indicates the total number of bytes not written on tape.
Write Buffer Command Write Buffer Command The Write Buffer command updates the functional microcode for the drive. The process of updating microcode is called a download. A change in the initiator from one Write Buffer command to another during a download is interpreted as a new download process request and terminates the active process.
Page 244
Write Buffer Command Parameter Value Mode Indicates the type of download: 06h = Download Microcode with Offsets Multiple transfers are required to download the microcode. The first Write Buffer command must contain data for the start of the image. Subsequent Write Buffer commands must transfer data in sequential order.
Write Filemarks Command Write Filemarks Command The Write Filemarks command writes one or more filemarks on tape starting at the current logical position. TABLE 4-144 Write Filemarks Command Byte Operation Code (10h) Reserved WSmk Immed (MSB) thru Transfer Length (LSB) Control Byte Parameter Value...
Committee's implementation of the Data Integrity Field (DIF). The terms DIV or DIF are also referred to as Protection Information (PI). Data Integrity Validation Oracle’s StorageTek T10000-Series tape drive supports the Data Integrity Validation (DIV) feature. This feature provides end-to-end protection of user data during a transfer.
Page 248
Data Integrity Validation • Read (08h) • Verify (13h) • Write (0Ah) 4. The transfer lengths (CDB bytes 2-4) for these commands must include the additional 4 bytes of Protection Information. 5. During Reading or Writing with DIV mode enabled the Target returns a Check condition if a PI miscompare is detected.
Reed-Solomon CRC Reed-Solomon CRC The following is a sample ‘C program’ to generate the Reed Solomon CRC on an i386 class processor: #include <unistd.h> #include <stdio.h> /*----------------------------------------------------------------------- ** INPUTS: crc - initial crc (0 for fresh) (i.e., seed) ** cnt - the number of data bytes to compute CRC for...
Vendor Unique SB-2 CRC Vendor Unique SB-2 CRC The following is a sample ‘C program’ to generate the SB-2 CRC on an i386 class processor. FIGURE A-1 SB-2 CRC Program Example (Sheet 1 of 6) /********************************************************************* * File: sbbyte.c * Description: 32bit implementation of the CRC32 LFSR....
Page 254
Vendor Unique SB-2 CRC FIGURE A-1 SB-2 CRC Program Example (Sheet 2 of 6) #include <unistd.h> #include <stdio.h> /**************************************************************************/ */ */ /* CRC LOOKUP TABLE */ /* ========================================== */ /* The following CRC lookup table was generated automagically */ ...
Page 257
Vendor Unique SB-2 CRC FIGURE A-1 SB-2 CRC Program Example (Sheet 5 of 6) /* NOTE: The CHECK is for the standard 9 byte test data of ASCII string "123456789" #define FICON /*************************************************************************** * Main ...
Page 258
Vendor Unique SB-2 CRC FIGURE A-1 SB-2 CRC Program Example (Sheet 6 of 6) #ifdef FICON /* Test data, expected CRC is 0x1DC41771 */ 0x00, 0x00, 0x00, 0xC7, 0x00, 0x00, 0x00, 0xC8 #else /* ASCII "123456789" Expected CRC is 0xFC891918 */ 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39 ...
Vendor Unique Intel CRC32C Vendor Unique Intel CRC32C The following is a sample ‘C program’ to software generate the Intel CRC32C on an i386 class processor. This example also includes the assembly language code to utilize the Nehalem class server with SSE4_2 support to generate this CRC with the hardware CRC32 instructions.
Page 260
Vendor Unique Intel CRC32C FIGURE A-2 CRC32C Program Example (Sheet 2 of 8) #include <unistd.h> #include <stdio.h> ****************************************************************************/ */ */ /* CRC LOOKUP TABLE */ ========================================== */ /* The following CRC lookup table was generated automagically */ ...
Page 263
Vendor Unique Intel CRC32C FIGURE A-2 CRC32C Program Example (Sheet 5 of 8) /* NOTE: The CHECK is for the standard 9 byte test data of ASCII string "123456789" //#ifdef CONFIG_X86_64 #if 1 #define REX_PRE "0x48, " #define SCALE_F 8 ...
Glossary This glossary defines terms and abbreviations used in this manual. For definitions of other Fibre Channel or StorageTek terms refer to the glossary in the appropriate document. Numbers 8B/10B A type of encoding and decoding algorithm of bytes, invented and patented by IBM, to reduce transmission errors.
Page 268
Acknowledge A response or confirmation to an address, message, or poll. Additional Sense Bytes The additional sense bytes contain data specific to either or both the command or peripheral device, and further define the nature of the FCP_SNS_INFO feature of the FCP_RSP payload.
Page 269
between more than two devices when those devices want to communicate on the bus. The sending device must arbitrate and win the connection with the receiving device before communication can begin. Arbitrated Loop Physical Address A one-byte value that identifies a port in an arbitrated loop topology. arbitration Any process by which a user of a shared resource negotiates with other users for the right to use the resource.
Page 270
Class of Service The Fibre Channel method of defining a data transmission strategy between devices. There are three FC Classes of Service currently specified in the FC-PH-1, and StorageTek’s implementation includes only one, Class 3. Class 3 The Fibre Channel Class of Service in which the initiator sends a message to a receiving device without expecting or requiring an acknowledgement.
Page 271
DF_CTL Data field control indicates optional headers in the frame. Disassembly The process of splitting out a source buffer into payloads. These payloads are then transmitted in frames. Discover Address (ADISC) The Discover Address command used in Extended Link Services. It is invokable when originated by the initiator, required as a response by the drive, and prohibited when originated by a drive.
Page 272
EOFn End of frame normal. EOFni End of frame normal invalid. EOFt End of frame terminate. Error Detect Timeout Value The minimum period of time that an L_Port can wait for the sequence to complete before initiating a recovery action. ESCON Enterprise Systems Connection.
Page 273
FACT Fabric active alias_ID. Fabric address notification. Fault Symptom Code Four hexadecimal digits that identify a cartridge subsystem error. Fibre Channel. FC_AL Fibre Channel Arbitrated Loop standard. FC-PH-1 The FC Physical and Signaling Interface defined in the ANSI X3.230-1994. FC-PH-2 An extension of the FC Physical and Signaling Interface defined in the ANSI X3.230- 1994 that specifies several extra protocol levels.
Page 274
FCP_XFER_RDY The request for date. FDACT Fabric deactivate alias_ID FDDI See Fiber Distributed Data Interface. FDISC See Discover F_Port Parameters Fiber A wire or strand of optical cable. Fiber is spelled “Fibre” in Fibre Channel. Fiber Distributed Data Interface (FDDI) An NCITS standard for transmitting data at 100 mega-baud over fiber optic cable.
Page 275
Frame An indivisible, encapsulated data structure containing a beginning-of-frame (BOF) and end-of-frame (EOF) designator, which carries a payload of both control data and user data from one FC port to another. Frame Header The first field in a frame that contains addressing information, as well as other control information, about the frame.
Page 276
host bus adapter (HBA) A circuit installed in a multi-platform host or device that interfaces between the device and the bus. HSSDC High speed serial data connectors. StorageTek tape drives use this type of connector at the interface card. A piece of hardware, separate from the actual FC interface accessible on the backplane of a device, which houses the port bypass circuitry for configurations of 8 to 16 ports per hub.
Page 277
Jitter The deviation of timing in an exchange. L_Port It is either an FL_Port or an NL_Port. Laser A term meaning Light Amplification by Stimulated Emission of Radiation. Laser devices generate coherent radiation in the visible, ultraviolet, and infrared portions of the electromagnetic spectrum.
Page 278
Login The FC-required process used by any initiating N_Port or NL_Port in an FC fabric to sign in with any other receiving N_Port or NL_Port port with which it plans to communicate. The signing in process provides the initiator with critical information about the attributes of the recipient port before it attempts to make a connection with Login_BB_Credit On an Arbitrated Loop, this signal is the value equal to the number of receive buffers...
Page 279
Mode Select Command The command used in Fibre Channel that specifies operational parameters and options for a logical unit. The fields that can be changed by the Mode Select Command and what the default values are for these fields. Most Significant Bit. multi mode A graded-index or step-index optical fiber that allows more than one bound mode to propagate.
Page 280
Node Name A 64-bit concatenation of the Port Name, Company ID, and drive serial number, in an IEEE extended format. See No Operation. Operation Code Structure A component of the Command Descriptor Blocks that compose Byte 0 of both the 6- Byte and 10-Byte Command Descriptor.
Page 281
Point-to-Point A topology in which exactly two ports communicate. In FC, the two ports are N_Ports. Port A specific end-point for communications within a host, or from a host to a peripheral device or vice versa. In FC, it is an access point in a device where a link attaches. Examples of this port are N_Port, NL_Port, F_Port, and FL_Port.
Page 282
Public Loop An Arbitrated Loop that includes a participating FL_Port and at least one NL_Port. Public NL_Port An NL_Port that attempts a Fabric Login. QoSR Quality of service request. R_A_TOV See Resource Allocation Timeout. R_CTL The Routing Control field in the frame header contains a routing bits sub-field, which has specific values indicating that FC-4 data will follow.
Page 283
Remove Connection The Remove Connection Command used in Basic Link Services. It is prohibited when originated by the initiator, and is prohibited when originated by a drive. Report Node Capabilities Information The Report Node Capabilities Information Command used in Extended Link Services.
Page 284
SC connector A standard connector for 1 Gbps Fibre Channel data transfer. This type of connector is used on fiber-optic cable. State change notification. SCSI See Small Computer System Interface. SCSI Commands The SCSI-3 Fibre Channel Protocol (FCP) commands issued by either the initiator or target in an arbitrated loop topology, to perform a specific SCSI task.
Page 285
See Start of Frame Delimiter. SOFi3 The abbreviation for Start of Frame Initiate Class 3 delimiter. SOFn3 The abbreviation for Start of Frame Normal Class 3 delimiter. Start-of-Frame Delimiter A delimiter used to mark the beginning of a frame, as well as specify the class of service used for the frame.
Page 286
World Wide Name (WWN) A 64-bit integer that identifies a Fibre Channel port. World Wide Node Name (WWNN) A 64-bit network address that identifies the company (in IEEE format) with a vendor specific identifier. World Wide Port Name (WWPN) A 64-bit network address that identifies the port name. X_ID A Class 3 Service Parameter used for Recipient Control.
Page 288
information unit 69 control byte 89 linking 74 Control Data Protection Mode Page 127 Command Timeouts Descriptor 194 CRC 63 creating a Persistent Reservation 160 Commands basic 52 cyclic redundancy checks 63 Erase 90 extended 53 implementation requirements 87 data Inquiry 91 and response 66 link service 52...
Page 289
power up 43 FAN 76 dual port 29, 34 fault symptom code, description 204 FC Tape terms 39 FC-0 21 FC-1 21 echo 53 FC-2 21 E_D_TOV 64 FC-2 features 51 encoding 62 FC-3 21 encryption and security 212 FC-4 21 encryption, key management 92 FC-AL 21 end-of-frame delimiters 63...
Page 290
Mode Sense command 149 transfer ready 69 response to link services 56 write data 70 timers 64 initialization completion versions 46, 47 private loop 42 Fibre Channel See commands 52 public loop 42 flags initiator TapeAlert 111 control 48, 50 task 73 description of 39 FLOGI 53...
Need help?
Do you have a question about the StorageTek T10000 and is the answer not in the manual?
Questions and answers