Skip to main content

storage tape library path show

Contributors
Suggest changes

Display a list of Tape Libraries on the given path

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

Description

This command displays path information for a tape library and has the following parameters by default:

  • Node name

  • Initiator port

  • Target port

  • TPGN (Target Port Group Number)

  • Port speeds

  • Path I/O in Kbytes/sec

  • IOPs

Parameters

{ [-fields <fieldname>,…​]

fields used to be used in this display

| [-detail ]

Using this option displays the following:

  • Target IOPs

  • Target LUNs

  • Path IOPs

  • Path errors

  • Path quality

  • Path LUNs

  • Initiator IOPs

  • Initiator LUNs

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-node {<nodename>|local}] - Controller name

The name of the clustered node for which information is being displayed.

[-array-name <array name>] - Library Name

Name of the storage tape library that is connected to the cluster.

[-target-wwpn <text>] - Target Port

Target World Wide Port Name. Port on the storage tape library that is being used.

[-initiator <text>] - Initiator Port

Initiator port that the clustered node uses.

[-initiator-side-switch-port <text>] - Initiator Side Switch Port

Switch port connected to the clustered node.

[-tpgn <integer>] - Target Port Group Number

TPGN refers to the target port group to which the target port belongs. A target port group is a set of target ports which share the same LUN access characteristics and failover behaviors.

[-port-speed <text>] - Port Speed

Port Speed of the specified port.

[-path-io-kbps <integer>] - Kbytes of I/O per second on Path(Rolling Average)

Rolling average of Kbytes of I/O per second on the library path.

[-path-iops <integer>] - Number of I/O per second on Path(Rolling Average)

Rolling average of I/O per second on the library path.

[-initiator-io-kbps <integer>] - Kbytes of I/O per second on Initiator(Rolling Average)

Rolling average of Kbytes of I/O per second on the initiator port.

[-initiator-iops <integer>] - Number of I/O per second on Initiator(Rolling Average)

>Rolling average of I/O per second on the initiator port.

[-target-io-kbps <integer>] - Kbytes of I/O per second to Target(Rolling Average)

Rolling average of Kbytes of I/O per second on the target port.

[-target-iops <integer>] - Number of I/O per second to Target(Rolling Average)

Rolling average of I/O per second on the target port.

[-target-side-switch-port <text>] - Target Side Switch Port

Switch port connected to the tape library.

[-path-link-errors <integer>] - Link Error count on path

Fibre Channel link error count.

[-path-quality <integer>] - Percentage of weighted error threshold

A number representing the threshold of errors that is allowed on the path. Path quality is a weighted error value. When the error weight of a path exceeds the threshold, I/O is routed to a different path.

[-path-lun-in-use-count <integer>] - Number of LUNs in the in-use state on this path

Number of LUNs on this path.

[-initiator-lun-in-use-count <integer>] - Number of LUNs in the in-use state on this initiator

Number of LUNs on this initiator.

[-target-lun-in-use-count <integer>] - Number of LUNs in the in-use state on this target

Number of LUNs on this target.

Examples

The following example displays the path information for a storage tape library

cluster1::> storage tape library path show
Node                   Initiator  Target Port              TPGN    Speed        (KB/s)          IOPs
---------------------  ---------  -----------------------  ------  -------  ------------  ------------
cluster1-01
                       3d         50050763124b4d6f             61   4 Gb/S             0             0
cluster1-01
                       0b         510a09800000412d             35   4 Gb/S             0             0
cluster1-01
                       0b         510a09820000412d              1   4 Gb/S             0             0
3 entries were displayed.