storage tape show

Display information about tape drives and media changers

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The storage tape show command displays information about tape drives and media changers attached to the cluster. Where it appears in the remainder of this document "device" may refer to either a tape drive or a media changer. By default, this command displays the following information about all tape drives and media changers:

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-alias ]
Displays the tape drive/media changer alias with the following details:
  • Node to which tape drive/media changer is attached
  • Device ID of the tape drive/media changer
  • Alias name of the tape drive/media changer
  • Alias mapping for tape drive/media changer
| [-connectivity ]
Displays the connectivity from the node to the tape drive/media changer with the following details:
  • Node to which tape drive/media changer is attached
  • Device ID of the tape drive/media changer
  • Tape drive/media changer description
  • Type of device: tape drive or media changer
  • Interface type for the tape drive/media changer
  • World Wide Node Name of tape drive/media changer
  • World Wide Port Name of tape drive/media changer
  • Serial Number of tape drive/media changer
  • Tape drive/media changer errors
  • Initiator port which hosts the tape drive/media changer
  • Alias name of the tape drive/media changer
  • Operational state of tape drive/media changer
  • Functional status of tape drive/media changer
| [-device-names ]
Displays the tape drive names for used tape positioning using the following details: rewind, no rewind, unload/reload and density
  • Node to which tape drive/media changer is attached
  • Device ID of the tape drive/media changer
  • Tape drive/media changer description
  • Device Names that include Rewind, no Rewind, Unload/Reload
| [-status ]
Displays the status of tape drive/media changer with the following details:
  • Device ID of the tape drive/media changer
  • Tape drive/media changer description
  • World Wide Node Name of tape drive/media changer
  • World Wide Port Name of tape drive/media changer
  • Serial Number of tape drive/media changer
  • Alias name of the tape drive/media changer
  • Format used for tape cartridge mounted by tape drive
  • Tape drive/media changer errors
  • Node to which tape drive/media changer is attached
  • Operational state of tape drive/media changer
  • File number following last tape drive I/O operation
  • Block number following last tape drive I/O operation
  • Residual count following last tape drive I/O operation
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-device-id <text>] - Device ID
Selects the tape drive/media changer with the specified device ID.
[-node {<nodename>|local}] - Node
Displays detailed information about tape drives or media changers on the specified node.
[-device-type <text>] - Device Type
Selects the devices with the specified type of tape drive or media changer.
[-description <text>] - Description
Selects the tape drives/media changers with the specified description.
[-alias-name <text>] - Alias Name
Selects the tape drive/media changer with the specified alias name.
[-alias-mapping <text>] - Alias Mapping
Selects the tape drive/media changer with the specified alias mapping.
[-wwnn <text>] - World Wide Node Name
Selects the tape drives/media changers with the specified World Wide Node Name.
[-wwpn <text>] - World Wide Port Name
Selects the tape drive/media changer with the specified World Wide Port Name.
[-serial-number <text>] - Serial Number
Selects the tape drive/media changer with the specified serial number.
[-functional-status {unknown|normal|error}] - Functional Status
Selects the tape drives/media changers with the specified functional status of the device.
[-device-if-type {unknown|fibre-channel|SAS|pSCSI}] - Device Interface Type
Selects the tape drives/media changers with the specified interface type.
[-device-state {unknown|available|ready-write-enabled|ready-write-protected|offline|in-use|error|reserved-by-another-host|normal}] - Operational State of Device
Selects the tape drives/media changers with the specified operational state.
[-format <text>, ...] - Tape Cartridge Format
Selects the tape drives with the specified tape format.
[-error <text>] - Tape Error
Selects the tape drives/media changers with the specified error string.
[-initiator <text>] - Initiator Port
Selects the tape drives/media changers with the specified initiator port.
[-file-number <integer>] - File Number
Selects the tape drives/media changers with the specified file number. The file number is the number of file marks between the beginning of media and current logical position. File number gets modified on write file mark, and forward or backward space file operations. A value of -1 indicates unknown position on the tape media or tape not loaded in the tape drive.
[-block-number <integer>] - Block Number
Selects the tape drives/media changers with the specified block number. The block number is the number of logical blocks between the beginning of tape media or the prior file mark and the current logical position on the tape media. Block number gets modified on writes, reads, and forward or backward space over records (blocks). The block number also gets reset to zero when a file mark is crossed or another file mark is written that designates a new file. If the tape is back spaced to a prior file mark, the block number might be zeroed. A value of -1 indicates unknown position on the tape media or that a tape not loaded in the tape drive.
[-residual-count <integer>] - Residual Count of Last I/O Operation
Selects the tape drives with the specified residual count.
[-device-name-r <text>, ...] - Device Name for Rewind
Selects the tape drives with the specified device name for rewind.
[-device-name-nr <text>, ...] - Device Name for No Rewind
Selects the tape drives with the specified device name for no rewind.
[-device-name-ur <text>, ...] - Device Name for Unload Reload
Selects the tape drives with the specified device name for unload/reload.
[-resv-type {off|persistent|scsi}] - Reservation Type for device
Selects the tape drives with the specified type.

Examples

The following example displays information about all tape drives and media changers attached to the cluster:

cluster1::> storage tape show

Node: cluster1-01 
Device ID               Device Type     Description                     Status
----------------------  --------------  ------------------------------  --------
sw4:10.11               tape drive      HP LTO-3                        error



Node: cluster1-01
Device ID               Device Type     Description                     Status
----------------------  --------------  ------------------------------  --------
sw4:10.11L1             media changer   PX70-TL                         normal 

The following example displays detailed information about a tape drive named sw4:10.11

cluster1::> storage tape show -device-id sw4:10.11

Node: cluster1-01
Device ID               Device Type     Description                     Status
----------------------  --------------  ------------------------------  --------
sw4:10.11               tape drive      HP LTO-3                        error