Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRIODMOF

Prolog
Control Block Contents
Cross Reference

#### MRIODMOF Prolog

####

####

     DSECT NAME - IODMOF
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODMOF
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6 - I/O Domain
                        Record 14- Set Subchannel Measurement Off
     DESCRIPTION - Indicates the SET SCMEASURE OFF command turned off
                   subchannel measurements for the device.

    MRIODMOF Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   68  IODMOF
      0   0  Character    0  IODMOF_MRHDR        Record header. See MRRECHDR for
                                                 details.
      0   0  Character   20  MRHDR
      0   0  Unsigned     2  MRHDRLEN            record length in bytes
      2   2  Unsigned     2  MRHDRZER            field of zeros
      4   4  Unsigned     1  MRHDRDM             domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC             record identifier
      8   8  Character    8  MRHDRTOD            Time at which this record was
                                                 built. In time-of-day (TOD) clock
                                                 format. See IBM System 370 XA
                                                 Principle of Operation for
                                                 explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END           End of header
     20  14  Unsigned     4  IODMOF_RDEVSID      Host subchannel I.D. number
                                                 defined at initialization
     24  18  Unsigned     2  IODMOF_RDEVDEV      Device number
     26  1A  Unsigned     2  *                   Reserved and available for IBM
                                                 use
     28  1C  Unsigned     2  IODMOF_SCMSSCH      Cumulative count of SSCHs and
                                                 RSCHs for this device. This value
                                                 may be wrapped when format-1
                                                 measurement blocks are being used
                                                 (MTRSYS_CALFLG2 = x'80').
     30  1E  Unsigned     2  IODMOF_SCMCOUNT     Cumulative sample count.
                                                 Incremented whenever any
                                                 measurement fields are updated.
                                                 This value may be wrapped when
                                                 format-1 measurement blocks are
                                                 being used (MTRSYS_CALFLG2 =
                                                 x'80').
     32  20  Unsigned     4  IODMOF_SCMCNTIM     The time the device is connected
                                                 to the channel. This is the sum of
                                                 time intervals measured whenever
                                                 device is logically connected to
                                                 the channel path for purposes of
                                                 transferring information between
                                                 it and the channel subsystem.
     36  24  Unsigned     4  IODMOF_SCMFPTIM     The accumulated SSCH and RSCH
                                                 function pending time, the time
                                                 interval between acceptance of the
                                                 start function (or resume function
                                                 if the subchannel is in the
                                                 suspend state) at the subchannel
                                                 and acceptance of the first
                                                 command associated with the
                                                 initiation of channel-program
                                                 execution at the device.
     40  28  Unsigned     4  IODMOF_SCMDDTIM     Device disconnect time. This is
                                                 the sum of the time intervals
                                                 measured whenever the device is
                                                 logically disconnected from the
                                                 channel subsystem while the
                                                 subchannel is active
     44  2C  Unsigned     4  IODMOF_SCMCQTIM     Control unit queueing time. The
                                                 sum of the time intervals measured
                                                 by the control unit whenever the
                                                 device is logically disconnected
                                                 from the channel subsystem during
                                                 an I/O operation while the device
                                                 is busy with an operation from a
                                                 different system.
     48  30  Unsigned     4  IODMOF_SCMDATIM     Device-active-only-time. The sum
                                                 of the time intervals when the
                                                 subchannel is device-active but
                                                 not subchannel-active at the end
                                                 of an I/O operation or chain of
                                                 I/O operations initiated by START
                                                 SUBCHANNEL.
     52  34  Unsigned     4  IODMOF_SCMDBTIM     Device-Busy Time. The sum of the
                                                 time intervals when the subchannel
                                                 is busy during an attempt to
                                                 initiate a start function or
                                                 resume function at the subchannel.
     56  38  Unsigned     4  IODMOF_SCMIRTIM     Initial-command-response time.
                                                 The initial-command-response time
                                                 for a start or resume function is
                                                 the time interval beginning from
                                                 when the first command of the
                                                 channel program is sent to the
                                                 device until the device indicates
                                                 it has accepted the command.
     60  3C  Unsigned     4  IODMOF_SCGSSCH      Fullword cumulative count of
                                                 SSCHs and RSCHs for this device.
                                                 Available when format-1
                                                 measurement blocks are being used
                                                 (MTRSYS_CALFLG2 = x'80').
     64  40  Unsigned     4  IODMOF_SCGCOUNT     Fullword cumulative sample count
                                                 incremented whenever any
                                                 measurement fields are updated.
                                                 Available when format-1
                                                 measurement blocks are being used
                                                 (MTRSYS_CALFLG2 = x'80').
     68  44  Character    0  IODMOF_END

    MRIODMOF Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODMOF                  0     68
    IODMOF_END             44      0
    IODMOF_MRHDR            0      0
    IODMOF_RDEVDEV         18      2
    IODMOF_RDEVSID         14      4
    IODMOF_SCGCOUNT        40      4
    IODMOF_SCGSSCH         3C      4
    IODMOF_SCMCNTIM        20      4
    IODMOF_SCMCOUNT        1E      2
    IODMOF_SCMCQTIM        2C      4
    IODMOF_SCMDATIM        30      4
    IODMOF_SCMDBTIM        34      4
    IODMOF_SCMDDTIM        28      4
    IODMOF_SCMFPTIM        24      4
    IODMOF_SCMIRTIM        38      4
    IODMOF_SCMSSCH         1C      2
    MRHDR                   0     20
    MRHDR_END              14      0
    MRHDRDM                 4      1
    MRHDRLEN                0      2
    MRHDRRC                 6      2
    MRHDRTOD                8      8
    MRHDRZER                2      2

    This information is
    based on z/VM V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003