Home » HP Manuals » Tape Drives » HP Surestore 28/48-Slot with DLT7000 » Manual Viewer

HP Surestore 28/48-Slot with DLT7000 Digital Linear Tape SCSI-2 Drive and SCSI - Page 282

Modifying a SCSI Disk Driver for the Tape Drive, Change Considerations

Get HP Surestore 28/48-Slot with DLT7000 PDF manuals and user guides

View all HP Surestore 28/48-Slot with DLT7000 manuals

Add to My Manuals
Save this manual to your list of manuals

Page 282 highlights

Table B-2 Programmer's Tips Modifying the SCSI Driver Modifying a SCSI Disk Driver for the Tape Drive Though a SCSI disk driver can be modified for the tape drive, this is an involved process since they are very different drivers. To modify a SCSI disk driver, refer to the Appendix A in the HP-UX Driver Development Guide for the Hewlett-Packard version (HP Part No. 98577-90001). Change Considerations Consider this list of possible changes/issues when modifying a disk driver for the tape drive. Abort Behavior: When a command is aborted while the tape drive is logically disconnected from the bus, it will not immediately respond. The abort will be ignored until the tape drive reconnects. At this point, the abort is recognized and the appropriate check condition status returned. Removable Media: Because the tape cartridge is removable, several unit attention conditions unique to digital linear tape drives can be generated: Unit Attention Conditions Sense Key Not Ready Unit Attention Unit Attention Medium Error Data Protect Hardware Error Sense Code No Disk Medium Changed Poweron or Reset Cannot Read Media Unknown Format Write Protected Load/Unload Failure Occurs Media is not loaded Each time the autochanger swaps a tape cartridge After poweron or reset for all SCSI devices. Medium Format Corrupted When tape is an unknown type and not compatible When tape is write protected Something mechanically impedes the load/unload process B- 12 Appendix B

