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

#### MRIODCHD

Prolog
Control Block Contents
Cross Reference

#### MRIODCHD Prolog

     DSECT NAME - IODCHD
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODCHD
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6  - I/O Domain
                        Record 48 - CHPID is no longer in use for
                                    EDEVICE activity
     DESCRIPTION - Indicates that a CHPID is no longer in use by
                   any EDEV(s)
     NOTES - Note that the timestamp and data for the CHPID activity
             record might be identical to that in the previous
             record in cases where there was a delay in the capturing
             of the data. In this case there is effectively no interval
             reported on between this pair of records and a later record
             with a different timestamp must be used to compute usage
             for the CHPID.

#### MRIODCHD Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   148  IODCHD                 Start of monitor record
       0   0  Character     0  IODCHD_MRHDR           Record header. See MRRECHDR
                                                      for details.
       0   0  Character    20  MRHDR
       0   0  Unsigned      2  MRHDRLEN
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      20  14  Character     8  IODCHD_CHAUTIME        Timestamp (TOD) of the most
                                                      recent data collection.
      28  1C  Unsigned      4  IODCHD_CHANMPTH        Number of path(s) using
                                                      this CHPID
      32  20  Unsigned      1  IODCHD_CHACHPID        CHPID number
      33  21  Unsigned      3  *                      Reserved
      36  24  Unsigned      4  IODCHD_CHAPRTYP        The type of the local port
                                                      X'00000001'- port type unknown
                                                      X'00000003'- port not accessible
                                                      X'00000005'- N_Port attached to a fabric
                                                      X'00000021'- port is point-to-point
                                                      attached to a device
      40  28  Character     8  IODCHD_CHAINPRQ        The number of requests
                                                      causing read operations on
                                                      this chpid since activation -
                                                      cumulative (eight-byte
                                                      unsigned binary)
      48  30  Character     8  IODCHD_CHAOUTRQ        The number of requests
                                                      causing write operations on
                                                      this chpid since activation -
                                                      cumulative (eight-byte
                                                      unsigned binary)
      56  38  Character     8  IODCHD_CHAINPMB        The amount of data
                                                      in megabytes
                                                      that has
                                                      been received for this chpid
                                                      since activation - cumulative
                                                      (eight-byte unsigned binary)
      64  40  Character     8  IODCHD_CHAOUTMB        The amount of data
                                                      in megabytes
                                                      that has
                                                      been sent for this chpid
                                                      since activation - cumulative
                                                      (eight-byte unsigned binary)
      72  48  Character     8  IODCHD_CHARESET        Seconds since last channel
                                                      reset - cumulative
                                                      (eight-byte unsigned binary)
      80  50  Unsigned      4  IODCHD_CHASCALL        The overall number of calls
                                                      to gather data - cumulative
      84  54  Character     8  IODCHD_CHASTIME        Cumulative time
                                                      to gather data,
                                                      in time-of-day (TOD) format.
      92  5C  Unsigned      4  IODCHD_CHASERRS        Number of data calls that
                                                      failed with error -
                                                      cumulative
    IODCHD_CHASMPLS is a count of the number of samples of data that have
    been taken for this record since Monitor began. It is used by the
    reduction program in relation to the cumulative values below.

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

      96  60  Unsigned      4  IODCHD_CHASMPLS        Cumulative count of samples
     100  64  Unsigned      1  IODCHD_CHAPROCU        Overall utilization of the
                                                      processor in the chpid,
                                                      percentage - cardinal
     101  65  Unsigned      3  *                      Reserved
     104  68  Unsigned      4  IODCHD_CHAPROCS        Cumulative sum of processor
                                                      utilization
     108  6C  Character     8  IODCHD_CHAPROCQ        Sum of squares of processor
                                                      utilization
     116  74  Unsigned      1  IODCHD_CHABUSUT        Overall utilization of the
                                                      bus in the chpid, percentage
                                                      - cardinal
     117  75  Unsigned      3  *                      Reserved
     120  78  Unsigned      4  IODCHD_CHABUSSM        Cumulative sum of bus
                                                      utilization
     124  7C  Character     8  IODCHD_CHABUSSQ        Sum of squares of bus
                                                      utilization
     132  84  Unsigned      1  IODCHD_CHAADAPU        Overall utilization of the
                                                      chpid's integrated Fibre
                                                      Channel adapter, percentage -
                                                      cardinal
     133  85  Unsigned      3  *                      Reserved
     136  88  Unsigned      4  IODCHD_CHAADAPS        Cumulative sum of adapter
                                                      utilization
     140  8C  Character     8  IODCHD_CHAADAPQ        Sum of squares of adapter
                                                      utilization
     148  94  Character     0  IODCHD_END

#### MRIODCHD Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODCHD                     0    148
    IODCHD_CHAADAPQ           8C      8
    IODCHD_CHAADAPS           88      4
    IODCHD_CHAADAPU           84      1
    IODCHD_CHABUSSM           78      4
    IODCHD_CHABUSSQ           7C      8
    IODCHD_CHABUSUT           74      1
    IODCHD_CHACHPID           20      1
    IODCHD_CHAINPMB           38      8
    IODCHD_CHAINPRQ           28      8
    IODCHD_CHANMPTH           1C      4
    IODCHD_CHAOUTMB           40      8
    IODCHD_CHAOUTRQ           30      8
    IODCHD_CHAPROCQ           6C      8
    IODCHD_CHAPROCS           68      4
    IODCHD_CHAPROCU           64      1
    IODCHD_CHAPRTYP           24      4
    IODCHD_CHARESET           48      8
    IODCHD_CHASCALL           50      4
    IODCHD_CHASERRS           5C      4
    IODCHD_CHASMPLS           60      4
    IODCHD_CHASTIME           54      8
    IODCHD_CHAUTIME           14      8
    IODCHD_END                94      0
    IODCHD_MRHDR               0      0
    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 V7R2.0.

    Last updated on 05 August 2020 at 20:40:21.

    Copyright IBM Corporation, 1990, 2020