Querying utilization

The IOPT_INF_... statements are used to query the percentage utilization of devices, channels, ports and paths by tasks with the I/O priorities HIGH, MEDIUM and LOW. The explicit and, if required, the implicit lock factors for tasks with the I/O priorities MEDIUM and LOW are also displayed.

The lock factor is the ratio of the duration of the IORM lock to the I/O duration.

Tasks with the I/O priority MEDIUM or LOW are explicitly locked for a channel (or a port, path or device) when the first threshold value for MEDIUM or LOW for channel utilization (or port, path or device utilization) is exceeded.

Tasks with the I/O priority MEDIUM or LOW are implicitly locked for a device when a channel, port or path to which the device is connected is explicitly locked.

Devices

IOPT_INF_DEV?                                                                                                                                       

IOPT_INF_DEV?mask

mask	Complete or masked specification of a mnemonic device name. The following specifications are possible:
	*	The utilization of all devices is listed.
	n*	The utilization of all devices whose names begin with n is listed.
	nm*	The utilization of all devices whose names begin with nm is listed.
	nml*	The utilization of all devices whose names begin with nml is listed.
	nmlo	The utilization of the device with the name nmlo is listed.

Channels

IOPT_INF_CHN?                                                                                                                                      

IOPT_INF_CHN?mask

mask	Specifies a channel. The following specifications are possible:
	*	The utilization of all channels is listed.
	nm*	The utilization of the channel nm is listed.

Paths

IOPT_INF_PTH?                                                                                                                                     

IOPT_INF_PTH?mask

mask	Specifies a path. The following specifications are possible:
	*	The utilization of all paths is listed.
	nmlo/pq	The utilization of the path from channel pq to controller nmlo is listed.

Ports

IOPT_INF_POR?                                                                                                                                      

IOPT_INF_POR?mask

mask	Specifies a port. The following specifications are possible:
	*	The utilization of all ports is listed.
	portname	The utilization of the port with the specified name is listed. The WWPN (World Wide Port Name – 16 characters) of the controller port can be specified as the port name.

Example

I/Os are active for the devices 3801 and 3803 on the 3800 controller and on channel 50. The FC port connected to the controller has the WWPN 5006048448586C01.

Querying the utilization on channel 50

IOPT_INF_CHN?50

Output:

    UNIT NAME     | HIG MED LOW | EXPLICIT DELAY | IMPLICIT DELAY 
                  |  %   %   %  |   MED     LOW  |   MED     LOW
------------------+-------------+----------------+---------------
50                |  24  19  13 |    0      0.01 |    0       0

Query for path 3800/50

IOPT_INF_PTH?3800/50

Output:

    UNIT NAME     | HIG MED LOW | EXPLICIT DELAY | IMPLICIT DELAY 
                  |  %   %   %  |   MED     LOW  |   MED     LOW
------------------+-------------+----------------+---------------
3800/50           |  24  19  13 |    0      0.01 |    0       0

Query for port 5006048448586C01

IOPT_INF_POR?5006048448586C01

Output:

    UNIT NAME     | HIG MED LOW | EXPLICIT DELAY | IMPLICIT DELAY 
                  |  %   %   %  |   MED     LOW  |   MED     LOW
------------------+-------------+----------------+---------------
5006048448586C01  |  24  19  13 |    0      0.01 |    0       0

 

Query for devices 3801 and 3803:

IOPT_INF_DEV?380*

Output:

    UNIT NAME     | HIG MED LOW | EXPLICIT DELAY | IMPLICIT DELAY 
                  |  %   %   %  |   MED     LOW  |   MED     LOW
------------------+-------------+----------------+---------------
 3800             |  0   0   0  |    0       0   |    0       0
 3801             |  70  0   11 |    0      5.81 |    0       0
 3802             |  0   0   0  |    0       0   |    0       0
 3803             |  0   60  29 |    0      1.62 |    0       0