Section	Page
SCSI-3 Library Command Set, Ed 7	1
1 SCSI Command Overview	25
SCSI Command Overview	26
Library Control Through SCSI	27
Initiator	27
Target Device	27
Addresses	27
Library Control Commands	28
SCSI Bus Phases	28
Arbitration Phase	28
Selection Phase	28
Reselection Phase	28
Information Transfer Phase	29
Data Phase	29
Command Phase	29
Message Phase	30
Status Phase	37
Conditions	39
Attention Condition	39
Reset Condition	39
Unit Attention Condition	40
Not Ready Condition	41
Bus Free Condition	42
Bus Parity Error Condition	42
Other SCSI Functionality	42
SCSI Commands Used by Target	43
Command Descriptor Block (CDB)	44
2 Library SCSI-3 Command Set	45
Numerical List of Commands	46
Alphabetical List of Commands	48
Test Unit Ready Command (00H)	50
Rezero Unit Command (01H)	51
Request Sense Command (03H)	52
Allocation Length	52
Valid	53
Error Code	54
Sense Key and Additional Sense Length	54
Information Bytes	54
Additional Sense Code	54
Additional Sense Code Qualifier	54
SKSV	55
C/D	55
BPV	55
Bit Pointer	55
Field Pointer	55
Additional Sense Bytes	55
Initialize Element Status Command (07H)	56
Inquiry Command (12H)	57
CmdDt (Command Support Data)	57
EVPD (Enable Vital Product Data)	57
Page Code	58
Allocation Length	58
Inquiry Page Code 00H Data	59
Page Length	59
Inquiry Page Code 80H Data	60
Inquiry Page 83H Data	61
Code Set	61
Identifier Type	61
Inquiry Page C0H Data	62
Inquiry Command Data	63
RMB	64
ANSI-Approved Version	64
AERC, TrmTsk	64
NormACA	64
Response Data Format	64
EncServ	64
MultiP	64
MChngr	64
AckReq	64
Addr32	64
Addr16	65
RelAdr	65
WBus32	65
WBus16	65
Sync	65
Linked	65
TranDis	65
CmdQue	65
Product Identification	66
Mode Select (6) Command (15H)	67
Page Format (PF)	68
Save Pages (SP)	68
Parameter List Length	68
Block Descriptor Length	68
Reserve (6) Command (16H)	69
3rdPty	69
Third Party Device ID	69
Element	69
Reservation Identification	70
Element List Length	70
Reserve Command Element List Descriptors	70
Element Address	70
Release (6) Command (17H)	71
3rdPty	71
Third Party Device ID	71
Element	71
Reservation Identification	72
Mode Sense (6) Command (1AH)	73
DBD	74
PC	74
Page Code	74
Allocation Length	74
Mode Data Length	76
Block Descriptor Length	76
Page Code 1CH: TapeAlert	77
PS	77
Perf (Always set to 0)	77
DExcpt (Always set to 1)	77
Test (Default set to 0)	78
LogErr (Always set to 0)	78
MRIE (Always set to 0x0)	78
Interval Timer (Always set to 0)	79
Report Count/Test Flag Number (Default set to 0)	80
<$startrange>element addresses	81
Transport Element (Picker)	93
Parameter Length	93
Rotate	93
Mode Sense Device Capabilities Page for 9-Slot Autoloader (1FH)	94
Mode Sense Device Capabilities Page for Library Models 2/20, 4/40, 4/100, 6/60, 6/100, 6/120, 6/1...	95
Table Abbreviations	96
StorXX	96
XX->YY - Move Medium	96
XX<>YY - Exchange Medium	96
Page Code 21H: Library Configurations	97
PS	98
Mailslot size	98
Error recovery enabled	98
Barcode reader enabled	98
I2C and SCSI Logging	98
Power secure	98
Report recoveries	98
Display HP product ID enabled	98
Stacker	98
Library SCSI ID	98
Barcode Report Length	99
DHCP (Dynamic Host Configuration Protocol)	99
RMC IP address	99
RMC subnet	99
RMC gateway	99
Page Code 22H: Drive Configurations	100
PS	100
SCSI ID	100
Compression	100
Speed	101
Page Code 23H: Fibre Channel Configurations	102
PS	103
Fibre Channel Addressing mode	103
Restart Now	103
Fibre Channel Link Address	103
Page Code 24H: Real Time Clock	104
PS	104
Time stamp valid	104
Sign	104
Time zone	104
Time stamp	104
Page Code 2EH: Ethernet Configuration	105
SNMP (Simple Network Management Protocol)	105
HTTP (Hyper Text Transfer Protocol)	105
IP info valid	106
DHCP info valid	106
Connect info valid	106
Mode info valid	106
MAC info valid	106
Connection Info	106
Ethernet Mode	106
DHCP Info	106
IP address	107
IP Net Mask	107
IP gateway	107
Receive Diagnostic Results Command (1CH)	108
PCV (Page Code Valid)	108
Page Code	108
Allocation Length	109
Test Number	110
FRU Locator	110
Error Code	110
FRU 1	110
FRU 2	110
FRU 3	111
Move Command Attempted	111
Source Element Number	111
Destination Element Number	111
Second Destination Element Number	111
Move Sequence ID	111
Error Code Qualifier	112
Vertical Motor Commanded Position	112
Vertical Motor Actual Position	112
Plunge Motor Commanded Position	112
Plunge Motor Actual Position	112
Translate Motor Commanded Position	112
Translate Motor Actual Position	112
Time Stamp	112
Supported Diagnostic Pages List	113
Send Diagnostic Command (1DH)	114
PF	114
SelfTst (Self Test)	114
DevOfL (Device Offline)	114
UnitOfl (Unit Offline)	115
Parameter List Length	115
Send Diagnostic Command Data	115
Test Number	115
Break	115
Loop Count Identifier	116
Parameters	116
prevent allow medium removal command (1EH)	117
Position To Element Command (2BH)	119
Transport Element Address	119
Destination Element Address	119
Write Buffer Command (3BH)	120
Mode	120
Buffer ID	121
Buffer Offset	121
Byte Transfer Length	121
OLR Status	123
Read Buffer Command (3CH)	125
Mode	125
Buffer ID	125
Buffer Offset	126
Allocation Length	126
Read Buffer ID Descriptions	127
Status Logs	128
Buffer ID	128
Number of Status Reporting	129
Number of Bytes to Follow	129
LVD/HVD	158
SE/DIFF	158
Bus Fault	158
Board Revision	158
Whole Product Revision	161
All Fibre Map Log	162
HP LTO Get Drive Information	163
Log Select Command (4CH)	164
PCR = 0	164
SP = 1	164
PC	165
Parameter List Length	166
Log Select Data Format	166
Log Sense Command (4DH)	167
PPC	167
SP	167
PC	167
Page Codes	168
Allocation Length	168
Log Sense Parameter Data	168
log sense command: tapealert	170
log sense command: hard error logs	178
FRU Locator	180
Error Code	180
FRU 1	180
FRU 2	180
FRU 3	180
Move Command Attempted	181
Source Element Number	181
Destination Element Number	181
Second Destination Element Number	181
Move Sequence IDs	181
Error Code Qualifier	181
Vertical Motor Commanded Position	181
Vertical Motor Actual Position	182
Plunge Motor Commanded Position	182
Plunge Motor Actual Position	182
Translate Motor Commanded Position	182
Translate Motor Actual Position	182
Time Stamp	182
Library Event Log	183
Time Stamp	185
Board Type	185
Error Flag	185
Event ID	186
Additional Length of Each Entry	186
CDB Valid	186
Sense Valid	186
Error Valid	186
Status Valid	186
TA Valid	186
Host ID	186
CDB	186
Sense Key	187
Additional Sense Code (ASC)	187
Additional Sense Code Qualifier (ASCQ)	187
SKSV	187
Error Code	187
Error Code Qualifier	188
SCSI Command Status	188
TapeAlert Revision	188
Flag Number	188
Drive Status Log	189
log sense command: recovery log	190
log sense command: odometer logs	191
Power-Up Time Stamp:	191
log sense command: soft error logs	192
Drive Media Event Log Data Format	193
Time Stamp	195
Board Type	195
Error Flag	195
Event ID	196
Additional Length of Each Entry	196
log sense command: drive media log	197
Drive Number	199
Media ID/Slot Number	199
Slot Number	199
Error Flag	199
Event ID	199
TapeAlert Revision	199
Flag Number	199
Serial Number	199
<$endrange>log sense command (4DH)	199
Mode Select (10) Command (55H)	200
Page Format (PF)	201
Save Pages (SP)	201
<$endrange>mode select command (55H)	201
Block Descriptor Length	201
Reserve(10) Command (56H)	202
3rdPty	202
Long ID	202
Element	202
Reservation Identification	203
Third Party Device ID	203
Element List Length	203
Reserve Command Element List Descriptors	203
Element Address	203
Release (10) Command (57H)	204
3rdPty	204
Long ID	204
Element	204
Reservation Identification	205
Third Party Device ID	205
Element List Length	205
Mode Sense (10) Command (5AH)	206
Mode Data Length	208
Block Descriptor Length	208
report LUNS command (A0H)	209
Allocation Length	209
Move Medium Command (A5H)	211
Transport Element Address	211
Source/Destination Element Address	211
Exchange Medium Command (A6H)	212
Transport Element Address	213
Source/Destination Element Address	213
Read Element Status Command (B8H	214
Voltag	215
Element Type Code	215
Starting Element Address	215
Number of Elements	215
CurData (Current Data)	215
Dvc ID (Device Identification Descriptors)	215
Allocation Length	216
read element status data	217
First Element Address Reported	217
Number of Elements Reported	217
Byte Count of Report Available	217
Element Type Code 1H: Picker	218
Element Descriptor Length	218
Byte Count of Descriptor Data Available	218
Element Address	219
Except	219
Full	219
Additional Sense Code and Additional Sense Code Qualifier	219
Element Type Code 2H: Storage Slot	220
PVoltag	221
Element Descriptor Length	221
Byte Count of Descriptor Data Available	221
Element Address	222
Access	222
Except	222
Full	222
Additional Sense Code and Additional Sense Code Qualifier	222
SValid	222
Source Element Address	222
Primary Volume Identification	222
Media Domain	222
Media Type	223
Element Type Code 3H: Import/Export (Mailslot)	224
PVoltag	225
Element Descriptor Length	225
Byte Count of Descriptor Data Available	225
Element Address	226
InEnab	226
ExEnab	226
Access	226
Except	226
Imp/Exp	226
Full	226
Additional Sense Code and Additional Sense Code Qualifier	226
SValid	226
Source Storage Element Address	226
Primary Volume Identification	227
Media Domain	227
Media Type	227
Element Type Code 4H: Drive	228
PVoltag	229
Element Descriptor Length	230
Byte Count of Descriptor Data Available	230
Element Address	230
Access	230
Except	230
Full	230
Additional Sense Code and Additional Sense Code Qualifier	230
Not Bus	230
IDValid	230
LUValid	231
Logical Unit Number	231
SCSI Bus Address	231
SValid	231
Source Storage Element Address	231
Primary Volume Identification	231
Vendor Identification Bytes	231
Product Identification Bytes	232
Product Serial Number	232
Media Domain	232
Media Type	233
3 Library Error Codes	235
Library Error Codes	236
Request Sense Keys	237
Request Sense Additional Sense Code and Qualifier	238
Additional Sense Data Format for Error Recovery	243
FRU Locator	245
Error Code	245
FRU 1	245
FRU 2	245
FRU 3	245
Move Command Attempted	246
Source Element Number	246
Destination Element Number	246
Second Destination Element Number	246
Move Sequence ID	246
Error Code Qualifier	246
Vertical Motor Commanded Position	247
Vertical Motor Actual Position	247
Plunge Motor Commanded Position	247
Plunge Motor Actual Position	247
Translate Motor Commanded Position	247
Translate Motor Actual Position	247
Time Stamp	247
Mechanism State Bit Map (Byte 54)	248
Source Element Bit Map (Byte 55)	248
Destination1 Element Bit Map (Byte 56)	249
Destination2 Element Bit Map (Byte 57)	249
Error Codes	250
Error Code Qualifier	256
Diagnostic Tests	261
Library and Drive Media Event ID Table	264
A Field Replaceable Units	267
Field Replaceable Units (FRUs)	268
B Programmer’s Tips	271
Initial Integration	272
Sense Key Specific Information During Initial Integration	272
Performance Tuning	274
Write Performance	274
Immediate Response with Buffer Mode	274
Read Performance (Read-ahead)	275
Data Transfer Size	276
Non-Volatile Configuration Values	276
Error Analysis	276
Autochanger Load Performance	277
Error Recovery	278
Determining Media Type Loaded	278
Cleaning Errors	278
Drive Cleaning Errors	279
Host System Integration	280
Prerequisites	280
Modifying the SCSI Driver	281
Modifying a SCSI Disk Driver for the Tape Drive	282
Change Considerations	282
Additional Considerations	283
Modifying the Tape Driver for the Library	283
Disconnect Timeouts	284
Overview of the Online Drive Repair	287
The Online Drive Repair Process	287
Communication Methods	288
Host to Library Communication	288
Library to Host Communication	288
Developing Library Manager Software	289
Development Considerations	289
Moving a Tape Cartridge into a Drive	289
Moving a Tape Cartridge from a Drive	290
Other Moves	290
Move Summary	290
Physical Security of Tape Cartridges	290
Volume Management	291
Swap Scheduling	291
Error Recovery	291
Error Detection	292
TapeAlert Specifications	293
Overview	293
Host Software Interface	293
C Move Sequence IDs	295