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:

Node to which the tape drive/media changer is attached
Device ID of the tape drive/media changer
Description of the tape drive/media changer
Type of device: tape drive or media changer
Functional status of the tape drive/media changer

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.

[-aliases-name <text>,…] - Alias Names

Selects the tape drive/media changer with the specified alias name.

[-aliases-mapping <text>,…] - Alias Mappings

Selects the tape drive/media changer with the specified alias mapping.

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