Skip to main content

storage tape library path show

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.