Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Monitor for CMF 6.3.

IOQ (Extractor control statements)

The IOQ control statement causes the Extractor to collect I/O configuration and activity data.

IOQ
[,LCUS={ACTVONLY|ALL}]
[,CLASS={DASD|TAPE|COMM|GRAPH|UNITR|CHRDR}]...)]
[,HPVHWM={YES|NO}]

Statistics are gathered for I/O processors (IOP) and Logical Control Units (LCU) and written to SMF type 78-3 records. These records are used by the Analyzer to produce the I/O Queuing Activity Report.

Note

When MVS runs under VM, do not specify the IOQ control statement. VM does not allow configuration data to be read, so the IOQ sampler does not function.

Monitoring modes

One IOQ statement can be specified for each monitoring mode, continuous (CPM) or intermittent (IPM).

Sampler and record types

The IOQ statement controls the IOQS sampler, which produces SMF type 78-3 records.

Analyzer statements and reports

CMFSUM

IOQ

CMF Summary Report

I/O Queuing Activity Report

Other BMC Software products

The IOQ control statement is used by the CMF MONITOR Extractor only.

Parameters

The parameters for the IOQ control statement are:

LCUS=

specifies whether the SMF 78-3 records should contain only LCUs that have activity during a recording interval

  • ACTVONLY

    specifies that the SMF 78-3 records contain only LCUs that have had activity during a recording interval

    This value is the default.

  • ALL

    specifies that the SMF 78-3 records contain all LCUs, whether or not they have had activity during a recording interval

CLASS=

specifies the classes of devices, which can be the following classes:

  • DASD—direct access storage devices; this is the default
  • TAPEmagnetic tape devices
  • COMM—communications equipment
  • GRAPH—graphics devices
  • UNITR—unit record devices
  • CHRDR—character reader devices

HPVHWM=

specifies whether CMF MONITOR collects data for specific SMF fields that contain the high-water marks for HyperPAV LCU

  • YES

    CMF MONITOR collects data for the following SMF fields that contain the high-water marks for HyperPAV LCU:

    • R783HAIU
    • R783HCAD
    • R783HIOQ

    R783HAIU is displayed in the HyperPAV MAX USED column of the I/O Queuing Activity report.

    This value is the default.

  • NO

    CMF MONITOR does not collect data for the specified SMF fields

This parameter is applicable only for CPM mode and is ignored if specified for the IPM mode. CMF MONITOR does not collect data for the specified SMF fields for SMF 78-3 IOQ records that are produced by the IPM mode.

The MVS collection of high-water marks supports only one monitoring application, which is an MVS design restriction. If you currently have both CMF MONITOR and RMF that are producing SMF 78-3 IOQ records, the high-water marks are incorrect in both CMF and RMF records unless you implement one of the following options:

  • If you want CMF MONITOR to collect high-water marks, modify RMF options to not write SMF 78-3 IOQ records and, for CMF MONITOR, specify HPVHWM=YES or simply omit this parameter.
  • If you want RMF to collect high-water marks, specify HPVHWM=NO to cause CMF MONITOR to not collect the high-water mark data. The high-water marks in RMF records can be collected, and those in CMF records are zero.

Only a CMF MONITOR PAS that is started with CXEN=Y can collect the high-water marks in the SMF 78-3 IOQ records that are produced by the CPM mode. CXEN is a parameter on the PAS PROC; the default is Y.

Examples

Example
IOQ  CLASS=(DASD,TAPE,COMM,GRAPH,UNITR,CHRDR)

This example invokes I/O queuing sampling for all device classes.

Example
IOQ class="DASD"

This example invokes I/O queuing sampling for DASD devices only, which is the default if no CLASS parameter is specified.

Related topics

IOQ-Report-control-statements

I-O-Queuing-Activity-Report-Analyzer-report

CMFSUM

CMF-Summary-Report

Extractor-control-statements


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*