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.
Give documentation feedback