Spectra Logic Spectra S50 User Manual

Spectra Logic Spectra S50 User Manual

T-series and 50-series
Table of Contents

Advertisement

Quick Links

Spectra T-Series and Spectra 50-Series
Library Developer Guide
• Spectra T950 Library
• Spectra T120 Library
• Spectra T50 Library
• Spectra S50 Library
P.N. 90940001 Revision E

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Spectra S50 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Spectra Logic Spectra S50

  • Page 1 Spectra T-Series and Spectra 50-Series Library Developer Guide • Spectra T950 Library • Spectra T120 Library • Spectra T50 Library • Spectra S50 Library P.N. 90940001 Revision E...
  • Page 2: Notices

    If you do not agree to the above, do not use the library; instead, promptly contact Spectra Logic for instructions on how to return the library for a refund.
  • Page 3: License

    License You have acquired a Spectra Logic library that includes software owned or licensed by Spectra Logic from one or more software licensors (“Software Suppliers”). Such software products, as well as associated media, printed materials and “online” or electronic documentation (“SOFTWARE”) are protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties.
  • Page 4: Table Of Contents

    Contents Notices ............2 License .
  • Page 5 Chapter 6. Mode Sense—1Ah Command Description ..........27 Command Response .
  • Page 6 Chapter 13. Send Diagnostic—1Dh Command Description ..........59 Command Response .
  • Page 7 Appendix D. Report LUNs—A0 Fibre Channel Command Description ........158 Index Contents...
  • Page 8: List Of Tables

    List of Tables Chapter 2. Initialize Element Status—07h Table 2-1: Initialize Element Status Command–07h ........14 Chapter 3.
  • Page 9 Table 9-8: Medium Transport Element Descriptor Fields ......43 Table 9-9: Storage Element Descriptor (Magazine Slots) ......44 Table 9-10: Storage Element Fields .
  • Page 10 List of Tables Chapter 14. Test Unit Ready—00h Table 14-1: Test Unit Ready Command–00h ........61 Chapter 15.
  • Page 11 Appendix B. Extended Copy—83h—SPC2 Specifications Table B-2: Extended Copy Parameter List ........118 Table B-3: Extended Copy Descriptor Type Codes .
  • Page 12: Chapter 1. Introduction

    T-Series and 50-Series libraries with Fibre Channel capabilities. If you are familiar with Spectra Logic’s Gator architecture (Spectra 12K, Spectra 20K, and Spectra 64K) libraries, you will have an easy time understanding the T-Series and 50-Series SCSI command set.
  • Page 13: Related Publications

    The following publications are also available from Spectra Logic: • The Spectra T950 Library User Guide, the Spectra T120 Library User Guide, the Spectra T50 Library User Guide, and the Spectra S50 Library User Guide describes the configuration and operation of these respective Spectra Logic libraries.
  • Page 14: Chapter 2. Initialize Element Status-07H

    Initialize Element Status—07h Command Description The INITIALIZE ELEMENT STATUS command instructs T-Series and 50-Series libraries to take an inventory of their elements. This includes reading the bar codes of the cartridges. This information can be returned using the READ ELEMENT STATUS (B8h) command. Note: T-Series and 50-Series libraries automatically perform and store an element inventory on power-up, and each time the TeraPack...
  • Page 15: Chapter 3. Initialize Element Status With Range-E7H Or 37H

    Initialize Element Status With Range—E7h or 37h Command Description INITIALIZE ELEMENT STATUS WITH RANGE is a vendor-specific command for other vendors’ tape libraries. It is included in the T-Series and 50-Series libraries’ command set to support the library’s emulation of other libraries. When the library receives this command, it performs as though it had received the INITIALIZE ELEMENT STATUS (07h) command, ignoring any additional parameters supplied with this command.
  • Page 16: Chapter 4. Inquiry-12H

    Inquiry—12h Command Description The INQUIRY command instructs the library to send information regarding its parameters to the initiator. The table below shows the CDB for the INQUIRY command. Table 4-1: Inquiry Command–12h Bits Byte Obsolete a. These bits are ignored. Table 4-2: Inquiry Command Field Values Values Field Name...
  • Page 17: Command Response

    Command Response Table 4-3: Standard Inquiry Data Format Bits Byte Peripheral Qualifier Obsolete Obsolete SCCS BQue EncServ RelAdr Obsolete (MSB) (MSB) (MSB) (MSB) Reserved Chapter 4. Inquiry—12h Peripheral Device Type Reserved Version = 05h NormACA HiSup Additional Length (n-4) ALUA MultiP MChngr WBus16...
  • Page 18: Table 4-4: Standard Inquiry Data Field Values

    QAS, and IUS in Byte 56. SCCS The library does not contain an embedded storage array controller component. No access controls coordinator may be addressed through this logical unit. The SCSI target device does not support asymmetric logical unit access or vendor-specific ALUA asymmetric access.
  • Page 19 Table 4-4: Standard Inquiry Data Field Values Value Field Name Returned Meaning The library does not support wide SCSI addressing. Addr16 Direct-attach drives support wide SCSI addressing. RelAdr The library does not support relative addressing. The library does not support 16-bit wide transfers. WBus16 Direct-attach drives support 16-bit wide transfers.
  • Page 20: Table 4-5: Supported Pages Page

    In the INQUIRY command, when the EVPD is 1 and the Page Code is 00h, the Command Response is a Supported Pages page. Table 4-5: Supported Pages Page Bits Byte Peripheral Qualifier Table 4-6: Serial Number Page Bits Byte Peripheral Qualifier 04-23 Chapter 4.
  • Page 21: Table 4-7: Serial Number Page Field Values

    Table 4-7: Serial Number Page Field Values Value Field Name Returned Peripheral Qualifier 000b Peripheral Device Type Page Code Page Length Varies Serial Number Varies The serial number can be up to 20 characters in length. Chapter 4. Inquiry—12h Meaning The library is a single LUN device.
  • Page 22: Table 4-8: Library Identification Page

    Table 4-8: Library Identification Page Bits Byte Peripheral Qualifier Reserved Reserved 08 - 15 16 - 31 32 - 41 46 - 53 Applicable only to Fibre Channel, Gigabit Ethernet, NDMP, and iSCSI libraries. These will not be reported on SCSI interface systems. Chapter 4.
  • Page 23: Table 4-9: Serial Number Page Field Values

    Table 4-9: Serial Number Page Field Values Value Field Name Returned Peripheral Qualifier 000b Peripheral Device Type Page Code Page Length Code Set Identifier Type Identifier Length Serial Number Variable Vendor Identification SPECTRA Product Identification PYTHON World Wide Name Variable The serial number can vary between two and seven digits in length.
  • Page 24: Chapter 5. Mode Select-15H

    Mode Select—15h Command Description The MODE SELECT command allows the initiator to change device parameters of the library. An initiator uses these parameters to configure the library after power-up or a bus device reset message. The library parameters that can be set with MODE SELECT are as follows: •...
  • Page 25: Table 5-1: Mode Select Command-15H

    To change parameter values, send a MODE SELECT command, followed by a mode parameter list in the Data Out phase. Table 5-1 shows the CDB for the MODE SELECT command. Table 5-1: Mode Select Command–15h Bits Byte Obsolete These bits are ignored. Table 5-2: Mode Select Command Field Values Values Field Name...
  • Page 26 Mode Parameter Lists Following the command block, in the data out phase, the initiator sends a parameter list containing the new parameter values of the library. This parameter list has the same format as the data the library returns to a MODE SENSE command. The parameter list is accompanied by the parameter list header (See Table 6-3 on page 29).
  • Page 27: Chapter 6. Mode Sense-1Ah

    Mode Sense—1Ah Command Description The MODE SENSE command asks the library to report its operating mode parameters to the initiator. The parameters are returned in mode pages. The library supports the following pages: • Element address assignments—1Dh • Tape picker capabilities (transport geometry parameters)—1Eh •...
  • Page 28: Table 6-2: Mode Sense Command Field Values

    Table 6-2: Mode Sense Command Field Values Field Name Values Allowed DBD (Disable Block 0 or 1 Descriptors) Page Control Page Code Allocation Length 00-FFh Chapter 6. Mode Sense—1Ah Meaning The library does not return block descriptors even if requested to do so. This is not an error condition.
  • Page 29: Command Response

    Command Response If all mode pages are requested, the library returns 48 bytes of mode sense data to the initiator, structured as follows: • 4 bytes of parameter list header data • 20 bytes of element address assignments • 4 bytes of transport geometry descriptors •...
  • Page 30: Table 6-4: Element Address Assignments Page-1Dh

    Parameter List Length (following this byte)(12h) Medium Transport Element Address (default=0001h) Number of Medium Transport Elements 01h for all T-Series and 50-Series libraries First Storage Element Address(default=1000h) Number of Storage Elements (depends on partition size) First Import/Export Element Address (default=0010h)
  • Page 31: Table 6-5: Transport Geometry Parameter Page-1Eh

    Transport Geometry Parameters The transport geometry parameter page identifies that the tape picker does not rotate media. Table 6-5: Transport Geometry Parameter Page–1Eh Bits Byte PS–0 Reserved Note: These values cannot be modified with the MODE SELECT command. The Rotate (byte 02, bit 0) field identifies the ability of the picker to handle two-sided media. The library uses only one-sided media, so the value returned for this bit is 0.
  • Page 32: Table 6-6: Device Capabilities Fields Format-1Fh

    Device Capabilities The device capabilities mode page is described in the table below. Table 6-6: Device Capabilities Fields Format–1Fh Bits Bytes PS–0 Reserved Reserved (0) Reserved (0) Reserved (0) Reserved (0) Reserved (0) 08 - 11 Reserved (0) 16 - 19 Chapter 6.
  • Page 33 DT: Data transfer element (tape drive) IE: Import/export element (TAP) ST: Storage element (magazine slot) MT: Medium transport element (tape picker) Stor: A value of 1 in a StorXX bit indicates media can be stored at elements of type XX.
  • Page 34: Chapter 7. Move Medium-A5H

    Move Medium—A5h Command Description The MOVE MEDIUM command asks the library to move media from one element location to another. The locations are identified by their element addresses. The MODE SENSE data contains a matrix with the valid element source-destination combinations for the MOVE MEDIUM command, as described in Table 6-6: Device Capabilities Fields Format–1Fh on page 32.
  • Page 35: Table 7-2: Move Medium Command Field Values

    Table 7-2: Move Medium Command Field Values Values Field Name Allowed Transport Element Address Varies Source Address Varies Destination Address Varies Invert Permitted values for the Transport Element, Source, and Destination Addresses can be changed with the MODE SELECT command. Use the MODE SENSE command to determine element address settings.
  • Page 36: Chapter 8. Prevent/Allow Medium Removal-1Eh

    Prevent/Allow Medium Removal—1Eh Command Description The PREVENT/ALLOW MEDIUM REMOVAL command determines whether the library permits the removal of data cartridges through the import/export ports. Table 8-1: Prevent/Allow Medium Removal Command–1Eh Bits Byte Obsolete These bits are ignored. Table 8-2: Prevent/Allow Medium Removal Command Values Field Name Values Allowed Prevent...
  • Page 37: Chapter 9. Read Element Status-B8H

    Read Element Status—B8h Command Description The READ ELEMENT STATUS command requests that the library return the status of the selected elements in the library. An element’s status includes its element address, element type, whether it contains media, and whether it is in an abnormal state. If the VolTag command option is set, media bar code information is also returned.
  • Page 38: Table 9-2: Read Element Status Command Values

    Set to 1 to have the library return bar code label (volume tag) information. Return status for all element types. Return status only for the medium transport element. Return status only for storage elements. Return status only for import/export elements. Return status only for data transfer elements.
  • Page 39: Command Response

    Command Response In the data in phase, the library sends element status data in the format defined by the SPC-3 Standard. This data consists of the following: • Element Status Data Header (8 bytes), as shown in Table 9-3 below. •...
  • Page 40: Table 9-4: Element Status Data Header Field Values

    Table 9-4: Element Status Data Header Field Values Field Name Value Returned First Element Address Varies Reported Number of Elements Varies Reported Byte Count of All Varies Element Status Pages The Element Status Data Header is followed immediately by Element Status Pages for each element type reported.
  • Page 41: Element Descriptors

    Field Name Returned Meaning Descriptors in this page are for the medium transport element. Descriptors in this page are for storage elements. Element Type Code Descriptors in this page are for import/export elements. Descriptors in this page are for data transfer elements.
  • Page 42: Table 9-7: Medium Transport Element Descriptor (Tape Picker)

    Chapter 9. Read Element Status—B8h Element Address (default = 0001h) Reserved Reserved Additional Sense Code Additional Sense Code Qualifier Reserved Reserved Source Storage Element Address Primary Volume Tag Information (Field omitted if PVolTag=0) Reserved (LSB) Except Reserved Full (LSB) (LSB)
  • Page 43: Table 9-8: Medium Transport Element Descriptor Fields

    Indicates that the value in the Source Storage Element Address field is valid. Indicates that the value in the Source Storage Element Address field is not valid. This bit is always 0 because T-Series and 50-Series libraries do not invert cartridges.
  • Page 44: Storage Elements

    Storage Elements The slots in the T-Series and 50-Series libraries’ data cartridge magazines are the storage elements. Table 9-9: Storage Element Descriptor (Magazine Slots) Bits Byte (MSB) 06 - 08 SValid Invert–0 (MSB) (MSB) 12 - 47 48 -51 Reserved (Field moved to [12-15] if Primary Volume Tag Information field is omitted.) Chapter 9.
  • Page 45: Table 9-10: Storage Element Fields

    Indicates that the value in the Source Storage Element Address field is valid. SValid (Source Valid) Indicates that the value in the Source Storage Element Address field is not valid. Invert This bit is always 0 because T-Series and 50-Series libraries do not invert cartridges.
  • Page 46: Data Transfer Elements

    Reserved Access Reserved Additional Sense Code Additional Sense Code Qualifier Obsolete Obsolete Reserved Obsolete Reserved Reserved Source Storage Element Address Primary Volume Tag Information (Field omitted if PVolTag=0) Reserved Reserved Reserved Identifier Length Identifier (Field omitted if DVCID=0) (LSB) Except...
  • Page 47: Table 9-12: Data Transfer Element Descriptor Fields

    ASCII representation of the drive serial number. Indicates that the value in the Source Storage Element Address field is valid. Indicates that the value in the Source Storage Element Address field is not valid. T-Series and 50-Series libraries do not invert cartridges.
  • Page 48 Chapter 9. Read Element Status—B8h Meaning This field is the cartridge’s last storage element address. If the PVolTag bit in the data header is 1, this field (in ASCII format) contains the bar code (volume tag) information for the cartridge occupying this element.
  • Page 49: Table 9-13: Import/Export Element Descriptor

    Element Address (Default = 0010h) InEnab ExEnab Access Reserved Additional Sense Code Additional Sense Code Qualifier Reserved Source Storage Element Address . . . Primary Volume Tag Information (Field omitted if PVolTag=0) . . . Reserved Reserved Reserved Identifier Length (X) Identifier .
  • Page 50: Table 9-14: Import/Export Element Fields

    ASCQ returned to the REQUEST SENSE command. See Chapter 15. Error Reporting. Indicates that the value in the Source Storage Element Address field is valid. Indicates that the value in the Source Storage Element Address field is not valid. T-Series and 50-Series libraries do not invert cartridges.
  • Page 51 Tag Information The Range of Values is supported by the MODE SELECT command. All Storage Element Addresses in the library report access by the robotic tape picker. See Chapter 15. Error Reporting for supported ASC and ASCQ values. The library only supports the first 10 characters of a bar code. If the bar code is larger than 10 characters, only the first 10 characters will be reported.
  • Page 52: Chapter 10. Release-17H

    10 Release—17h Command Description The RELEASE command enables the initiator to release reservations on the library or library elements that were set by the RESERVE (16h) command. See the RESERVE Command Description on page 57 for more information. Only the initiator that reserved the library or its elements can release them. If another initiator attempts to release a reserved library or its elements, the library returns a RESERVATION CONFLICT status.
  • Page 53: Table 10-2: Release Command Field Values

    Device ID Element Reservation ID Varies Any valid storage slot in the library reported by the MODE SENSE command. You cannot reserve an Import/Export, Medium Transport, or Data Transfer Element. Chapter 10. Release—17h Meaning RELEASE is not being requested for a third-party reservation.
  • Page 54: Chapter 11. Request Sense-03H

    11 Request Sense—03h Command Description The REQUEST SENSE command requests the library to send sense data to the initiator. It is generally issued immediately after the library reports a CHECK CONDITION status for the previous command. The table below shows the CDB for the REQUEST SENSE command. Table 11-1: Request Sense Command–03h Bits Byte...
  • Page 55: Command Response

    Command Response The sense data is valid for the CHECK CONDITION status just presented to the initiator. This sense data is preserved in the library for the initiator receiving the CHECK CONDITION status. Sense data is cleared when any subsequent command that is not a REQUEST SENSE or an INQUIRY (12h) command is received from the initiator.
  • Page 56: Table 11-3: Sense Data Fields

    Table 11-3: Sense Data Fields Field Name Value Returned Valid Error Code Sense Key General Error Category Chapter 15. Error Reporting for more information. Additional Sense Length Additional Sense Varies Code (ASC) Additional Sense Varies Code Qualifier (ASCQ) Field Replaceable Unit Code SKSV ASCII Representation...
  • Page 57: Chapter 12. Reserve-16H

    12 Reserve—16h Command Description The RESERVE command allows the initiator to reserve either the whole library or specific elements. Reserving the whole library or a specific element will prevent another user from moving media to the import/export element (the TAP) of the library via the library’s control panel.
  • Page 58: Table 12-3: Element List Descriptor Format

    Table 12-2: Reserve Command Field Values Values Field Name Allowed Meaning Requests reservation of entire library. If the library or any of its elements is reserved by another initiator, the library rejects this command with a RESERVATION CONFLICT message. Element Requests reservation of specific element addresses in the library.
  • Page 59: Chapter 13. Send Diagnostic-1Dh

    13 Send Diagnostic—1Dh Command Description The SEND DIAGNOSTIC command requests that the library perform diagnostic tests on itself. T-Series and 50-Series libraries support only the Default Self-Test feature (SelfTest bit = 1 and Parameter List Length = 0). Table 13-1 (below) shows the CDB for the SEND DIAGNOSTIC command.
  • Page 60: Command Response

    Table 13-2: Send Diagnostic Command Field Values Field Name Values Allowed SelfTest Code (Page Format) SelfTest DevOfL (Device Off-Line) UnitOfL (Unit Off-Line) Parameter List 0-FFFFh Length Command Response There is no data returned from the SEND DIAGNOSTIC command. If the command is successful, a GOOD status is returned.
  • Page 61: Chapter 14. Test Unit Ready-00H

    14 Test Unit Ready—00h Command Description The TEST UNIT READY command determines if the library is on and ready to accept commands. Table 14-1: Test Unit Ready Command–00h Bits Byte Obsolete These bits are ignored. Command Response This command returns a GOOD status if the library is ready to accept SCSI commands. This command returns CHECK CONDITION status with UNIT ATTENTION (6h) in the sense key after power-up, after a bus device reset message is sent to the library, and after a power-on reset, or a CHECK CONDITION with appropriate sense key for the error conditions.
  • Page 62: Chapter 15. Error Reporting

    15 Error Reporting This section lists the error codes and corresponding meanings that can be returned by the library. Note: For error codes returned by tape drives (medium errors), refer to the tape drive manual for that specific drive type. These manuals can be found on the drive manufacturer’s Web site.
  • Page 63 Chapter 15. Error Reporting Sense Keys Not Used The following sense keys are not used by T-Series and 50-Series libraries: 1h Recovered Error 3h Medium Error 7h Data Protect 8h Blank Check Bh Aborted Command Ch Equal Dh Volume Overflow Eh Miscompare...
  • Page 64: Sense Codes And Qualifiers

    Sense Codes and Qualifiers Combining the Sense Key with the Additional Sense Code (ASC) and Additional Sense Code Qualifier (ASCQ) returned to a REQUEST SENSE command, gives the most complete error description available from the library. The following table describes the error codes returned by the library.
  • Page 65 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Hardware Errors (continued) Chapter 15. Error Reporting Error Description Import/export door could not be retracted. Unit failed initialization. Drive failed to unload. Tape failed load; move marked successful. Drive failed to come ready. Move failed;...
  • Page 66 2. If that fails, manually remove the tape from the slot. 3. If that fails, try to reseat the magazine. If the problem persists, contact Spectra Logic Technical Support. The robot may be misaligned or the tape may be broken (with the tape possibly wrapped around the drive heads).
  • Page 67 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Hardware Errors (continued) Chapter 15. Error Reporting Error Description FPROM write operation failed. General picker definition error. Invalid picker type. Invalid rack type. Invalid library size. Invalid chassis type. Invalid IE door type. Internal SCSI error unknown.
  • Page 68 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Hardware Errors (continued) Chapter 15. Error Reporting Error Description DMA error. Command phase overrun—device demanded more CDB bytes than available. Device supplied excess status bytes. Device did not complete command with Command Complete. Device skipped MSG OUT phase after Selection.
  • Page 69 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Hardware Errors (continued) Chapter 15. Error Reporting Error Description Bad IOQB entry submitted to hardware. Device does not respond—it is powered off, not attached, or non- functional. Interface command queue is full. Device operation did not complete for unknown reason.
  • Page 70 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Hardware Errors (continued) Chapter 15. Error Reporting Error Description CAN sequence error. Data overrun sequence error. Data under-run sequence error. Command under-run sequence error. Invalid CAN command during code load. Invalid CAN address during code load. Invalid CAN from address during code load.
  • Page 71 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Illegal Request Chapter 15. Error Reporting Error Description Operation in progress. The initiator is trying to initiate an additional command to the target device before the first command is complete. Parameter list length error. Invalid command code.
  • Page 72 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Illegal Request (continued) Chapter 15. Error Reporting Error Description Unsupported segment descriptor type code. Unexpected inexact segment. Inline data length exceeded. Invalid operation for copy source or destination. Command sequence error. FLASH code download to tape drive via Write Buffer failed.
  • Page 73 Exit Only; it can export tapes but not import them. 1. If you wish to use the software to import tapes from the TAP to the storage slots, you must disable the Queued Unloads option. 2. In a multi-partition library, you must...
  • Page 74 TAP when Queued Unloads is enabled AND when the source slot is not an actual storage slot. Possible initial source slot moves that cause this error include moving a tape to a...
  • Page 75 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Unit Attention Chapter 15. Error Reporting Error Description Inventory possibly altered. Door element accessed. A reset has occurred. Drive failed power-on self test (POST) or user issued diagnostic test. This is a Sony-unique error code. Mode parameters have changed.
  • Page 76 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Vendor- Specific Chapter 15. Error Reporting Error Description Bar code label is unread. Problem reading bar code. Tape is queued for unload. No response from SCSI target. Check unexpected condition from target.
  • Page 77 Table 15-2: Library SCSI Error Codes Sense Key ASCQ Copy Aborted Chapter 15. Error Reporting Error Description Third party device failure— hardware failure of the target device. Copy target device not reachable— device is not responding after having been found. Incorrect copy target device type—...
  • Page 78: Appendix A Extended Copy-83H143R1 Specifications

    Appendix A Extended Copy—83h— Fibre Channel Command Description Note: The EXTENDED COPY command is not supported by SCSI. The EXTENDED COPY command (Table A-1 on page 79) provides a means to copy data from one set of logical units to another or to the same set of logical units. The device server that receives and performs the EXTENDED COPY command is called the copy manager.
  • Page 79: Table A-1: Extended Copy Command (143R1 Specifications)

    Table A-1: Extended Copy Command (143r1 Specifications) Byte (MSB) Before the copy manager is instructed to move data, the application controlling the data movement will independently execute any activities necessary to prepare the devices for the EXTENDED COPY command; these activities include media changer commands, loading tapes, MODE SELECT commands, positioning tape, etc.
  • Page 80: Table A-2: Extended Copy Parameter List

    descriptors, followed by one or more segment descriptors, then followed by any optional inline data. Table A-2: Extended Copy Parameter List Byte Reserved (MSB) The List ID field is a user-defined value that is used by the copy manager to return status for that command.
  • Page 81: Table A-3: Extended Copy Descriptor Codes

    descriptor code. A copy manager need not support all target descriptor codes for its device type. The target descriptors will be indexed in ascending order beginning with 0 to a maximum of 65535. See Target Descriptors on page 85 for a detailed description of the target descriptors.
  • Page 82 Table A-3: Extended Copy Descriptor Codes Peripheral Device Type (Note 5) Source Destination Block devices Stream devices (Device types 0,4,5,7) (Device types 1,3,9) Stream devices Block devices (Device types 1,3,9) (Device types 0,4,5,7) Block devices Block devices (Device types 0,4,5,7) (Device types 0,4,5,7) Stream devices Stream devices...
  • Page 83 Appendix A. Extended Copy—83h—143r1 Specifications CONDITION; the sense key is set to ILLEGAL REQUEST and the ASC and ASCQ indicate INCORRECT PARAMETER LIST LENGTH. The Priority field of the EXTENDED COPY parameter list establishes the relative priority of this EXTENDED COPY command to other commands being executed by the same copy manager.
  • Page 84 Errors Detected During Execution of Segment Descriptors Errors may occur after the copy manager has begun executing segment descriptors. These include invalid parameters in segment descriptors, invalid segment descriptors, unavailable targets referenced by segment descriptors, inability of the copy manager to continue operating, and errors reported by source or destination target devices.
  • Page 85: Target Descriptors

    Target Descriptors All target descriptors begin with a four-byte header that contains the Descriptor Type Code field. The Descriptor Type Code identifies the format of the descriptor. The assigned values for target descriptors type codes are shown in Table A-4. Table A-4: Target Descriptor Format Byte Reserved...
  • Page 86: Table A-6: World Wide Name Target Descriptor Format

    its Mode Sense Page 0Eh. If the number of target descriptors exceeds the allowed number, the copy manager terminates the command with a CHECK CONDITION; the sense key is set to ILLEGAL REQUEST, and the ASC and ASCQ indicate TOO MANY TARGET DESCRIPTORS. World Wide Name Target Descriptor Format The target descriptor format shown in Table A-6 may be used to identify targets using their World Wide Names.
  • Page 87: Table A-7: N_Port D_Id Target Descriptor Format

    The Address Type is 0, and Bytes 4-11 of the target descriptor are defined as the World Wide Name for the target device. The Device Type Field is as identified in Target Descriptors on page 85. The Logical Unit Number field specifies the LUN for the target device. The Device-Type Specific field is defined in Target Descriptor Device-Specific Fields on page 90.
  • Page 88: Table A-8: World Wide Name Target Descriptor Format

    The Address Type is 1, and Bytes 5-7 of the target descriptor are defined as the N_PORT D_ID for the target device. The Device Type Field is as identified in Target Descriptors on page 85. The Logical Unit Number field specifies the FCP LUN for the target device. The Device-Type Specific field is defined in Target Descriptor Device-Specific Fields on page 90.
  • Page 89 Table A-8: World Wide Name Target Descriptor Format Byte (MSB) The Address Type is 2, and Bytes 5-7 of the target descriptor are defined as the N_PORT D_ID for the target device. The D_ID field is the 24-bit (3-byte) Destination Identifier field that is used to actually route the commands through a fabric.
  • Page 90: Table A-9: Scsi B_T_L Target Descriptor Format

    SCSI B_T_L Target Descriptor Format Targets identified using their SCSI Bus, Target ID, and LUN are identified using the target descriptor format shown in Table A-9. The Descriptor Type Code for this descriptor is E3h. Table A-9: SCSI B_T_L Target Descriptor Format Byte Reserved The Address Type is 3.
  • Page 91: Table A-10: Device-Specific Field - Device Type 00H

    Device-specific information is currently defined for device types 00h and 01h. Device- specific information for device types other than 00h and 01h are not yet defined. Until device-specific information is defined for these other types, all block devices will use device-specific information of type 00h and all stream devices will use the device- specific information of type 01h.
  • Page 92: Table A-12: Tape Transfer Lengths

    For stream devices (Device Type 01h), the Fixed Bit and Tape Block Length fields in the device-specific information are combined with the Device Transfer Length field in the segment descriptor to determine the length of the stream data transfer (see Table A-12 on page 92).
  • Page 93: Segment Descriptors

    Segment Descriptors All segment descriptors begin with an eight-byte field as shown in Table A-13. Table A-13: Segment Descriptor Header Byte (MSB) (MSB) The first byte of the segment descriptor is the descriptor type code field which is used to describe the operation for the segment. A list of defined segment descriptor type codes can be found in Table A-3 on page 81.
  • Page 94: Table A-14: Pad Bit And Cat Bit Interaction

    Table A-14: PAD Bit and CAT Bit Interaction SRC PAD DST PAD The Descriptor Length provides the length in bytes of the current segment descriptor. The length is defined as the actual length of the descriptor minus four. The Descriptor Length does not include any embedded data where applicable.
  • Page 95: Table A-15: Segment Descriptor For Codes 00H, 01H, 0Bh, And 0Ch

    Block Device to Stream Device Operation Descriptor Code 00h The segment descriptor format for EXTENDED COPY transfers from a block device to a stream device is shown in Table A-15. This format is required for EXTENDED COPY descriptor code 00h. The field definitions for the first eight bytes are as defined in Target Descriptors on page 85.
  • Page 96 Appendix A. Extended Copy—83h—143r1 Specifications The Block Device Number of Blocks field specifies the number blocks in the current segment to be copied. A value of 0 indicates that no blocks will be transferred in this segment; this will not be considered an error. The Block Device Logical Block Address field specifies the starting address on the logical unit for this segment.
  • Page 97: Table A-16: Segment Descriptor For Codes 02H And 0Dh

    Block Device to Block Device Operation Descriptor Code 02h The segment descriptor format for EXTENDED COPY transfers between block devices is shown in Table A-16. This format is required for EXTENDED COPY descriptor code 02h. The field definitions for the first eight-bytes are as defined in Segment Descriptors on page Table A-16: Segment Descriptor for Codes 02h and 0Dh Byte (MSB)
  • Page 98: Table A-17: Segment Descriptor For Codes 03H And 0Eh

    The DC bit is used to indicate whether the Block Device Number of Blocks field refers to the source or destination logical unit. A DC bit of 0 indicates that the Block Device Number of Blocks field refers to the source logical unit. A DC bit of 1 indicates that the Block Device Number of Blocks field refers to the destination logical unit.
  • Page 99 Table A-17: Segment Descriptor for Codes 03h and 0Eh Byte (MSB) The Source Device Transfer Length specifies the amount of data to be read from the source stream device on each read operation. See Table A-12 on page 92 for information on how the segment descriptor Source Device Transfer Length interacts with the Tape Block Length Parameter of the device-specific information.
  • Page 100: Table A-18: Segment Descriptor For Code 04H

    Inline Data to Stream Device Operation Descriptor Code 04h The segment descriptor format for EXTENDED COPY operation that moves inline data to a stream device is shown in Table A-18. This format is required for EXTENDED COPY descriptor code 04h. The field definitions for the first eight-bytes are as defined in Segment Descriptors on page 93, except for Bytes 4 and 5, which are reserved instead of having the Source Target Identifier.
  • Page 101: Table A-19: Segment Descriptor For Code 05H

    processed in a sequential manner from first to last to ensure that the inline data at the end of the parameter list is properly assigned. Inline data must begin on and should be padded up to a four-byte boundary. The Number of Bytes field indicates the actual data length, not including any PAD bytes.
  • Page 102 Table A-19: Segment Descriptor for Code 05h Byte The Destination Device Transfer Length specifies the amount of data to be written to the destination stream device on each write operation. See Table A-12 on page 92 for information on how the segment descriptor Device Transfer Length interacts with the Tape Block Length Parameter of the device-specific information.
  • Page 103: Table A-20: Segment Descriptor For Codes 06H And 0Fh

    Stream Device to Discard Operation Descriptor Code 06h The segment descriptor format for EXTENDED COPY operation that discards data from a stream device is shown in Table A-20. This format is required for EXTENDED COPY descriptor code 06h. The field definitions for the first eight bytes are as defined in Segment Descriptors on page 93, except for Bytes 6 and 7, which are reserved instead of having the Destination Target Identifier.
  • Page 104: Table A-21: Segment Descriptor For Code 07H

    Verify Target Operation Descriptor Code 07h The segment descriptor format for EXTENDED COPY operation that verifies the existence of a block or stream device is shown in Table A-21. This format is required for EXTENDED COPY descriptor code 07h. The field definitions for the first eight-bytes are as defined in Segment Descriptors on page 93, except for Bytes 6 and 7, which are reserved instead of having the Destination Target Identifier.
  • Page 105: Table A-22: Segment Descriptor For Code 10H

    Write Filemarks Operation Descriptor Code 10h The segment descriptor format for the EXTENDED COPY write filemarks operation is shown in Table A-22. This format is required for EXTENDED COPY descriptor code 10h. Table A-22: Segment Descriptor for Code 10h Byte (MSB) (MSB) The WRITE FILEMARKS operation constructs a WRITE FILEMARKS command using the WSmk and...
  • Page 106: Table A-23: Segment Descriptor For Code 11H

    SPACE Operation Descriptor Code 11h The segment descriptor format for EXTENDED COPY SPACE operation shown in Table A-23. This format is required for EXTENDED COPY descriptor code 11h. Table A-23: Segment Descriptor for Code 11h Byte (MSB) (MSB) The SPACE operation constructs a SPACE command using the Code and Count fields from the segment descriptor in the corresponding command fields of the SPACE command that is issued to the target device.
  • Page 107: Mode Sense Page For Extended Copy Command

    command that is issued to the target device. All other fields of the issued command are set to 0. Table A-24: Segment Descriptor for Code 12h Byte (MSB) (MSB) Mode Sense Page for Extended Copy Command MODE SENSE information pertaining to the operation of the EXTENDED COPY command’s copy manager is obtained from the copy manager using the 0Eh MODE SENSE page shown in Table A-25 on page 108.
  • Page 108: Table A-25: Mode Sense Page For Extended Copy Command

    The Maximum Segment Length Indicates the length, in bytes, of the largest amount of data that can be specified in a single segment (0xFFFFFFFF). Maximum Outbound Inline Data Length Indicates the length, in bytes, of the largest amount of inline data that can be included after the EXTENDED COPY parameter list; this does not include data included as embedded data within the segment descriptors.
  • Page 109 Appendix A. Extended Copy—83h—143r1 Specifications Table A-25: Mode Sense Page for Extended Copy Command Byte (MSB) (MSB) (MSB) (MSB) (MSB) (MSB) Maximum Inbound Inline Data Length (Buffered) (MSB) Maximum Inbound Inline Data Length (Non-Buffered) Maximum Target Descriptor Count Maximum Segment Descriptor Count Maximum Descriptor List Length Maximum Segment Length Maximum Outbound Inline Data Length...
  • Page 110: Sense Key Specific Field Changes

    Table A-25: Mode Sense Page for Extended Copy Command Byte 33 + n Sense Key Specific Field Changes The Sense Key Specific field as defined to support the EXTENDED COPY command is shown in Table A-26. Table A-26: Segment Pointer Bytes Byte SKSV (MSB)
  • Page 111: Receive Copy Results Command

    Receive Copy Results Command The RECEIVE COPY RESULTS command is used to return the results of a previous (or current) EXTENDED COPY command. The results that can be returned from the previous (or current) EXTENDED COPY command are either copy manager status information, inline data from read operations, or information about the order in which the segments were processed during the EXTENDED COPY command.
  • Page 112: Table A-28: Mode Field Definitions

    CHECK CONDITION. The Sense Key is set to ILLEGAL REQUEST, and the ASC and ASCQ indicate INVALID FIELD IN CDB. Table A-28: Mode Field Definitions Mode Value Receive Copy Results Operation Return the current Copy Status of the executing EXTENDED COPY command identified by List ID. Return the Inline data read by EXTENDED COPY command identified by List ID.
  • Page 113 ensure that the data is not discarded by the copy manager. The copy manager will discard the Segment Order List: • After it has been successfully transferred to the host; • When a RECEIVE COPY RESULTS command is issued by the same host for the same List ID, with mode set to 2 (Segment Order List) and the allocation length set to 0;...
  • Page 114: Table A-29: Return Data Format - Mode 0 (Status)

    Copy Status Mode When the Mode field is set to return copy results, the copy manager returns the current status of the EXTENDED COPY command identified by the List ID field. Table A-29 shows the format of the information returned by the copy manager in response to a request for Copy Status.
  • Page 115: Table A-31: Transfer Count Format

    The Transfer Count Format field specifies the format of the transfer count. The Transfer Count Format is coded as shown in Table A-31. Table A-31: Transfer Count Format Transfer Count Format Value The Transfer Count field specifies the amount of data transferred by the EXTENDED COPY command prior to receiving the request for copy status.
  • Page 116: Appendix B Extended Copy-83H-Spc2 Specifications

    Appendix B Extended Copy—83h— Fibre Channel Command Description Note: The EXTENDED COPY command is not supported by SCSI. The EXTENDED COPY command (Table B-1 on page 117) provides a means to copy data from one set of logical units to another or to the same set of logical units. The entity within a device server that receives and performs the EXTENDED COPY command is called the copy manager.
  • Page 117 Table B-1: Extended Copy Command (SPC2 Specifications) Byte (MSB) Before the copy manager is instructed to move data, the application controlling the data movement will independently execute any activities necessary to prepare the devices for the EXTENDED COPY command; these activities include media changer commands, loading media, MODE SELECT commands, positioning media, etc.
  • Page 118: Table B-2: Extended Copy Parameter List

    target descriptors, followed by one or more segment descriptors, followed by any optional inline data. Table B-2: Extended Copy Parameter List Byte Reserved (MSB) (MSB) (MSB) n-31 The List Identifier field is a unique value selected by the application client to identify the EXTENDED COPY operation to the copy manager.
  • Page 119 Appendix B. Extended Copy—83h—SPC2 Specifications CONDITION status; the sense key is set to ILLEGAL REQUEST, and the ASC and ASCQ indicate OPERATION IN PROGRESS. The Priority field establishes the priority of this EXTENDED COPY command relative to other commands being executed by the same device server. All commands other than copy commands have a priority of 1.
  • Page 120 The Inline Data Length field contains the number of bytes of inline data, after the last segment descriptor. A value of zero indicates that no inline data is present. The copy manager will move data from the source devices to the destination devices in the manner prescribed by the segment descriptors.
  • Page 121 Appendix B. Extended Copy—83h—SPC2 Specifications field, and the valid bit will be set to 1. If the segment descriptor specifies a transfer count in blocks, then the residual count is the number of blocks remaining for transfer; otherwise, the residual count is the number of bytes remaining for transfer.
  • Page 122: Table B-3: Extended Copy Descriptor Type Codes

    Abort Task Management Functions When a device server processes an ABORT TASK, ABORT TASK SET, or CLEAR TASK SET task management function that terminates an EXTENDED COPY command, the copy manager will ensure that all commands and data transfers generated by the terminated EXTENDED COPY command have been terminated and are no longer transferring data before allowing the task manager to complete the task management function.
  • Page 123 Table B-3: Extended Copy Descriptor Type Codes Descriptor Type Code Reference Write Filemarks Operation on page 149 Space Operation on page Locate Operation on page 151 15h-BFh C0h-DFh E5h-FFh Block devices are those with peripheral device type codes 0h, 4h, 5h, 7h, and Eh. Stream devices are those devices with peripheral device type codes 1h and 3h.
  • Page 124: Table B-4: Target Descriptor Format

    Target Descriptors All target descriptors are 32 bytes in length and begin with a four-byte header (see Table B-4 on page 124) that contains the Descriptor Type Code field, which identifies the format of the descriptor. The assigned values for target descriptors type codes are shown in Table B-3 above.
  • Page 125: Table B-5: Device Type Specific Parameters In Target Descriptors

    The value in the Descriptor Type Code field determines the format of the target descriptor parameters that follow the four-byte header and precede the device type specific parameters. The values in the Descriptor Type Code field are listed in Table B-3 on page 122. The value in the Peripheral Device Type field determines the format of the device type specific parameters that follow the target descriptor parameters.
  • Page 126: Table B-7: N_Port Target Descriptor Format

    Table B-6: World Wide Name Target Descriptor Format Byte The Descriptor Type Code, Peripheral Device Type and NUL fields and the device type specific parameters are described in Target Descriptors on page 124. The Logical Unit Number field specifies the logical unit within the SCSI device addressed by the data in the World Wide Name field that will be the target (source or destination) for EXTENDED COPY operations.
  • Page 127: Table B-8: N_Port With World Wide Name Checking Target Descriptor Format

    Table B-7: N_Port Target Descriptor Format Byte (MSB) The Descriptor Type Code, Peripheral Device Type and NUL fields and the device type specific parameters are described in Target Descriptors on page 124. The Logical Unit Number field specifies the logical unit within the SCSI device addressed by the data in the N_PORT field that will be the target (source or destination) for EXTENDED COPY operations.
  • Page 128: Table B-9: Parallel Interface T_L Target Descriptor Format

    Table B-8: N_Port with World Wide Name Checking Target Descriptor Format Byte The Descriptor Type Code, Peripheral Device Type and NUL fields and the device type specific parameters are described in Target Descriptors on page 124. The Logical Unit Number field specifies the logical unit with in the SCSI device addressed by the data in the N_Port and World Wide Name and fields that will be the target (source or destination) for EXTENDED COPY operations.
  • Page 129: Table B-10: Identification Descriptor Target Descriptor Format

    Table B-9: Parallel Interface T_L Target Descriptor Format Byte (MSB) The Descriptor Type Code, Peripheral Device Type and NUL fields and the device type specific parameters are described in Target Descriptors on page 124. The Logical Unit Number field specifies the logical unit with in the SCSI device addressed by the data in the Target Identifier field that will be the target (source or destination) for EXTENDED COPY operations.
  • Page 130: Table B-11: Device Type Specific Target Descriptor Parameters For Block Device Types

    Table B-10: Identification Descriptor Target Descriptor Format Byte Reserved (MSB) The Descriptor Type Code, Peripheral Device Type and NUL fields and the device type specific parameters are described in Target Descriptors on page 124. The identifier length will be 20 or less. If the identifier length is 20, there will be no reserved bytes between the target descriptor parameters and the device type specific parameters.
  • Page 131: Table B-12: Device Type Specific Target Descriptor Parameters For Stream Device Types

    The PAD bit is used in conjunction with the CAT bit (see Segment Descriptors on page 133) in the segment descriptor to determine what action should be taken when a segment of the copy does not fit exactly into an integer number of destination blocks. The Disk Block Length field contains the number of bytes in a disk block for the logical device being addressed.
  • Page 132: Table B-14: Device Type Specific Target Descriptor Parameters For Processor Device Types

    The PAD bit is used in conjunction with the CAT bit (see Segment Descriptors on page 133) in the segment descriptor to determine what action should be taken when a segment of the copy does not fit exactly into an integer number of destination blocks. All read commands issued to sequential-access type devices will have the SILI bit equal to zero.
  • Page 133: Table B-15: Segment Descriptor Header Format

    The destination count (DC) bit is used in those segment descriptors where both the source and destination devices have the same storage structure (block or stream). The DC bit is only applicable to segment descriptors with descriptor type code values of 02h, 03h, 0Dh, and 0Eh.
  • Page 134: Table B-16: Descriptor Type Code Dependent Copy Manager Processing

    1. Just enough whole-block read operations will be performed to supply (together with residual source data from the previous segment or segments) the number of bytes to be processed; 2. Processing consists of removing bytes from the source data and designating them as destination data, without change.
  • Page 135 Table B-16: Descriptor Type Code Dependent Copy Manager Processing Segment Descriptor Type Code 06h (stream -> discard) 07h (verify device operation) 10h (filemark -> tape) 11h (space -> tape) 12h (locate -> tape) 14h (register key) 08h (block<o> -> stream) 0Ah (block<o>...
  • Page 136: Table B-17: Pad And Cat Bit Definitions

    Table B-17: PAD and CAT Bit Definitions Pad Bit in ... Source Destination Target Target Descriptor Descriptor Copy Manager Action Any residual source data will be retained as source data for a subsequent segment descriptor. Any residual destination data will be retained as destination data for a subsequent segment descriptor.
  • Page 137: Table B-18: Block Device To Or From Stream Device Segment Descriptor

    contains an index into the target descriptor list identifying the destination target device. Some segment descriptor formats do not require a Source Target Descriptor Index field or a Destination Target Descriptor Index field, in which case the field is reserved. If the target identified by a Source Target Descriptor Index field or a Destination Target Descriptor Index field is not accessible to the copy manager, then the command will be terminated with a CHECK CONDITION status, the sense key will be set to COPY ABORTED and the...
  • Page 138 Appendix B. Extended Copy—83h—SPC2 Specifications For descriptor type code 00h (block->stream) or descriptor type code 0Bh (block->stream+application client), the copy manager will copy the data from the source block device identified by the Source Target Descriptor Index field to the destination stream device identified by the Destination Target Descriptor Index field using the logical blocks starting at the location identified by the Block Device Logical Block Address field.
  • Page 139 Appendix B. Extended Copy—83h—SPC2 Specifications Stream Device to Block Device Operations The segment descriptor format shown in Table B-18 on page 137 also is used by the copy operations that move data from a stream device to a block device. Two Descriptor Type Code values use the segment descriptor format shown in Table B-18 on page 137 and described in this clause.
  • Page 140: Table B-19: Block Device To Block Device Segment Descriptor

    Block Device to Block Device Operations The segment descriptor format shown in Table B-19 is used by the copy operations that move data from a block device to a block device. Table B-19: Block Device to Block Device Segment Descriptor Byte (MSB) (MSB)
  • Page 141 Appendix B. Extended Copy—83h—SPC2 Specifications Blocks field, and as many writes as possible will be performed using any residual destination data from the previous segment and the data processed in this segment. If the DC bit equals one, the number of blocks specified by the Block Device Number of Blocks field will be written to the destination block device, as many bytes will be processed as necessary for these writes to be performed, and as many blocks will be read as necessary to supply the data to be processed.
  • Page 142: Table B-20: Stream Device To Stream Device Segment Descriptor

    Stream Device to Stream Device Operations The segment descriptor format shown in Table B-20 is used by the copy operations that move data from a stream device to a stream device. Table B-20: Stream Device to Stream Device Segment Descriptor Byte (MSB) (MSB)
  • Page 143: Table B-21: Inline Data To Stream Device Segment Descriptor

    For descriptor type code 0Eh (stream->stream+application client), the copy manager also will hold a copy of the processed data for delivery to the application client upon completion of the EXTENDED COPY command in response to a RECEIVE COPY RESULTS command with RECEIVE DATA service action.
  • Page 144 Table B-21: Inline Data to Stream Device Segment Descriptor Byte (MSB) (MSB) (MSB) (MSB) The Descriptor Type Code field is described in Descriptor Type Codes on page 122 and Segment Descriptors on page 133. Descriptor type code 04h (inline->stream) instructs the copy manager to write inline data from the EXTENDED COPY parameter list to a stream device.
  • Page 145: Table B-22: Embedded Data To Stream Device Segment Descriptor

    The Inline Data Number of Bytes field specifies the number of bytes of inline data that are to be transferred to the stream device. A value of zero will not be considered an error. If the sum of the Inline Data Offset and the Inline Data Number of Bytes values exceeds the value in the Inline Data Length field (see Table B-22), the copy manager will terminate the command with a CHECK CONDITION status.
  • Page 146 Appendix B. Extended Copy—83h—SPC2 Specifications will be written to the destination stream device identified by the Destination Target Descriptor Index field starting at the current position of the stream device. Any residual destination data from a previous segment descriptor will be written before the data of the current segment descriptor.
  • Page 147: Table B-23: Stream Device To Discard Segment Descriptor

    Stream Device to Discard Operation The segment descriptor format shown in Table B-23 instructs the copy manager to read data from a stream device and not copy it to any destination device. Table B-23: Stream Device to Discard Segment Descriptor Byte (MSB) (MSB)
  • Page 148: Table B-24: Verify Device Operation Segment Descriptor

    The Descriptor Length field will contain 12 (000Ch). The Destination Target Descriptor Index field is described in Segment Descriptors on page 133. The Source Stream Device Transfer Length field specifies the amount of data to be read from the source stream device on each read operation. See Device Type Specific Target Descriptor Parameters for Stream Device Types on page 131 for a description of how data in the Source Stream Device Transfer Length field in the segment descriptor interacts with data in the Stream Block Length field in the device type specific target...
  • Page 149: Table B-25: Write Filemarks Operation Segment Descriptor

    will be used to determine the readiness of the device. If a TUR value of one is not supported and the TUR bit contains one, then the EXTENDED COPY command will be terminated with a CHECK CONDITION status. The sense key will be set to COPY ABORTED and the additional sense code will be set to INVALID FIELD IN PARAMETER LIST.
  • Page 150: Table B-26: Space Operation Segment Descriptor

    If the write setmark (WSMK) bit is one, the Transfer Length field specifies the number of setmarks to be written. If the WSMK bit is zero, the Transfer Length field specifies the number of filemarks to be written. Space Operation The segment descriptor format shown in Table B-26 instructs the copy manager to send a SPACE command to the destination tape device.
  • Page 151: Table B-27: Locate Operation Segment Descriptor

    Locate Operation The segment descriptor format shown in Table B-27 instructs the copy manager to send a LOCATE command (see SSC) to the destination tape device. Table B-27: Locate Operation Segment Descriptor Byte (MSB) (MSB) (MSB) The Descriptor Type Code field is described in Descriptor Type Codes on page 122 and Segment Descriptors on page 133.
  • Page 152: Appendix C Receive Copy Results

    Appendix C Receive Copy Results— Fibre Channel Command Description Note: The RECEIVE COPY RESULTS command is not supported by the SCSI. The RECEIVE COPY RESULTS command (Table C-1) provides a means for the application client to receive information about the copy manager or the results of a previous (or current) EXTENDED COPY command (see Appendix B.
  • Page 153: Table C-2: Receive Copy Results Service Action Codes

    The service actions defined for the RECEIVE COPY RESULTS command are shown in Table C-2. Table C-2: Receive Copy Results Service Action Codes Code Name Copy Status Receive Data Operating Parameters Failed Segment Details 05h - 1Eh Not supported. The List Identifier field identifies the EXTENDED COPY command (see Appendix B. Extended Copy—83h—SPC2 Specifications) about which information is desired.
  • Page 154: Table C-3: Parameter Data For The Copy Status Service Action

    service action. If a device server supports the EXTENDED COPY command, then it will also support the RECEIVE COPY RESULTS command with COPY STATUS service action. Table C-3: Parameter Data for the Copy Status Service Action Byte (MSB) (MSB) (MSB) After completion of an EXTENDED COPY command, the copy manager will preserve all data returned by a COPY STATUS service action for a vendor specific period of time.
  • Page 155: Failed Segment Details Service Action

    CDB including the segment currently being processed. This field will be zero if the copy manager has not yet begun processing segment descriptors. The Transfer Count Units field specifies the units for the Transfer Count field as defined in Table C-5. Table C-5: Copy Status Transfer Count Units Values Value Meaning...
  • Page 156: Table C-6: Parameter Data For The Failed Segment Details Service Action

    Table C-6: Parameter Data for the Failed Segment Details Service Action Byte (MSB) (MSB) The application client should issue a RECEIVE COPY RESULTS command with FAILED SEGMENT DETAILS service action immediately following failure of the EXTENDED COPY command to insure that the information is not discarded by the copy manager. The copy manager will discard the failed segment details: 1.
  • Page 157 The Sense Data Length field indicates how many bytes of sense data are present in the Sense Data field. The Sense Data field contains a copy of the sense data that the copy manager prepared as part of terminating the EXTENDED COPY command identified by the list identifier with a CHECK CONDITION status.
  • Page 158: Fibre Channel Command Description

    A SCSI device will support a REPORT LUNS command that is addressed to logical unit zero. Support of the REPORT LUNS command by logical units other than logical unit zero is not supported. The REPORT LUNS command is supported on Spectra Logic's Fibre Channel and iSCSI libraries.
  • Page 159 Appendix D. Report LUNs—A0 The REPORT LUNS command will return CHECK CONDITION status only when the device server is unable to return the requested report of the logical unit inventory. If a REPORT LUNS command is received from an initiator with a pending unit attention condition (i.e., before the device server reports CHECK CONDITION status), the device server will perform the REPORT LUNS command.
  • Page 160: Table D-2: Example Configurations

    Spectra Logic libraries always report the LUNs sequentially. Table D-2: Example Configurations LUNs Config 1 Drive 1 Drive 2 Drive 3 Drive 4 If installed. Config 1 is a QIP that only has tape drives attached. Config 2 is an exporting library QIP with tape drives.
  • Page 161 Table D-3: Report LUNs Parameter Data Format Byte (MSB) (MSB) (MSB) Appendix D. Report LUNs—A0 First LUN (00) Second LUN (01) Last LUN (LSB) (LSB) (LSB)
  • Page 162 19, 23 additional sense code qualifiers 63 additional sense codes 63 address cartridge slots 44 import/export 49 medium transport element 42 storage elements 44 tape picker 42 alert UNIT ATTENTION 24 ASC 63 ASCQ 63 bar code labels...
  • Page 163 44 import/export 49 inventory 14 releasing 52 reserving 57 status 37 storage 44 entry/exit medium removal 36 errors codes 64, 71, 72, 73, 74 hardware sense key 62, 64, 65, 66, 67, 68, 69, 70 reporting 62...
  • Page 164 library definition 13 ready for commands 61 software license 3 license (library software) 3 definition 13 magazine slots see cartridge slots medium transport element descriptor format 42 message out 13 messages errors 62 mode parameters reading 27 reloading 24 saving 24 setting 24 MODE SELECT command 24 MODE SENSE...
  • Page 165 Spectra vendor identification value 19, 23 status CHECK CONDITION 54, 61, 62 element 37 GOOD 61 RESERVATION CONFLICT 52 storage elements default address 44 descriptor format 44 tape cartridges medium removal 36 tape drives data transfer elements 46 descriptor format 46...
  • Page 166 UNIT ATTENTION alert 24 sense key 62, 75 unsupported sense keys 63 values product identification 19, 23 sense keys 62 vendor identification 19, 23 vendor identification 19, 23 vendor-specific sense keys 62, 76 Index...

This manual is also suitable for:

T120T50T950

Table of Contents