The first byte contains the operation code — a Group Code that provides eight groups of commands and a Command Code that provides 32 command codes for each group.
The second byte starts the command parameters.
The last byte is the control byte (see "Control Byte Structure").
For some commands, a list of parameters accompanies the request during data out. For all commands, if there is an invalid parameter in the CDB, then the library terminates the command without altering the medium.
The control byte is the last byte of every CDB.
Provides information about the device.
Controls the rules for handling an auto contingent condition caused by a command. When NACA is 0, the command will return a check condition if a contingent allegiance condition occurs.
Causes an interrupt in the initiator allowing a device to respond with intermediate status. This bit is should be 0.
Allows devices that support command linking to continue the I/O process. This bit should be 0.
Indicates the device successfully completed the command.
Occurs when an error, unit exception, or abnormal condition generates sense data caused by one of the following conditions:
Issuing an invalid command or parameter
Issuing a command to a device that is not ready
Detecting a hardware error
Sensing an illegal request
Occurs when the target cannot accept a command from an otherwise acceptable initiator. Normally, to recover from a Busy status, the initiator reissues the command.
Occurs whenever a SCSI initiator attempts to access a logical unit that is reserved by another initiator.
Initialize Element Status (07h) requests an audit of the library. The library accepts this command for compatibility, but it does not perform any action.
At power-on or after the front door opens/closes, the library performs a full audit and then maintains a cartridge inventory during operation. Use Read Element Status (B8h) to obtain the cartridge inventory.
Initialize Element Status with Range (37h) requests an audit for a range of cells in the library. The library accepts this command for compatibility, but it does not perform any action.
At power-on or after the front door opens/closes, the library performs a full audit and then maintains a cartridge inventory while operating. Use Read Element Status (B8h) to obtain the cartridge inventory.
Inquiry (12h) requests information about library parameters.
Note:
The Inquiry command returns Check Condition (02h) status only when it cannot return the requested data. This command will not clear any pending unit attention conditions.Set this to 0.
0 = Requests standard inquiry data
1 = Requests vital support product data
If EVPD is 0, set the page code to 00h.
If EVPD is 1, set the page code to:
00h = Supported vital product page
80h = Unit serial number page
83h = Device identification page
The library transfers either the number of bytes specified by the Allocation Length field or all of the available inquiry data, whichever is less. The page lengths are:
38h (56d) bytes for standard inquiry data
07h (7d) bytes for the supported vital product page
10h (16d) bytes or 16h (22d) bytes for the unit serial number page
2Ch (44d) bytes for the device identification page
000b = The specified peripheral device type is currently connected to this logical unit.
001b = The device server can support the specified peripheral device type on this logical unit. However, the physical device is not currently connected to this logical unit. The library returns this value when either:
The redundant control paths (multi-port) hardware activation file is not installed, and the Inquiry command is received on a non-activated port.
Partitioning is enabled, and the host that issued this command does not have access to a partition. For more information, see "Configuring SCSI Access in a Partitioned Library".
011b = The command was sent to an unsupported logical unit.
08h = The library is a medium changer device.
1Fh = The command was sent to an unsupported logical unit.
1 = The medium is removable.
05h = The library complies with SCSI-3.
0 = The library does not support setting NACA to one in the control byte of a CDB.
1 = The library uses the hierarchical addressing module to identify logical units.
2 = The data complies with the SCSI-3 specification.
33h = 51d bytes of remaining Standard Inquiry Data.
0 = The library does not contain an embedded storage array controller component.
0 = The library does not contain an ACC that may be addressed through this logical unit.
1 = The library supports implicit asymmetric logical unit access. The library can change target port asymmetric access states without a Set Target Port Groups (which is an unsupported command). The library supports Report Target Port Groups (A3h).
The library returns 0.
The library returns 0.
The library returns 0.
0 = There is no vendor specific information with this command.
1 = The library has multiple target ports.
0 = The library is not embedded in or attached to a medium transport element.
The library returns 0.
The library returns 0.
The library returns 0.
Contains the ASCII character sequence ”STK” followed by blanks. If the specified logical unit is not supported, this field contains all blanks.
Contains the ASCII character sequence ”SL4000” followed by blanks.
Contains an ASCII character sequence that represents the product revision level.
The library returns Check Condition status for the Inquiry command only when a severe error occurs. To recover from a Check Condition status report on the Inquiry command, verify that the Inquiry CDB is correct and then retry the Inquiry command.
See Peripheral Qualifier.
00h = The vital page
03h (3d) bytes
00h = The first vital page is page 0 (current page)
80h = Unit Serial Number page
83h = Device Identification Page
See Peripheral Qualifier.
80h = The unit serial number page.
0Ch = 12 bytes of unit serial number data.
12h = 18 bytes of unit serial number data.
Contains a unique ASCII Serial Number for the library. For example:
571XX0000121 = 12 byte unit serial number
464970G+1221XX0005 = 18 byte unit serial number
Where XX indicates the library partition identifier. For nonpartitioned libraries, XX is 00.
See Peripheral Qualifier.
0h = FC protocol.
1 = Binary values
1 = The protocol identifier is valid
0 = The identifier field is associated with the addressed logical unit
1 = The identifier field is associated with the port that received the request
3 = Contains a 64-bit IEEE formatted address
4 = Contains the Relative Target Port Identifier
5 = Contains the Target Port Group Identifier
04h = 4-bytes long
08h = 8-bytes long
An 8-byte identifier. The first 4 bits are the Name Address Authority — NAA (5h). The next 24 bits are the Oracle company ID (00 10 4Fh). The remaining bits are the vendor-specific identifier. The NAA IEEE Registered Identifier is unique for each library and Fibre Channel port.
01h = Port 1
02h = Port 2
03h = Port 3
04h = Port 4
01h = Target Port Group 1
02h = Target Port Group 2
Log Sense (4Dh) returns library error logs and statistics.
Set this to 0.
Set this to 0.
Set this to 0. The library only supports a PC value of 0 (threshold values).
00h = List supported pages
07h = List last n error events page
Set this to 0.
The library transfers either the number of bytes specified by the Allocation Length field or all of the available log sense data, whichever is less. The page lengths are:
06h (6d) bytes for supported pages data
28h (40d) bytes for the last n errors events page
The Supported Pages Page lists all the Log Sense page codes supported by the library.
The Last n Errors Event Page does not return specific error information. Instead, the operator should gather the log/error information from the GUI.
The Mode Select commands specify operating parameters for the library. The library uses the configuration parameters during power-on or after a logical unit reset. If you set the parameter list length field to 0, then no Mode Select data is required. Otherwise, you must provide the following mode parameter data in a parameter list:
A 4-byte or 8-byte Mode Select Parameter Header
An 8-byte Fibre Channel Logical Unit Page
An 8-byte Fibre Channel Port Control Page
A 20-byte Element Address Assignment Mode Page
The library accepts the Mode Select command for compatibility, but the library does not support changing Mode parameters. The library returns a check condition if a SCSI host issues a Mode Select command and attempts to change a mode page. When the library receives a Mode Select command, the library validates all parameters. If a value is invalid, the library returns an error.
Set this to 1 to indicate the page format supports the SCSI-3 specification
Set this to 0.
00h = Transfers no data. This is not an error.
18h (for 6-byte) or 1Ch (for 10-byte) = Transfers Mode Parameter Header and Element Address Assignment Page
0Ch (for 6-byte) or 10h (for 10-byte) = Transfers the Mode Parameter Header and Fibre Channel Logical Unit Page
0Ch (for 6-byte) or 10h (for 10-byte) = Transfers the Mode Parameter Header and Fibre Channel Port Control Page
Any other value is an error and is not supported.
The header definitions for the library must all be 00h.
Mode Select 6-byte Parameter Header
Mode Select 10-byte Parameter Header
Set this to 0.
Set this to 0 to indicate page_0 format.
0h = FC protocol.
Set this to 0.
Set this to 0.
SubPage Format. Set this to 0 to indicate page_0 format.
0h = FC protocol.
Set this to 0.
Set this to 0.
Set this to 0.
Set this to 0.
Set this to 0.
Set this to 0.
Set this to 0.
Set this to 0.
Set this to 100b = 10 second units.
Set this to 1Eh = 300 seconds.
Set this to 0.
1Dh = Element Address Assignment mode page.
12h = 18d bytes of parameter data following this byte
0000h = The address of the robot in the library.
The number of the robots in the library. The number must be the same number returned by Mode Sense.
7D0h (2000d) = The address of the first data cartridge cell in the library or partition.
The number of data cartridge cells in the library or partition. This number depends on the configuration of the library or partition. The number must be the same number returned by Mode Sense. To obtain this value, use Mode Sense of mode page 1Dh.
000Ah (10d) = The address of the first CAP in the library or partition.
The number of CAPs in the library or partition. This number depends on the configuration of the library or partition. The number must be the same number returned by Mode Sense. To obtain this value, use Mode Sense of mode page 1Dh.
3E8h (1000d) = The address of the first drive or empty drive slot in the library or partition.
The number of drives and empty drive slots in the library. This number depends on the configuration of the library. The number must be the same number returned by Mode Sense. To obtain this value, use Mode Sense of mode page 1Dh.
The Mode Sense commands return information about the library's operating mode parameters. The data can be truncated to the length specified in the allocation length field. The library returns a Mode Sense Parameter Header followed by one or more of the following mode pages:
Set this to 0. The library will return 0 for LONGBLA in the parameter data.
The library ignores this field.
0h (00b) = Current Values. The library returns the requested pages with each supported parameter set to its current value.
1h (01b) = Changeable Parameter Values. The library returns the requested pages indicating which parameters the initiator can change (1 indicates a changeable parameters and 0 indicates an unchangeable parameter).
Note:
The library does not support any changeable mode values.2h (10b) = Default Values. The library returns the requested pages with each supported parameter set to its default. The default values are the same as the current values.
3h (11b) = Saved Values. The library does not support any savable pages. If you request Saved Values, the library returns a check condition.
18h = Fibre Channel Logical Unit page
19h = Fibre Channel Port Control page
1Dh = Element Address Assignment page
1Eh = Transport Geometry page
1Fh = Device Capabilities page
3Fh = All pages (in the above order)
Set this to 0.
The length of the parameter list returned by the library. The maximum length for Mode Sense 6-byte is 40h (64d) bytes. The maximum length for Mode Sense 10-byte is 44h (68d) bytes.
The library transfers the number of bytes specified by the Allocation Length or the available Mode Sense data, whichever is less. The length varies based on the Page Code selected:
4 bytes (for Mode Sense 6-byte) or 8 bytes (for Mode Sense 10-byte) for the parameter list header which is always present.
8 additional bytes for the Fibre Channel Logical Unit Control page
8 additional bytes for the Fibre Channel Port Control page
20 additional bytes for the Element Address Assignment page
4 additional bytes for the Transport Geometry page
20 additional bytes for the Device Capabilities page
Mode Sense 6-byte Parameter Header
Mode Sense 10-byte Parameter Header
The bytes of parameter information available regardless of the allocation length. This value excludes the Mode Data Length byte, but includes three additional bytes (for Mode Sense 6-byte) or six additional bytes (for Mode Sense 10-byte) and the length of any mode pages that follow.
The library returns 0.
The library returns 0.
The library returns 0 to indicate page_0 format.
0h = FC protocol.
The library returns 0.
The library returns 0.
0h = FC protocol.
0 = Public Loop supported
1 = Private Loop only supported
The library returns 0.
The library returns 0.
The library returns 0.
The library returns 0.
The library returns 0.
The library returns 0.
The library returns 0.
The library always returns 100b = 10 second units.
The library always returns 1Eh = 300 seconds.
The library returns 0.
1Dh = The Element Address Assignment mode page.
12h = 18d bytes of parameter data following this byte
00h = The address of the robot in the library.
The number of the robots in the library.
7D0h (2000d) = The address of the first data cartridge cell in the library or partition.
The number of data cartridge cells in the library or partition.
000Ah (10d) = The address of the first CAP in the library or partition.
The number of CAPs in the library or partition.
3E8h (1000d) = The address of the first drive or empty drive slot in the library or partition.
The number of drives and empty drive slots in the library.
The library returns 0.
1Eh = the Transport Geometry mode page.
The number of additional types of transport geometry descriptor data to follow the header. Each descriptor has two bytes of information.
02h = The library has one transport mechanism.
0 = The library does not use multiple-sided media.
Identifies the transport element in the system.
00h = The library has one transport element.
DT — Data Transfer Element (drive)
I/E — Import/Export Element (CAP cells)
ST — Storage Element (cartridge storage cell)
MT — Medium transport (robot hand)
The library returns 0.
1Fh = The Device Capabilities mode page.
12h = 18 bytes of device capabilities data to follow.
1 = A tape drive can function as element storage.
1 = A CAP cell can function as element storage.
1 = A cartridge cell can function as element storage.
0 = The robot hand cannot function as element storage. You cannot use the robot as the source or destination of a move.
0 = The robot hand (MT) cannot be the source or destination of a move.
1 = Tape drives (DT), CAP cells (I/E), and cartridge cells (ST) are valid sources or destinations for a move.
0 = The library does not support the exchange medium command.
Move Medium (A5h) moves a cartridge tape from one element location to another. Device Capabilities Page of the Mode Sense command provides a matrix with the valid source and destination element combinations for Move Medium.
The Fast Load option on the library controls the completion of the move command when the destination element is a tape drive. If the fast load option is disabled, the library performs the move motion and waits until the tape drive load operation completes before returning status for the move command. When the fast load option is enabled, the library performs the move motion and verifies the tape drive load starts before returning status for the move command.
Note:
If you issue a Move command from a CAP cell that contains an upside down cartridge, the library will return a check condition and set the sense data to Illegal Request (05h), ASC to 3Bh, and ASCQ to 18h.00h = The default robot hand. All other values will be ignored.
The element address for the cartridge, which can be a storage cell, a CAP slot, or a tape drive.
The element address for the cartridge move, which can be a storage cell, a CAP cell, or a tape drive.
Set this to 0.
00b = The library performs a normal move operation
01b = Not supported
10b = The library performs a mount operation with write protection enabled. This is only valid if the destination is a drive. If the drive does not support this feature or fails to acknowledge the write-protected mount option, the mount fails and the library returns the Hardware Error sense key (04) with an ASC of 40 and an ASCQ of 02 (Drive Error).
11b = The drive performs a rewind, unload, and then move operation. This option is valid only when the source element address is a drive.
Caution:
The 11b option might interfere with operations on the drive data path.Persistent Reserve In (5Eh) returns information about active registrations or an active reservation. You can use Persistent Reserve In to help resolve contention among multiple initiators and multiple-port targets within the system.
00h = Returns Read Keys Data
01h = Returns Read Reservation Data
02h = Returns Report Capabilities Data
03h through 1Fh are reserved.
Indicates the space reserved for the returned parameter list. If the length is not sufficient to contain the entire parameter list, the parameter list will be incomplete. However, a partial list is not an error
The Read Keys Data is a list of all the currently registered reservation keys.
A 32-bit counter that increments each time a Persistent Reserve Out command requests a Register, a Register and Ignore, a Clear, a Preempt, or a Preempt and Abort operation. The counter allows the application client to determine if another application client has changed the configuration.
A Power-On-Reset sets the counter to zero.
The number of bytes in the reservation key list.
Contains the eight-byte reservation keys registered with the library through a Persistent Reserve Out command.
The Read Reservation Data is a description of all currently registered reservation keys.
A 32-bit counter that increments each time a Persistent Reserve Out command requests a Register, a Register and Ignore, a Clear, a Preempt, or a Preempt and Abort operation. The counter allows the application client to determine if another application client has changed the configuration.
A Power-On-Reset sets the counter to zero.
The number of bytes in the reservation descriptor list.
0 = No reservation held
16 = Active reservation data
Each persistent reservation for a logical unit has one reservation descriptor that has the format shown below.
The reservation key for the descriptor data that follows.
Indicates whether a persistent reservation applies to an entire logical unit or to an element. The only valid value is 0h.
0h = The persistent reservation applies to the logical unit
3h = Exclusive access. The initiator holding the persistent reservation has exclusive access. Some commands (such as Move Medium) are only allowed for the persistent reservation holder.
6h = Exclusive Access, Registrants Only. Any currently registered initiator has exclusive access. Some commands (such as Move Medium) are only allowed for registered I_T nexuses.
The length in bytes of the parameter data.
0 = The library processes the Reserve and Release commands as defined in SPC-2.
0 = The library does not support the SPEC_I_PT bit in the Persistent Reserve Out (5Fh) command parameter data.
0 = The library does not support the ALL_TG_PT bit in the Persistent Reserve Out (5Fh) command parameter data.
0 = The library does not support the persist through power loss capability for persistent reservations and the APTPL bit in the Persistent Reserve Out (5Fh) command parameter data.
0 = Ignore the persistent reservation type mask.
1 = The persistent reservation type mask field contains a bit map indicating which persistent reservation types the library supports.
0 = The library does not support the Persist Through Power Loss Activated bit.
0 = The library does not support the Write Exclusive-All Registrants persistent reservation type.
1 = The library supports this persistent reservation type.
0 = The library does not support the Write Exclusive-Registrants Only persistent reservation type.
1 = The library supports this persistent reservation type.
0 = The library does not support the Write Exclusive persistent reservation type.
0 = The library does not support the Exclusive Access-All Registrants persistent reservation type.
Persistent Reserve Out (5Fh) uses service actions to create, manage, or remove a persistent reservation.
The application client provides a registered reservation key that identifies the initiator. An application client may use the Persistent Reserve In (5Eh) command to obtain the reservation key for the initiator holding a persistent reservation. The client may use the Persistent Reserve Out command to preempt that persistent reservation.
Note:
For more information on command processing when the library has a persistent reservation, see "Reservation Handling".00h = Register — registers or unregisters a reservation key.
01h = Reserve — creates a persistent reservation of the scope and type specified in Byte 2.
02h = Release — removes an active persistent reservation, if the initiator holds the persistent reservation.
03h = Clear — clears all persistent reservations for all initiators and reset all reservation keys to 0.
04h = Preempt — removes all reservations and registrations for the initiators associated with the service action reservation key in the parameter list.
05h = Preempt and Abort. Perform a Preempt action and terminate all commands by initiators associated with the cleared service action reservation key. This also clears any CAP locks and contingent allegiance in effect for these initiators.
06h = Register and Ignore Existing Key. Registers or unregisters a reservation key with the library.
Indicates whether a persistent reservation applies to an entire logical unit or to an element.
0h = The persistent reservation applies to the logical unit (library or partition). This is the only valid value.
3h = Exclusive access. The initiator holding the persistent reservation has exclusive access. Some commands (such as Move Medium) are only allowed for the persistent reservation holder.
6h = Exclusive Access, Registrants Only. Any currently registered initiator has exclusive access. Some commands (such as Move Medium) are only allowed for registered initiators.
Always 18h (24d) bytes. The parameter data for the Persistent Reserve Out command includes all fields, even when a field is not required for the specified service action.
An 8-byte value that identifies the initiator.
If the service action is Register or Register and Ignore Existing Key, this field must contain the new reservation key.
If the service action is Preempt or Preempt and Abort, this field must contain the reservation key of the persistent reservation or registration being preempted.
Set this to 0.
Set this to 0.
Set this to 0.
Table 3-1 Persistent Reserve Out Service Actions and Parameters
Persistent Reserve Action | Service Action | Scope | Type | Reservation Key | Service Action (SA) Res. Key | SPEC_I_PT, ALL_TG_PT, and APTPL | Unit Attention Notes |
---|---|---|---|---|---|---|---|
Register a Key |
0 |
Ignored |
Ignored |
0 |
SA Key |
0 |
N/A |
Register a New Key |
0 |
Ignored |
Ignored |
Key |
SA Key |
0 |
N/A |
Unregister a Key |
0 |
Ignored |
Ignored |
Key |
0 |
0 |
See 1. |
Reserve: Exclusive Access |
1 |
0 |
3 |
Key |
Ignored |
Ignored |
N/A |
Reserve: Exclusive Access Registrants Only |
1 |
0 |
6 |
Key |
Ignored |
Ignored |
N/A |
Release: Exclusive Access Reservation |
2 |
0 |
3 |
Key |
Ignored |
Ignored |
N/A |
Release: Exclusive Access Registrants Only Reservation |
2 |
0 |
6 |
Key |
Ignored |
Ignored |
See 2. |
Clear: Reservation and All Host Keys |
3 |
Ignored |
Ignored |
Key |
Ignored |
Ignored |
See 3. |
Preempt: No Active Reservation |
4 |
Ignored |
0, 3, or 6 |
Key |
SA Key |
Ignored |
See 4. |
Preempt: Active Reservation |
4 |
Ignored |
3 or 6 |
Key |
SA Key |
Ignored |
See 5. |
Preempt and Abort: No Active Reservation |
5 |
Ignored |
0, 3, or 6 |
Key |
SA Key |
Ignored |
See 4. |
Preempt and Abort: Active Reservation |
5 |
Ignored |
3 or 6 |
Key |
SA Key |
Ignored |
See 5. |
Register and Ignore Existing Key |
6 |
Ignored |
Ignored |
Ignored |
SA Key |
Ignored |
N/A |
Unregister and Ignore Existing Key |
6 |
Ignored |
Ignored |
Ignored |
0 |
0 |
See 1. |
If the initiator unregistering the reservation key also holds a persistent reservation, then the library releases the reservation and removes the registration key. If the initiator had an Exclusive Access Registrants Only reservation, the library sends a Reservations Released Unit Attention (06h/2Ah/04h) to all other registered initiators.
When an initiator releases an Exclusive Access Registrants Only reservation, the library sends a Reservations Released Unit Attention (06h/2Ah/04h) to all other registered initiators.
When an initiator requests a Clear service action, the library clears the persistent reservation (if present) and unregisters all initiators. The library sends a Reservations Preempted Unit Attention (06h/2Ah/03h) to the other registered initiators.
Note:
You should only clear reservations for error recovery.When an initiator requests a Preempt or Preempt and Abort service action and there is no active persistent reservation, the library unregisters all reservation keys matching the service action key. The library sends Registrations Preempted Unit Attention (06h/2Ah/05h) to the affected initiators.
When an initiator requests a Preempt or Preempt and Abort service action and there is an active persistent reservation matching the service action key, the library:
Modifies the persistent reservation with the requesting initiator's reservation key and type. If the preempting initiator modified the persistent reservation type, the library sends a Reservations Released Unit Attention (06/2Ah/04h) all other initiators that still have a persistent registration.
Unregisters all other initiators with a reservation key matching the service action key and sends a Registrations Preempted Unit Attention (06h/2Ah/03h) to the affected initiators.
Position to Element (2Bh) moves the robot to the destination element.
0000h = The element address of the robot.
The element address of the storage cell, CAP cell, or drive. The robot positions the hand at this location.
Set this to 0.
Prevent/Allow Medium Removal (1Eh) locks or unlocks the CAPs. The library does not maintain a separate "prevent" or "allow" state for each initiator. There is a single state for all initiators. Therefore, if any initiator sends a Prevent Medium Removal command, the library locks the CAPs. If any initiator sends an Allow Media Removal command, the library unlocks the CAPs.
Note:
You can also lock or unlock the CAPs from the GUI.Additionally, the library unlocks the CAPs:
During a library power-on or reset
After a LUN reset or a target reset
After a Persistent Reservation Preempt & Abort command
If a partition has no CAPs, the Prevent/Allow Media command has no effect and returns Good (00h) status. In a partitioned library with a shared CAPs, the library maintains the Prevent/Allow state until the partition owns the CAPs (see Example 2-2).
0 = Allow — The library unlocks the CAPs. You can open the CAP using the operator panel.
Note:
When Prevent = 0, the library disregards device reservations and executes the command. For more information, see "Reservation Handling".1 = Prevent — The library locks the CAPs.
Read Element Status (B8h) returns the status of elements in the library or partition.
The library returns an eight-byte Element Status Data Header, followed by an element page (or four element pages if you set the type code to All Element Types). Each element page consists of an eight-byte Element Status Page Header, followed by the element type descriptor. Supported element type descriptors include:
0 = The library does not report Volume Tag information
1 = The library reports Volume Tag information
0h = All Element Types
1h = Medium Transport Element (robot hand)
2h = Storage Element (cartridge cells)
3h = Import/Export Element (CAP cells)
4h = Data Transfer Element (drives or empty drive slots)
Specifies the minimum element address. The library reports elements with an element address greater than or equal to the Starting Element Address.
The maximum number of element descriptors to transfer. This is not an element address range.
The library ignores the CurData bit and will use the robots to obtain information if needed.
0 = The library can use the robots to gather data
1 = The library will not perform mechanical operations to obtain the data
0 = The library will not return device identification information
1 = The library returns device identification information for data transfer elements.
The length in bytes of the space allocated by the initiator for the transfer of element descriptors. Only complete element descriptors are transferred. Data can be truncated based on the length specified in the allocation field.
The lowest element address found for the specified Element Type Code that is greater than or equal to the Starting Element Address.
The number of elements found for the specified Element Type Code that are greater than or equal to the Starting Element Address. This number is always less than or equal the Number of Elements specified in the CBD.
The number of bytes of element status data available. This count does not include the Element Status Data header bytes. The count is not adjusted to match the allocation length you specified in the Read Element Status command.
1h = Medium Transport Element (robot hand)
2h = Storage Element (cartridge cells)
3h = Import/Export Element (CAP cells)
4h = Data Transfer Element (drives or empty drive slots)
0 = The library omits Primary Volume Tag information from the element descriptors.
1 = The library includes Primary Volume Tag information in the element descriptors.
0 = The library does not support Alternative Volume Tags.
The total number of bytes contained in a single element descriptor.
The number of bytes of element descriptor data available. This count does not include the Element Status Page header bytes. The count is not adjusted to match the allocation length you specified in the Read Element Status command.
Medium Transport Element Descriptor
Import/Export Element Descriptor
Medium Transport Element Descriptor
Import/Export Element Descriptor
Data Transfer Element Descriptor (DvcID = 0)
Data Transfer Element Descriptor (DvcID = 1)
Element Descriptor Definitions
The address of the element (robot hand, cartridge cell, CAP cell, drive, or empty drive slot).
0 = No operator intervention required to make the CAP accessible
1 = Operator intervention required to make the CAP accessible
0 = The import/export element is a CAP. The cartridge will not leave the library when prevented by the Prevent/Allow Medium Removal (1Eh) command.
1 = The CAP supports importing cartridges.
1 = The CAP supports exporting cartridges.
0 = The robot cannot access the element. For Import/Export elements, this can occur when the CAP is open or a CAP magazine was removed. For Data transfer elements, this can occur when a cartridge is loaded in a drive.
1 = The robot can access the element
0 = The element is in a normal state
1 = The element is in an abnormal state. The Additional Sense Code (ASC) and the Additional Sense Code Qualifier (ASCQ) fields contain information regarding the abnormal state. Other fields in the descriptor might be invalid and should be ignored.
0 = The robot placed the cartridge in the CAP for an export operation.
1 = An operator placed the cartridge in the CAP for an import operation.
0 = The element does not contain a cartridge
1 = The element contains a cartridge
This field is valid only if the Except bit is set. In the case of an exception, it contains an ASC as defined for Request Sense data.
This field is valid only if the Except bit is set. In the case of an exception, it contains an ASCQ as defined for Request Sense data.
Condition | ASC Value | ASCQ Value |
---|---|---|
CAP Open | 3Ah | 02h |
Empty Drive Slot (no drive installed) | 3Bh | 1Ah |
Drive Hardware Error | 40h | 02h |
0 = The Source Element Address and Invert fields are not valid.
1 = The Source Element Address and Invert fields are valid.
0 = The library does not support multi-sided media.
0 = The element is enabled.
1 = The element is disabled (for example an open CAP, a drive hardware error, or empty drive slot).
The type of medium currently present in the element as determined by the medium changer.
0h = Unspecified - the medium changer cannot determine the medium type.
1h = Data Medium
2h = Cleaning Medium
This field is valid only if the SValid field is 1. This field provides the address of the last storage element this cartridge occupied. The element address value may or may not be the same as this element.
When PVolTag is 1, the library returns volume tag information. When PVolTag is 0, the library omits volume tag information.
The Primary Volume Tag field contains the null-terminated ASCII barcode label on the tape cartridge. If the label on the cartridge tape is not readable or if the element is empty, the Primary Volume Tag field is filled with 36 bytes of zeros. The "Volume Label Format" controls the presentation of the volser in the Primary Volume Tag field. The library supports the following settings:
Full Label
No Type Checking
Prepend Last Two Characters
Trim Last Character
Trim Last Two Characters
Trim First Two Characters
Trim First Character
For more information, see the SL4000 GUI help.
0h = Reserved (not supported) for the Medium Transport Element, Storage Element, Import/Export Element, or Data Transfer Element (DvcID = 0) descriptors.
2h = The identifier contains ASCII graphic codes (code values 20h through 7Eh) for Data Transfer Element (DvcID = 1) descriptor.
The format and assignment authority for the identifier.
0h = The library returns vendor specific data.
The combined length of the Identifier and the Identifier Pad.
00h = The library returns 0 bytes of identifier data in the descriptors for Medium Transport Elements, Storage Elements, Import/Export Elements, or Data Transfer Elements (DvcID = 0).
20h = The library returns 32 bytes of identifier data for the Data Transfer Element (DvcID = 1).
The ASCII Serial Number for the tape drive associated with this data transfer element.
Contains ASCII blanks. The number of blanks depends on the length of the Identifier field. The combined length of the Identifier field and the Identifier Pad is 32 bytes.
43h ('C') = The element contains a cleaning cartridge.
4Ch ('L') = The element contains an LTO cartridge.
54h ('T') = The element contains a T10000 cartridge.
FFh = The media domain cannot be determined or the element is empty.
FFh = The media type cannot be determined or the element is empty.
If the Media Domain is 43h (C):
C = The element contains a T10000 Version 2 cleaning cartridge
L = The element contains a T10000 Universal cleaning cartridge.
T = The element contains a T10000 Version 1 cleaning cartridge.
U = The element contains a Universal LTO cleaning cartridge.
If the Media Domain is 4Ch (L):
3 = The element contains a 400 GB Generation 3 LTO cartridge.
4 = The element contains an 800 GB Generation 4 LTO cartridge.
5 = The element contains a 1.5 TB Generation 5 LTO cartridge.
6 = The element contains a 2.5 TB Generation 6 LTO cartridge.
7 = The element contains a 6 TB Generation 7 LTO cartridge.
8 = The element contains a 12 TB Generation 8 LTO cartridge.
T = The element contains a 400 GB Generation 3 LTO WORM cartridge.
U = The element contains an 800 GB Generation 4 LTO WORM cartridge.
V = The element contains a 1.5 TB Generation 5 LTO WORM cartridge.
W = The element contains a 2.5 TB Generation 6 LTO WORM cartridge.
X = The element contains a 6 TB Generation 7 LTO WORM cartridge.
Y = The element contains a 12 TB Generation 8 LTO WORM cartridge.
If the Media Domain is 54h (T):
1 = The element contains a T10000 Version 1 cartridge.
2 = The element contains a T10000 Version 2 cartridge.
S = The element contains a T10000 Version 1 Sport cartridge.
T = The element contains a T10000 Version 2 Sport cartridge.
4Ch (L) = The drive supports LTO cartridges.
54h (T) = The drive supports T10000 cartridges.
FFh = The element domain cannot be determined.
FFh = The type cannot be determined.
If the Transport Domain is 4Ch (L):
3Bh = HP Generation 5 LTO drive
3Ch = IBM Generation 5 LTO drive
3Dh = HP Generation 6 LTO drive.
3Eh = IBM Generation 6 LTO drive.
2Dh = IBM Generation 7 LTO drive.
2Eh = IBM Generation 8 LTO drive.
If the Transport Domain is 54h (T):
0Dh = StorageTek T10000A drive.
0Eh = StorageTek T10000A drive in 3590 emulation mode.
18h = StorageTek T10000A Encrypting drive.
19h = StorageTek T10000A Encrypting drive in 3590 emulation mode.
1Ah = StorageTek T10000B drive.
1Bh = StorageTek T10000B drive in 3590 emulation mode.
1Ch = StorageTek T10000B Encrypting drive.
1Dh = StorageTek T10000B Encrypting drive in 3590 emulation mode.
22h = StorageTek T10000C drive.
23h = StorageTek T10000C drive in 3590 emulation mode.
24h = StorageTek T10000C Encrypting drive.
25h = StorageTek T10000C Encrypting drive in 3590 emulation mode.
26h = StorageTek T10000D drive.
27h = StorageTek T10000D drive in 3590 emulation mode.
28h = StorageTek T10000D Encrypting drive.
29h = StorageTek T10000D Encrypting drive in 3590 emulation mode.
2Ah = StorageTek T10000D Fibre Channel over Ethernet.
2Bh = StorageTek T10000D Fibre Channel over Ethernet Encrypting drive.
The 32-byte ASCII serial number for the drive.
For drives with a serial number less than 32 bytes, the library left-justifies the value by returning ASCII blanks for the unused less-significant bytes. If the serial number is not available from a drive that should support an ASCII serial number, the library returns all ASCII blanks.
Release (17h) releases a unit reservation of the library. Only the initiator that made the reservation can release the reservation. If another initiator attempts to release a unit reservation, the library returns Good (00h) status, but does not release the reservation. If the library has no active reservations, requesting a release does not cause an error.
Report LUNS (A0h) returns the known LUNs to which the initiator can send commands.
00h = The library returns LUN addresses limited to the LUN addressing method, peripheral device addressing method, and the flat space addressing method.
02h = The library returns all LUNs accessible to the initiator.
The number of bytes allocated for data to be returned from the Report LUNs command.
The Allocation must be at least 16 bytes. If it is less, the library returns a check condition with the sense key set to "illegal request" and the additional sense data set to "invalid field" in the command descriptor block (CDB).
The library returns the length in bytes of the LUN list available for transfer. It is equal to 8 times the number of available logical units for the initiator.
For example: If the allocation length is 16 bytes and 2 logical units are available, this command will return the 8-byte header and 1 logical unit descriptor; however, the LUN list length will still be 16 because 16 bytes were available if the allocation length was sufficient.
00b = The library is using single level LUN addressing
0h = There is a logical unit at the current level
The value of the LUN.
00h = The library only uses single level addressing.
Report Target Port Groups (A3h) returns the Target Port Group data for all ports.
0Ah
The length of the parameter list the library returns. The library transfers either the number of bytes specified by the Allocation Length field or all of the available Report Target Port Group data, whichever is less.
The minimum allocation length required to return all data depends on the number of FC ports and the redundant control paths activation file.
If the library has the redundant control paths (multi-port) activation file:
14h (20d) = The library has two active FC ports (1 and 2).
1Ch (28d) = The library has four active FC ports (1, 2, 3 and 4).
If the library does not have the redundant control paths (multi-port) activation file:
1Ch (28d) = The library has one active FC ports (1) and one unavailable port (2).
24h (36d) = The library has two active FC ports (1 and 3) and two unavailable ports (2 and 4).
For more information on port activation, see "Behavior of Unavailable Fibre Channel Ports".
0 = The target port group is not a preferred target port
1 = The target port group is a preferred target port. All ports in the Active/Optimized group are preferred.
0h = Active/Optimized — the ports in the group are fully operational.
3h = Unavailable — The library does not have the redundant control paths (multi-port) activation file installed.
0 = The library does not support the transitioning asymmetric access state.
1 = The library supports the unavailable asymmetric access state.
0 = The library does not support the standby asymmetric access state.
0 = The library does not support the active/non-optimized asymmetric access state.
1 = The library supports the active/optimized asymmetric access state.
01h = Target Port Group 1
02h = Target Port Group 2
2 = The target port group asymmetric access state is altered by implicit asymmetrical logical unit access behavior.
The number of target ports that are in the target port group and the number of target port descriptors in the target port group descriptor. This can range from 1 to 4.
The port number. This can range from 1 to 4.
Request Sense (03h) returns sense data. The library generates sense data if the previous command terminated with Check Condition (02h) status. Multiple errors might occur during the processing of a single SCSI command. The sense key reflects the first error that occurred.
If you issue a Request Sense command to an unsupported LUN, the library does not return a check condition. Instead, the library returns sense data with Sense Key set to Illegal Request (05h), ASC set to LUN Not supported (25h), and ASCQ set to 00h.
If the library is partitioned and you issue a Request Sense command from an initiator that has not been configured with access, the library does not return a check condition. Instead, the library returns sense data for LUN Access not Authorized with the Sense Key set to Not Ready (02h), ASC set to 74h and ASCQ set to 71h.
If no sense data is available, the library returns sense data with the Sense Key set to No Sense (0h), ASC set to Not Additional Sense information (00h), and the ASCQ set to 00h.
The library returns Check Condition (02h) status for a Request Sense command only to report errors specific to the command itself — for example, if the library detects a nonzero reserved bit in the CDB. If the library returns a Check Condition (02h) status for a Request Sense command, the sense data might be invalid.
0 = The library will return fixed format sense data.
The number of bytes allocated for returned sense data. The library provides a maximum of 14h (20d) bytes of sense data.
0 = The library does not return data in the Information field.
70h = The library returns only current errors.
00h = The library does not support segment numbers.
Describes the error, along with ASC and ASCQ. See Additional Sense Codes and Qualifiers.
0h = No Sense, indicating a successful command.
2h = Not Ready
3h = Medium Error
4h = Hardware Error
5h = Illegal Request
6h = Unit Attention
Bh = Aborted Command
00h = The library does not support this field.
0Ch = Indicates there are 12d bytes of additional sense bytes to follow. This value is not truncated to reflect the actual transfer length.
00h = The library does not support this field.
Describes the error. See Additional Sense Codes and Qualifiers.
Describes the error. See Additional Sense Codes and Qualifiers.
00h = The library does not support this field.
1 = The C/D and field pointer are valid
0 = Ignore the C/D and field pointer
0 = The check condition status resulted from illegal parameter in the parameter list.
1 = The check condition status resulted from illegal parameter in the CDB.
0 = The library does not support this field.
0h = The library does not support this field.
The number of the byte where the error occurred. When a multiple-byte field is in error, the Field Pointer contains the value of the most significant byte of the field, which is lowest byte number. Byte numbers start at 00.
The library generates a Not Ready error code if you send a command when the library is in a not ready state.
Description | Sense Key | ACS | ASCQ |
---|---|---|---|
Not Ready, Cause Not Reportable | 2h | 04h | 00h |
Not Ready, In Process of Becoming Ready | 2h | 04h | 01h |
Not Ready, Manual Intervention Required | 2h | 04h | 03h |
Not Ready, Maintenance Mode | 2h | 04h | 82h |
Not Ready, Logical Unit Not Accessible, Target Port In Unavailable State | 2h | 04h | 0ch |
Not Ready, Cleaning Cartridge Installed | 2h | 30h | 03h |
Not Ready, Insufficient Resources | 2h | 55h | 03h |
Not Ready, Cartridge Access Port Open | 2h | 3Ah | 02h |
Not Ready, LUN Access Not Authorized | 2h | 74h | 71h |
The library detected a not ready state after execution of the command was started.
The library is initializing and performing an audit. Initialization occurs at:
Power-on
After the door opens and closes
When requested from the operator panel or GUI
As part of a recovery during certain failures
The library is in an inoperable state. The operator should check the user interface to determine what action is required.
The library was placed in maintenance mode from the operator panel or user interface.
The FC port is in an unavailable access state and has not been enabled with a hardware activation file. The port only supports a limited set of commands. See "Behavior of Unavailable Fibre Channel Ports".
The library is performing an Auto Clean function on the tape drive requested.
The library detected that the CAP is open and a SCSI command was issued to access the CAP.
The library was not able to complete the command. The host should reissue the command.
The library has the partitioning activation file installed, and the host that issued the command does not have access to a partition. For more information, see "Configuring SCSI Access in a Partitioned Library".
The library generates a Medium Error when a SCSI move command terminates with a non-recovered error condition, which may have been caused by a flaw in the medium or an error in the recorded data.
Description | Sense Key | ASC | ASCQ |
---|---|---|---|
Medium Error, Cleaning Cartridge Expired | 3h | 30h | 13h |
The source cartridge for a SCSI move to a drive is an expired cleaning cartridge.
The library generates a Hardware Error if it detects a hardware or firmware error during command execution.
Description | Sense Key | ASC | ASCQ |
---|---|---|---|
Hardware Error, General | 4h | 40h | 01h |
Hardware Error, Tape Drive | 4h | 40h | 02h |
Hardware Error, Cartridge Access Port | 4h | 40h | 03h |
Hardware Error, Embedded Software | 4h | 44h | 00h |
Hardware Error, Media Load/Eject Failed | 4h | 53h | 00h |
The library detected an internal electronics error during a command. This includes the electronics, vision system, and robotics of the library.
An operation to the drive failed. The problem could be the tape drive or the interface between the library and tape drive.
The CAP failed.
The embedded software that controls the SCSI interface detected an unexpected condition. This error is used for arbitrary limitations of the embedded software.
A cartridge mount or dismount failed to complete.
Any illegal parameters in the CDB or parameter list for a particular command generates an Illegal Request sense key.
In some cases, additional information is available in Byte 15 of the sense data, which includes the sense-key-specific-value (SKSV) and command/data (C/D) fields. This information indicates the byte in the command descriptor block or the parameter list that is in error. If available, the SKSV bit in the sense data is set to 1.
Description | Sense Key | ASC | ASCQ | SKSV |
---|---|---|---|---|
Parameter Length Error | 5h | 1Ah | 00h | Yes |
Invalid Command | 5h | 20h | 00h | Yes |
Invalid Element | 5h | 21h | 01h | No |
Invalid Field in CDB | 5h | 24h | 00h | Yes |
Logical Unit Not Supported | 5h | 25h | 00h | No |
Invalid Field in Parameters | 5h | 26h | 00h | Yes |
Invalid Release of Persistent Reservation | 5h | 26h | 04h | No |
Incompatible Medium | 5h | 30h | 00h | No |
Saving Parameters Not Supported | 5h | 39h | 00h | Yes |
Medium Not Present, Drive Not Unloaded | 5h | 3Ah | 00h | No |
Destination Element Full | 5h | 3Bh | 0Dh | No |
Source Element Empty | 5h | 3Bh | 0Eh | No |
Magazine Removed | 5h | 3Bh | 12h | No |
Empty Tape Drive Slot | 5h | 3Bh | 1Ah | No |
Upside-down Cartridge Move from CAP Not Allowed | 5h | 3Bh | 18h | No |
The library generates a Unit Attention sense key for all initiators if the library needs to inform the host of an asynchronous event.
Description | Sense Key | ASC | ASCQ |
---|---|---|---|
Not Ready-to-Ready Transition | 06h | 28h | 00h |
CAP Element Accessed | 06h | 28h | 01h |
Power On Occurred | 06h | 29h | 01h |
LUN Reset | 06h | 29h | 03h |
Target Reset | 06h | 29h | 03h |
Mode Parameters Changed | 06h | 2Ah | 01h |
Reservations Preempted | 06h | 2Ah | 03h |
Reservations Released | 06h | 2Ah | 04h |
Registrations Preempted | 06h | 2Ah | 05h |
Asymmetric Access State Changed | 06h | 2Ah | 06h |
Commands Cleared by Another Initiator | 06h | 2Fh | 00h |
Data Transfer Device Removed | 06h | 3Bh | 1Ah |
Data Transfer Device Inserted | 06h | 3Bh | 1Bh |
LUNs Data Has Changed | 06h | 3Fh | 0Eh |
The library transitioned to a Ready state from a Not Ready state. The library sends this unit attention to all initiators.
The operator opened and closed the CAP. The library sends this unit attention to all initiators. You can issue a Read Element Status command to obtain an updated inventory (see "Read Element Status (B8h)").
Occurs after the library powers-on, after an IPL (initial program load) from the operator panel, or after a reset over the interface. The library sends this unit attention to all initiators.
The library is clear of all I/O processes following the LUN reset. The library sends this unit attention to all initiators.
The library is clear of all I/O processes following the Target reset. The library sends this unit attention to all initiators.
The operator added or removed elements from a partition. Send a Read Element Status (B8h) command to obtain an updated inventory. Send a Mode Sense command with Element Address page code to request the current count of each element type.
A different initiator issued a Persistent Reservation Out command that cleared the registration for this initiator or cleared a reservation that affects this initiator.
The redundant control paths (multi-port) hardware activation files was added or removed from the library. This unit attention alerts the host that the Report Target Ports Group Data has changed.
A different initiator sent a Clear Task Set Task Management function, which cleared all commands for this initiator.
The operator physically removed a drive. If partitioned, the library only sends this unit attention to hosts associated with the affected partition.
The operator physically inserted a drive. If partitioned, the library only sends this unit attention to the hosts associated with the affected partition.
The LUN configuration for the initiator has changed. The library sends this unit attention when the operator adds or removes a LUN connection from a partition for the initiator.
The library generates an Aborted Command error code when a SCSI command is aborted.
Description | Sense Key | ASC | ASCQ |
---|---|---|---|
Mechanical Positioning Error | 0Bh | 15h | 01h |
Initiator Detected Error | 0Bh | 48h | 00h |
Command Phase Error | 0Bh | 4Ah | 00h |
Data Phase Error | 0Bh | 4Bh | 00h |
Command Overlap | 0Bh | 4Eh | 00h |
Request Volume Element Address (B5h) returns the results of a previous Send Volume Tag command.
The returned data consists of an eight-byte Volume Element Address Header, followed by to four element pages (one page per element type). Each element page consists of an eight-byte Element Status Page Header, followed by the element type descriptor. Supported element type descriptors include:
0 = The library will not report Volume Tag information in the Element Descriptor data.
1 = The library will report Volume Tag information in the Element Descriptor data.
Specifies the minimum element address. The library reports elements with an element address greater than or equal to the Starting Element Address.
The maximum number of element descriptors to transfer. This is not an element address range.
The length in bytes of the space allocated by the initiator for the transfer of element descriptors. Only complete element descriptors are transferred. Data can be truncated based on the length specified in the allocation field.
The lowest element address found for the specified Element Type Code that is greater than or equal to the Starting Element Address.
The number of elements found for the specified Element Type Codes that is greater than or equal to the Starting Element Address. This number is always less than or equal the Number of Elements.
5h = The action code from the previous Send Volume Tag command.
The number of bytes of element status data available. This count does not include the Element Status Data header bytes. The count is not adjusted to match the allocation length you specified in the Read Element Status command.
These pages are in the same format as the Read Element Status (B8h) command pages. See "Element Status Page Header" and "Element Descriptors".
Reserve (16h) allows the initiator to reserve the entire library or partition.
Note:
For more information on command processing when the library has a Unit Reservation, see "Reservation Handling".Send Diagnostic (1Dh) requests a self-diagnostic test. The library accepts this command for compatibility, but performs no action.
1 = Page format specified by SCSI-3.
1 = The library will run the default self test.
Set this to 0.
Set this to 0.
0h = For the default self test.
8h = For extended diagnostics (not supported).
Send Volume Tag (B6h) requests a VOLSER label template. The library uses the template to search for cartridges. You can send a subsequent Request Volume Element Address (B5h) command to transfer the results of this search.
0h = All Element Types
1h = Medium Transport Element (robot hand)
2h = Storage Element (cartridge cells)
3h = Import/Export Element (CAP cells)
4h = Data Transfer Element (drive)
Specifies the minimum element address. The library reports elements with an element address greater than or equal to the Starting Element Address.
5h = The library supports the translate and search primary volume tag function.
00h = No data. The library does not consider this an error.
28h = A volume identification template
This ASCII field specifies a volume identification search template. The first 00 hexadecimal terminates the volume identification search template. The remaining characters are set to 0.
Allowed characters are A through Z, digits 0 through 9, and special characters that include the dollar sign ($), the pound character (#), and the ASCII space character. The wild-card characters ”*” and ”?” (2Ah and 3Fh) also may be used.
Ignore this field.
Ignore this field.
Test Unit Ready (00h) allows the initiator to determine if the library is powered on and ready to accept additional commands. This is not a request for a library self-test.
The Test Unit Ready command returns a Good (00h) status if the library is ready to accept additional commands or returns a Check Condition (02h) if the library is not ready or if there are pending Unit Attentions.