Spectra Logic Spectra S50, T120, T50, T950 User Manual
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
Notices
2
Notices
Except as expressly stated herein, Spectra Logic Corporation makes available its libraries and associated
documentation on an “AS IS” BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE, BOTH OF WHICH ARE EXPRESSLY DISCLAIMED. In no event shall Spectra Logic be
liable for any loss of profits, loss of business, loss of use or data, interruption of business, or for indirect,
special, incidental or consequential damages of any kind, even if Spectra Logic has been advised of the
possibility of such damages arising from any defect or error.
Information furnished in this manual is believed to be accurate and reliable. However, no responsibility
is assumed by Spectra Logic for its use. Due to continuing research and development, Spectra Logic may
revise this publication from time to time without notice, and reserves the right to change any product
specification at any time without notice.
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.
Notices
3
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.
If you do not agree to this end user license agreement (EULA), do not use the library; instead, promptly
contact Spectra Logic for instructions on return of the library for a refund. Any use of the Software,
including but not limited to use on the library, will constitute your agreement to this EULA (or
ratification of any previous consent).
Grant of License. The Software is licensed on a non-exclusive basis, not sold. This EULA grants you the
following rights to the Software:
• You may use the Software only on the Spectra Logic library.
• Not Fault Tolerant. The Software is not fault tolerant. Spectra Logic has independently determined how
to use the Software in the library, and suppliers have relied upon Spectra Logic to conduct sufficient
testing to determine that the Software is suitable for such use.
• No Warranties for the SOFTWARE. The Software is provided “AS IS” and with all faults. The entire risk
as to satisfactory quality, performance, accuracy, and effort (including lack of negligence) is with you.
Also, there is no warranty against interference with your enjoyment of the Software or against
infringement. If you have received any warranties regarding the SOFTWARE, those warranties do not
originate from, and are not binding on Software suppliers.
• Note on Java Support. The Software may contain support for programs written in Java. Java technology
is not fault tolerant and is not designed, manufactured, or intended for use of resale as online control
equipment in hazardous environments requiring fail-safe performance, such as in the operation of
nuclear facilities, aircraft navigation or communications systems, air traffic control, direct life support
machines, or weapons systems, in which the failure of Java technology could lead directly to death,
personal injury, or severe physical or environmental damage.
• No Liability for Certain Damages. Except as prohibited by law, Software suppliers shall have no liability
for any indirect, special, consequential or incidental damages arising from or in connection with the
use or performance of the Software. This limitation shall apply even if any remedy fails of its essential
purpose. In no event shall Software suppliers, individually, be liable for any amount in excess of U.S.
two hundred fifty dollars (U.S. $250.00).
• Limitations on Reverse Engineering, Decompilation, and Disassembly. You may not reverse engineer,
decompile, or disassemble the Software, except and only to the extent that such activity is expressly
permitted by applicable law notwithstanding this limitation.
• Software Transfer Allowed with Restrictions. You may permanently transfer rights under this EULA only
as part of a permanent sale or transfer of the library, and only if the recipient agrees to this EULA. If
the Software is an upgrade, any transfer must also include all prior versions of the Software.
• Export Restrictions. Export of the Software from the United States is regulated by the Export
Administration Regulations (EAR, 15 CFR 730-744) of the U.S. Commerce Department, Bureau of
Export Administration. You agree to comply with the EAR in the export or re-export of the Software:
(i) to any country to which the U.S. has embargoed or restricted the export of goods or services,
which as May 1999 include, but are not necessarily limited to Cuba, Iran, Iraq, Libya, North Korea,
Sudan, Syria, and the Federal Republic of Yugoslavia (including Serbia, but not Montenegro), or to any
national or any such country, wherever located, who intends to transit or transport the Software back
to such country; (ii) to any person or entity who you know or have reason to know will utilize the
Software or portion thereof in the design, development or production of nuclear, chemical, or
biological weapons; or (iii) to any person or entity who has been prohibited from participating in U.S.
export transactions by any federal agency of the U.S. government. You warrant and represent that
neither the BXA nor any other U.S. federal agency has suspended, revoked or denied your export
privileges. For additional information see http://www.microsoft.com/exporting/.
4
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
List of Tables 8
Chapter 1. Introduction 12
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 2. Initialize Element Status—07h 14
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Chapter 3. Initialize Element Status With Range—E7h or 37h 15
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 4. Inquiry—12h 16
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapter 5. Mode Select—15h 24
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Conte nts
5
Chapter 6. Mode Sense—1Ah 27
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chapter 7. Move Medium—A5h 34
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Chapter 8. Prevent/Allow Medium Removal—1Eh 36
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Chapter 9. Read Element Status—B8h 37
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Element Descriptors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Chapter 10. Release—17h 52
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Chapter 11. Request Sense—03h 54
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Chapter 12. Reserve—16h 57
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Conte nts
6
Chapter 13. Send Diagnostic—1Dh 59
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Chapter 14. Test Unit Ready—00h 61
Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Command Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Chapter 15. Error Reporting 62
Sense Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Sense Codes and Qualifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Appendix A. Extended Copy—83h—143r1 Specifications 78
Fibre Channel Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Mode Sense Page for Extended Copy Command . . . . . . . . . . . . . . . . . . . . . . . . . .107
Sense Key Specific Field Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
Receive Copy Results Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
Appendix B. Extended Copy—83h—SPC2 Specifications 116
Fibre Channel Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Appendix C. Receive Copy Results—84h 152
Fibre Channel Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
Failed Segment Details Service Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
Conte nts
7
Appendix D. Report LUNs—A0 158
Fibre Channel Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
Index 162
8
List of Tables
Chapter 2. Initialize Element Status—07h 14
Table 2-1: Initialize Element Status Command–07h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Chapter 3. Initialize Element Status With Range—E7h or 37h 15
Table 3-1: Initialize Element Status With Range Command–E7h . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 4. Inquiry—12h 16
Table 4-1: Inquiry Command–12h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Table 4-2: Inquiry Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Table 4-3: Standard Inquiry Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Table 4-4: Standard Inquiry Data Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Table 4-5: Supported Pages Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 4-6: Serial Number Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 4-7: Serial Number Page Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table 4-8: Library Identification Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Table 4-9: Serial Number Page Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Chapter 5. Mode Select—15h 24
Table 5-1: Mode Select Command–15h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Table 5-2: Mode Select Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 6. Mode Sense—1Ah 27
Table 6-1: Mode Sense Command–1Ah . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Table 6-2: Mode Sense Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 6-3: Parameter List Header Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Table 6-4: Element Address Assignments Page–1Dh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Table 6-5: Transport Geometry Parameter Page–1Eh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Table 6-6: Device Capabilities Fields Format–1Fh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Chapter 7. Move Medium—A5h 34
Table 7-1: Move Medium Command–A5h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 7-2: Move Medium Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
List of Tables
9
Chapter 8. Prevent/Allow Medium Removal—1Eh 36
Table 8-1: Prevent/Allow Medium Removal Command–1Eh . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Table 8-2: Prevent/Allow Medium Removal Command Values . . . . . . . . . . . . . . . . . . . . . . . . . 36
Chapter 9. Read Element Status—B8h 37
Table 9-1: Read Element Status Command–B8h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Table 9-2: Read Element Status Command Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Table 9-3: Element Status Data Header Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Table 9-4: Element Status Data Header Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Table 9-5: Element Status Page Header Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Table 9-6: Element Status Page Header Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Table 9-7: Medium Transport Element Descriptor (Tape Picker) . . . . . . . . . . . . . . . . . . . . . . . . 42
Table 9-8: Medium Transport Element Descriptor Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Table 9-9: Storage Element Descriptor (Magazine Slots) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Table 9-10: Storage Element Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Table 9-11: Data Transfer Element Descriptor (Tape Drive) . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Table 9-12: Data Transfer Element Descriptor Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Table 9-13: Import/Export Element Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Table 9-14: Import/Export Element Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Chapter 10. Release—17h 52
Table 10-1: Release Command–17h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Table 10-2: Release Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Chapter 11. Request Sense—03h 54
Table 11-1: Request Sense Command–03h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Table 11-2: Sense Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Table 11-3: Sense Data Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Chapter 12. Reserve—16h 57
Table 12-1: Reserve Command–16h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Table 12-3: Element List Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Table 12-2: Reserve Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Chapter 13. Send Diagnostic—1Dh 59
Table 13-1: Send Diagnostic Command–1Dh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Table 13-2: Send Diagnostic Command Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
List of Tables
10
Chapter 14. Test Unit Ready—00h 61
Table 14-1: Test Unit Ready Command–00h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Chapter 15. Error Reporting 62
Table 15-1: Sense Key Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Table 15-2: Library SCSI Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Appendix A. Extended Copy—83h—143r1 Specifications 78
Table A-1: Extended Copy Command (143r1 Specifications) . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Table A-2: Extended Copy Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Table A-3: Extended Copy Descriptor Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Table A-4: Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Table A-5: Address Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Table A-6: World Wide Name Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Table A-7: N_PORT D_ID Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Table A-8: World Wide Name Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Table A-9: SCSI B_T_L Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Table A-10: Device-Specific Field - Device Type 00h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Table A-11: Device-Specific Field - Device Type 01h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Table A-12: Tape Transfer Lengths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Table A-13: Segment Descriptor Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Table A-14: PAD Bit and CAT Bit Interaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Table A-15: Segment Descriptor for Codes 00h, 01h, 0Bh, and 0Ch . . . . . . . . . . . . . . . . . . . . . 95
Table A-16: Segment Descriptor for Codes 02h and 0Dh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Table A-17: Segment Descriptor for Codes 03h and 0Eh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Table A-18: Segment Descriptor for Code 04h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Table A-19: Segment Descriptor for Code 05h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Table A-20: Segment Descriptor for Codes 06h and 0Fh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Table A-21: Segment Descriptor for Code 07h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Table A-22: Segment Descriptor for Code 10h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Table A-23: Segment Descriptor for Code 11h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Table A-24: Segment Descriptor for Code 12h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Table A-25: Mode Sense Page for Extended Copy Command . . . . . . . . . . . . . . . . . . . . . . . . . 108
Table A-26: Segment Pointer Bytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Table A-27: Receive Copy Results Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Table A-28: Mode Field Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Table A-29: Return Data Format - Mode 0 (Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Table A-30: Copy Manager Status Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Table A-31: Transfer Count Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
List of Tables
11
Appendix B. Extended Copy—83h—SPC2 Specifications 116
Table B-2: Extended Copy Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Table B-3: Extended Copy Descriptor Type Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Table B-4: Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Table B-5: Device Type Specific Parameters in Target Descriptors . . . . . . . . . . . . . . . . . . . . . 125
Table B-6: World Wide Name Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Table B-7: N_Port Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Table B-8: N_Port with World Wide Name Checking Target Descriptor Format . . . . . . . . . . . . 127
Table B-9: Parallel Interface T_L Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Table B-10: Identification Descriptor Target Descriptor Format . . . . . . . . . . . . . . . . . . . . . . . 129
Table B-11: Device Type Specific Target Descriptor Parameters for Block Device Types . . . . . 130
Table B-12: Device Type Specific Target Descriptor Parameters for Stream Device Types . . . . 131
Table B-13: Stream Device Transfer Lengths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Table B-14: Device Type Specific Target Descriptor Parameters for Processor Device Types . . 132
Table B-15: Segment Descriptor Header Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Table B-16: Descriptor Type Code Dependent Copy Manager Processing . . . . . . . . . . . . . . . . 134
Table B-17: PAD and CAT Bit Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Table B-18: Block Device To or From Stream Device Segment Descriptor . . . . . . . . . . . . . . . . 137
Table B-19: Block Device to Block Device Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . 140
Table B-20: Stream Device to Stream Device Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . 142
Table B-21: Inline Data to Stream Device Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . 143
Table B-22: Embedded Data to Stream Device Segment Descriptor . . . . . . . . . . . . . . . . . . . . . 145
Table B-23: Stream Device to Discard Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Table B-24: Verify Device Operation Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Table B-25: Write Filemarks Operation Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Table B-26: Space Operation Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Table B-27: Locate Operation Segment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Appendix C. Receive Copy Results—84h 152
Table C-2: Receive Copy Results Service Action Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Table C-3: Parameter Data for the Copy Status Service Action . . . . . . . . . . . . . . . . . . . . . . . . 154
Table C-4: Copy Status Status Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Table C-5: Copy Status Transfer Count Units Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Table C-6: Parameter Data for the Failed Segment Details Service Action . . . . . . . . . . . . . . . . 156
Appendix D. Report LUNs—A0 158
Table D-2: Example Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Table D-3: Report LUNs Parameter Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
12
1Introduction
About This Guide
This guide describes the SCSI communications and commands supported by Spectra
T-Series and Spectra 50-Series libraries, following ANSI standard protocols for SPC-3
(Revision 12) specifications and SMC-2 (Revision 5) specifications.
The SCSI communication is the same to each logical library within a specific product.
Note: The appendices in this guide contain additional information on
select commands that are useful in 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. Following are the similarities and differences:
SCSI-3 T-Series and 50-Series libraries use the SCSI-3 command set rather than the
SCSI-2 command set used by Gator architecture libraries.
INQUIRY Command The INQUIRY command is different because T-Series and 50-Series
parameters are different from Gator architecture library parameters (see Chapter 4.
Inquiry—12h).
Drive Serialization The DVCID bit must be set for drive serialization (see Chapter 9.
Read Element Status—B8h).
MODE SENSE Default Values The MODE SENSE default values (see Chapter 6. Mode Sense—
1Ah) are different because there are a different number of elements in the library.
Vendor-Unique Errors There are a series of new vendor-unique errors in T-Series and
50-Series libraries; they will fall under the Additional Sense Code (ASC) of 89.
Drive Support Gator architecture supports only Sony AIT drives, but various half-inch
drive types are possible in T-Series and 50-Series libraries.
Chapter .
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.
• Spectra T950 Library Release Notes, the Spectra T120 Library Release Notes the
Spectra T50 Library Release Notes, and the Spectra S50 Library Release Notes
provide last-minute information about these respective Spectra Logic libraries.
Verify that you have the most current version of every Spectra Logic document by
visiting the documentation section of Spectra Logic’s Web site.
Glossary
The following terms are defined for SCSI communication:
CDB Command descriptor block.
In Means coming from the target to the initiator, such as Data In.
Initiator Any device which initiates an exchange on the SCSI bus.
Library Refers to a logical library.
LUN Refers to a logical unit number.
Numbering A number followed by a lower case h is a hexadecimal number.
Out Means going from the initiator to the target, such as Message Out.
Target Any device that is the target of an exchange on the SCSI bus.
14
2 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
Access Port (TAP) or entry/exit port are opened and closed.
Element status information is also updated whenever the tape
picker moves media from one element to another.
T-Series and 50-Series libraries maintain their inventory after powering up. No robotic
motion is performed as a result of this command. If a cartridge is in a drive during
inventory, its bar code cannot be scanned. The library will automatically scan this
tape’s bar code the first time the tape is moved into a slot. See Chapter 9. Read Element
Status—B8h for details.
Command Response
No data is expected to be returned in T-Series and 50-Series libraries when the INITIALIZE
ELEMENT STATUS command is issued. To get information on the status of elements, issue a
READ ELEMENT STATUS command.
Table 2-1: Initialize Element Status Command–07h
Byte
Bits
76543210
00 Operation Code (07h)
01 Obsolete
a
a. These bits are ignored.
Reserved
02 Reserved
03 Reserved
04 Reserved
05 Control
b
b. Must be zero.
15
3 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. See Chapter 2. Initialize Element Status—07h for more information on
the command.
Table 3-1: Initialize Element Status With Range Command–E7h
Byte
Bits
76543210
00 Operation Code (E7h or 37h)
01 Obsolete
a
a. These bits are ignored.
Reserved Fast
a
Range
a
02 (MSB)
Element Address
a
03 (LSB)
04 Reserved
05 Reserved
06 (MSB)
Number of Elements
a
07 (LSB)
08 Reserved
09 Control
b
b. Must be zero.
16
4Inquiry—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
Byte
Bits
76543210
00 Operation Code (12h)
01 Obsolete
a
a. These bits are ignored.
Reserved CMDDT EVPD
02 Page Code
03 Reserved
04 Allocation Length
05 00 Reserved 000
Table 4-2: Inquiry Command Field Values
Field Name
Values
Allowed Meaning
Logical Unit
Number
0h This bit is ignored.
CMDDT 0 Command support data.
Enable Vital
Product Data
0 Requests the library to return only the standard Inquiry Data page. (The Page Code must be 0.)
1 Requests that the library return the Page Code page.
Page Code
00h When the EVPD bit is 1, this returns a list of supported pages (00h, 80h, 83h).
80h When the EVPD bit is 1, this returns the library’s serial number page.
83h When the EVPD bit is 1, this returns the library’s identification page.
Allocation
Length
00-FFh
Specifies the number of bytes the initiator allocates for data returned from the inquiry
command. Zero indicates no inquiry data is to be transferred; this condition is not considered an
error. The library terminates the data in phase when it transfers either the number of bytes
specified by the allocation length field or all of the available inquiry data, whichever is less. The
data length for the standard inquiry data returned by the library is 38h (56 bytes).
Chapter 4. Inquiry—12h
17
Command Response
Table 4-3: Standard Inquiry Data Format
Byte
Bits
76543210
00 Peripheral Qualifier Peripheral Device Type
01 RMB Reserved
02 Version = 05h
03 Obsolete Obsolete NormACA HiSup Response Data Format
04 Additional Length (n-4)
05 SCCS ACC ALUA 3PC Reserved
06 BQue EncServ VS MultiP MChngr Obsolete Obsolete Addr16
07 RelAdr Obsolete WBus16 Sync Linked Obsolete CmdQue VS
08 (MSB)
Vendor Identification
15 (LSB)
16 (MSB)
Product Identification
31 (LSB)
32 (MSB)
Product Revision Level
35 (LSB)
36 (MSB)
Vendor-Specific
55 (LSB)
56 Reserved Clocking QAS IUS
57 Reserved
Chapter 4. Inquiry—12h
18
Table 4-4: Standard Inquiry Data Field Values
Field Name
Value
Returned Meaning
Peripheral
Qualifier
000b The library is a single LUN device. This value is returned only if the LUN sent is 0h.
011b If the LUN in the ID message is not 0h, this indicates that this LUN is not supported.
Peripheral
Device Type
08h Identifies the library as a media changer device, returned only if the LUN sent is 0h.
1Fh Returned if the LUN in the ID message is not 0h; it indicates that the LUN is an unknown type.
RMB 1 Indicates media is removable from the library.
ISO 00b
The library supports the current ANSI version of the SPC-3 Standard. ECMA 000b
ANSI 010b
NormACA 0 The library does not support setting the Normal ACA Supported bit to 1.
HiSup 0 The library does not use the hierarchical addressing model to assign LUNs to logical units.
Response
Data Format
2h
INQUIRY data returned by T-Series and 50-Series libraries conforms to the format defined in
the SPC-3 Standard.
Additional
Length
n-4
There are n-4 bytes of data following this byte, where n is the last byte returned.
Libraries exported through QIPs return Bytes 0-35 (n=35).
Libraries exported through direct-attached drives return Bytes 0-57 (n=57), with the tape
drive responsible for Bytes 36-57. Refer to the tape drive manufacturer’s SCSI specification for
a definition of those bytes and the bits for clocking, QAS, and IUS in Byte 56.
SCCS 0 The library does not contain an embedded storage array controller component.
ACC 0 No access controls coordinator may be addressed through this logical unit.
ALUA 0
The SCSI target device does not support asymmetric logical unit access or vendor-specific
asymmetric access. Neither REPORT TARGET GROUPS or SET TARGET GROUPS is supported.
3PC
1 Indicates that device support for third-party or EXTENDED COPY commands is enabled.
0 A 3PC bit of zero indicates that device support for such commands is disabled.
BQue 0 The library does not support tagged tasks (command queuing) for this logical unit.
EncServ 0 The library does not contain an embedded enclosure services component.
VS 0 The library does not support vendor-specific data.
MultiP
1 The library’s port addressing is overlapped.
0 The library‘s port addressing is split.
MChngr 0 The library is not embedded within or attached to a medium transport element.
Chapter 4. Inquiry—12h
19
Addr16
0 The library does not support wide SCSI addressing.
1 Direct-attach drives support wide SCSI addressing.
RelAdr 0 The library does not support relative addressing.
WBus16
0 The library does not support 16-bit wide transfers.
1 Direct-attach drives support 16-bit wide transfers.
Sync
0 The library does not support synchronous data transfer.
1 Direct-attach drives support synchronous data transfer.
Linked 0 The library does not support command linking.
CmdQue 0 The library does not support tagged command queuing.
Vendor
Identification
Spectra
a
These bytes are the ASCII representation of SPECTRA (uppercase) followed by a space (20h).
b
Product
Identification
PYTHON
a
This is the product identification returned by all T-Series and 50-Series tape libraries.
b
Product
Revision
Variable
a
These bytes are the ASCII representation of the current product revision level, with space
(20h) characters to fill four bytes (for example, 2.00).
Clocking
0 The device server only supports single timing.
00b
c
Set if the host interface speed has been set to limit transfers to 80 MB/s.
11b
c
Set if the host interface speed has not been set to limit transfers to 80 MB/s.
QAS 0 The device server does not support quick arbitration and selection.
IUS 0 The device server does not support information unit transfers.
a. The Vendor Identification, Product Identification, and Product Revision Level data fields all return ASCII-format data. Unused bytes are filled with
space characters (20h) left-justified.
b. The Vendor Identification and Product Identification data fields may be changed to support other emulations.
c. Supported only on direct-attach drives that support Ultra160 SCSI.
Table 4-4: Standard Inquiry Data Field Values
Field Name
Value
Returned Meaning
Chapter 4. Inquiry—12h
20
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
Byte
Bits
76543210
00 Peripheral Qualifier Peripheral Device Type
01 Page Code (00h)
02 Reserved (00h)
03 Page Length (03h)
04 Supported Pages Page (00h)
05 Serial Number Page (80h)
06 Device Identification Page (83h)
Table 4-6: Serial Number Page
Byte
Bits
76543210
00 Peripheral Qualifier Peripheral Device Type
01 Page Code
02 Reserved
03 Page Length
04-23 Serial Number of Library(ASCII)
Chapter 4. Inquiry—12h
21
Table 4-7: Serial Number Page Field Values
Field Name
Value
Returned Meaning
Peripheral Qualifier 000b
The library is a single LUN device. This value is returned only if the LUN sent in the
INQUIRY command is 0h.
Peripheral Device
Typ e
08h
Identifies the library as a media changer device. This value is returned only if the
LUN sent in the INQUIRY command is 0h.
1Fh
This value is returned if the LUN sent in the INQUIRY command is not 0h. It
indicates that the LUN is an unknown type.
Page Code 80h Serial number page.
Page Length Varies
a
a. The serial number can be up to 20 characters in length.
Length of serial number.
Serial Number Varies
a
ASCII representation of library serial number.
Chapter 4. Inquiry—12h
22
Table 4-8: Library Identification Page
Byte
Bits
76543210
00 Peripheral Qualifier Peripheral Device Type (08h)
01 Page Code
02 Reserved (00h)
03
Page Length
(32h for QIP-attached libraries)
(26h for direct-attached drives)
04 Reserved Code Set (02h)
05 Reserved Identifier Type (01h)
06 Reserved (00h)
07 Identifier Length (22h)
08 - 15 Vendor ID (SPECTRA)
16 - 31 Product ID (PYTHON)
32 - 41 Serial Number of the Library
42
Code Set
a
(Identifier contains binary data = 01h)
43
Identifier Type
a
(FC_PH 64-bit Name_Identifier == WWN = 03h)
44 Reserved
a
45
Identifier Length
a
(beyond header = 08h)
46 - 53 World Wide Name
a
a. Applicable only to Fibre Channel, Gigabit Ethernet, NDMP, and iSCSI libraries. These will not be reported on SCSI interface systems.
Chapter 4. Inquiry—12h
23
Table 4-9: Serial Number Page Field Values
Field Name
Value
Returned Meaning
Peripheral Qualifier 000b
The library is a single LUN device. This value is returned only if the LUN
sent in the INQUIRY command is 0h.
Peripheral Device Type
08h
Identifies the library as a media changer device. This value is returned
only if the LUN sent in the INQUIRY command is 0h.
1Fh
This value is returned if the LUN sent in the INQUIRY command is not 0h.
It indicates that the LUN is an unknown type.
Page Code 83h Device Identification Page.
Page Length
32h Libraries exported through QIPs return 50 (32h) bytes.
26h Libraries exported through direct-attached drives return 38 (26h) bytes.
Code Set 02h The Identifier field contains ASCII graphic codes.
Identifier Type 01h The Identifier field is associated with the post that received the request.
Identifier Length 22h T-Series and 50-Series libraries return 34 (22h) bytes.
Serial Number Variable
a
ASCII representation of library serial number.
Vendor Identification SPECTRA
b
These bytes are the ASCII representation of SPECTRA (uppercase)
followed by a space (20h).
Product Identification PYTHON
This is the product identification returned by all T-Series and 50-Series
libraries.
World Wide Name
c
Variable Actual WWN of QIP (not ASCII represented).
a. The serial number can vary between two and seven digits in length. All T-Series and 50-Series libraries currently report 04.
b. The vendor identification, product identification, product revision level, and patch level data fields all return ASCII-format data. Unused bytes are
filled with space characters (20h).
c. Fibre Channel interface libraries and drives only.
24
5Mode 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:
• Element Address Assignments Page (1Dh) has these changeable bits:
• Bytes 2,3
• Bytes 6,7
• Bytes 10,11
• Bytes 14,15
• Transport Geometry Page (1Eh) has no changeable bits
• Device Capabilities Page (1Fh) has no changeable bits
If requested, by setting the SP (save pages) bit in the command descriptor, the library
saves applicable mode parameters to nonvolatile RAM and automatically reloads them
when it initializes, following a reset or power-up.
Any changed parameters apply to all initiators in a multi-initiator environment. If mode
parameters are changed, the library generates a UNIT ATTENTION to all initiators, except the
one that issued the MODE SELECT command, with sense information to indicate that mode
parameters have changed.
Note: Before issuing any MODE SELECT command, issue a MODE SENSE
command with the Page Code field set to 3Fh, so the T-Series or
50-Series library returns all mode pages, and the Page Control field
set to 01h, so the library indicates which fields are changeable.
Chapter 5. Mode Select—15h
25
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
Byte
Bits
76543210
00 Operation Code (15h)
01 Obsolete
a
a. These bits are ignored.
PF Reserved SP
02 Reserved
03 Reserved
04 Parameter List Length
05 0 0 Reserved 0 0 0
Table 5-2: Mode Select Command Field Values
Field Name
Values
Allowed Meaning
PF 1 The library supports the page format defined by the SPC-3 Standard.
SP
(Save Pages)
0 Mode pages are not saved. Mode parameter changes requested are still made.
1 All mode pages are saved, whether they are changed in this command or not.
Parameter
List Length
00-FFh
The value of this byte represents the length of the entire parameter list, including the
parameter list header. When the value of the parameter list length is 00h, no parameter list is
transferred from the initiator. This is not considered an error. You might send a MODE SELECT
command with no parameter list and the SP bit set to 1, for example, to force the T-Series or
50-Series library to save its current mode page settings without changing them.
Chapter 5. Mode Select—15h
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). See also the
MODE SENSE chapter for detailed descriptions of all mode parameters.
The following restrictions apply when reassigning element addresses:
• Element addresses must not overlap other element groups.
• Element groups (i.e., cartridge slots, tape picker, drives) must be assigned
contiguous addresses.
• Element addresses must be between 0 and 65,535 (0x FFFF).
27
6Mode 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
• Device capabilities, such as where media can be moved or stored—1Fh
These pages are described in detail under Command Response on page 29. The
initiator can change some of these parameters using the MODE SELECT (15h) command.
The SPC-3 Standard provides both a 6-byte and a 10-byte MODE SENSE command. The
library uses the 6-byte command. The table below shows the CDB for the MODE SENSE
command.
Table 6-1: Mode Sense Command–1Ah
Byte
Bits
76543210
00 Operation Code (1Ah)
01 Obsolete
a
a. These bits are ignored.
Reserved DBD Reserved
02 Page Control Page Code
03 Reserved
04 Allocation Length
05 00 Reserved 000
Chapter 6. Mode Sense—1Ah
28
Table 6-2: Mode Sense Command Field Values
Field Name Values Allowed Meaning
DBD (Disable Block
Descriptors)
0 or 1
The library does not return block descriptors even if requested to do so. This is
not an error condition. It simply returns a block descriptor length of 0.
Page Control
0h Requests current mode parameter values.
1h
Requests changeable parameters. The requested mode pages are returned,
but rather than parameter values, bits are set to 1 if changeable or 0 if not.
2h Requests default values.
3h
Requests saved values. If a page has not been saved, default values are
returned.
Page Code
3Fh Requests the library return all available mode pages.
1Dh Requests element address assignment page only.
1Eh Requests transport geometry parameters page only.
1Fh Requests device capabilities page only.
Allocation Length 00-FFh
Specifies the number of bytes the initiator allocates for data returned. Zero
indicates no mode data is to be transferred; this condition is not considered
an error. The library terminates the data in phase when it transfers either the
number of bytes specified by the allocation length field or all of the available
mode parameter data, whichever is less. The data length for all mode
parameter pages returned by the library is 48 bytes (30h).
Chapter 6. Mode Sense—1Ah
29
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
• 20 bytes of device capabilities parameters
Each of these items is described in the tables that follow. Note that when a specific
page is requested, the library returns only the header data and the specific page.
The Mode Data Length (byte 00) indicates the number of bytes of parameter information
available to the initiator, not including the Mode Data Length byte itself. For example, if
all mode pages are requested, this value is 43 (2Bh), one byte less than the total mode
parameter length available.
Table 6-3: Parameter List Header Format
Byte
Bits
76543210
00 Mode Data Length
01 - 03 Reserved for other device types
Chapter 6. Mode Sense—1Ah
30
Element Address Assignments
For the default values of the element addresses, see Chapter 9. Read Element Status—
B8h.
The value of 1 for PS (“page savable,” byte 00, bit 7) indicates that the page can be saved to
nonvolatile RAM. This is done by setting the SP field in the MODE SELECT command. See
Chapter 5. Mode Select—15h for details.
Table 6-4: Element Address Assignments Page–1Dh
Byte
Bits
76543210
00 PS–1 Reserved Page Code–1Dh
01 Parameter List Length (following this byte)(12h)
02 (MSB)
Medium Transport Element Address (default=0001h)
03 (LSB)
04 (MSB)
Number of Medium Transport Elements
01h for all T-Series and 50-Series libraries
05 (LSB)
06 (MSB)
First Storage Element Address(default=1000h)
07 (LSB)
08 (MSB)
Number of Storage Elements
(depends on partition size)
09 (LSB)
10 (MSB)
First Import/Export Element Address
(default=0010h)
11 (LSB)
12 (MSB)
Number of Import/Export Elements
(depends on configuration)
13
14 (MSB)
First Data Transfer Element Address
(default=0100h)
15 (LSB)
16 (MSB)
Number of Data Transfer Elements
(depends on partition size)
17 (LSB)
18 Reserved
19 Reserved
Loading...