IOQ

Read syntax diagramSkip visual syntax diagram
   .-IOQ(DASD)--------------.   
>>-+------------------------+----------------------------------><
   |      .-,-----------.   |   
   |      V             |   |   
   +-IOQ(---| Options |-+-)-+   
   '-NOIOQ------------------'   

Options

   .-NONMBR-----.  .-DASD---.  .-NOCHRDR-.  .-NOCOMM-.   
|--+------------+--+--------+--+---------+--+--------+---------->
   '-NMBR(nmbr)-'  '-NODASD-'  '-CHRDR---'  '-COMM---'   

   .-NOGRAPH-.  .-NOTAPE-.  .-NOUNITR-.   
>--+---------+--+--------+--+---------+-------------------------|
   '-GRAPH---'  '-TAPE---'  '-UNITR---'   

Specifies I/O queuing activity measurement for the devices in each logical control unit (LCU), where option can be any one of the following:
  • One or more LCU numbers:
           ({aaaa          })
    {NMBR} ({aaaa,bbbb:zzzz})/NONMBR
           ({aaaa,bbbb,... })

    NMBR requests specific device numbers, where aaaa, bbbb, and zzzz each represent hexadecimal device numbers. You can omit leading zeros. You can specify any combination of a single device number, in the format aaaa, a list of device numbers, in the format aaaa,bbbb, or a range of numbers in the format bbbb:zzzz, where bbbb is your first number and zzzz is your last number. You can not exceed 32 characters, including commas and colons. When you specify a range of numbers, use a colon as a separator to indicate that the report is to consist of all numbers from bbbb up to and including zzzz.

    NONMBR is the default; when specified, it cancels any existing lists of LCU numbers.

  • Any of the following classes:
    CHRDR/NOCHRDR
    Character reader
    COMM/NOCOMM
    Communications equipment
    DASD/NODASD
    Direct access storage
    GRAPH/NOGRAPH
    Graphics
    TAPE/NOTAPE
    Magnetic tape
    UNITR/NOUNITR
    Unit record

When you omit the IOQ option, the defaults are as underscored in the preceding list. If you specify IOQ, you must include an option. The option need include only the classes you want to either add to the default (DASD) or the specific LCU number you want data for. The definition of an LCU is model-dependent.

On all processors, an LCU is the set of devices attached to the same physical control unit (or group of control units that have one or more devices in common). Each device belongs to only one LCU, but the I/O processor (SAP), which is part of the channel subsystem, manages and schedules I/O work requests to the various devices within the LCU of the processor.

On all processors, you can request I/O queuing activity by specifying all LCUs within one or more classes, or, optionally, one or more specific LCUs within each class.

Note: When your system is running as a guest under VM, RMF™ cannot gather data for it. In this case, the I/O Queuing Activity report shows only the static configuration data.
Example:
  • To request I/O queuing activity for magnetic tape device LCUs 1130, 1133, 1134, 1135, and 1150 as well as all LCUs of the DASD and COMM classes, specify:
    IOQ(COMM,NMBR(1130,1133:1135,1150))

    LCUs of DASDs would be included by default, and the other device classes would be excluded by default.

  • To request I/O queuing activity for LCUs for magnetic tape devices and DASD, specify:
    IOQ(TAPE)
  • To limit the reporting to only some LCUs for direct access storage devices, you must specify NODASD and use the NMBR field to identify those LCUs you want to monitor.