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

#### MRIODPAC

Prolog
Control Block Contents
Cross Reference

#### MRIODPAC Prolog

     DSECT NAME - IODPAC
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODPAC
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 6 - I/O Domain
                        Record 39 - PCI Activities
     DESCRIPTION - Indicates activity on a PCI function
     NOTES:
      This record is emitted for PCI functions which have been attached
      to a guest and enabled by the guest.  Measurements can only be
      gathered for an enabled function.

#### MRIODPAC Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   112+ IODPAC
       0   0  Character     0  IODPAC_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  Unsigned      4  IODPAC_RPCIPFID        Real PCI function ID
      24  18  Unsigned      4  IODPAC_VPCIPFID        Virtual PCI function ID
      28  1C  Character     8  IODPAC_VMDUSER         UserID to whom function
                                                      attached
      36  24  Bitstring     1  IODPAC_RPCICFLG        PCI State Flag
              1... ....        IODPAC_RPCICONF         PCI function is configured
              .1.. ....        IODPAC_RPCIPERM         PCI function is in
                                                       Permanent Error state
              ..1. ....        IODPAC_RPCIERR          PCI function is in Error
                                                       state
              ...1 ....        IODPAC_RPCIBLOK         PCI function blocked
              .... 1...        *
              .... .1..        IODPAC_RPCIUNEN         PCI function is
                                                       unexpectedly in the enabled
                                                       state
              .... ..1.        IODPAC_RPCIINIT         PCI function initialized
              .... ...1        IODPAC_RPCIDEAD         Indicates RPCI has been
                                                       scheduled for deletion. The
                                                       RPCI has been removed from
                                                       the ordered list and all hash
                                                       tables. This bit should NEVER
                                                       be ON for any live RPCI
      37  25  Bitstring     1  IODPAC_CALFLAG         PCI function state
              1... ....        IODPAC_CALENABL         PCI function is enabled
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      38  26  Bitstring     1  IODPAC_VPCIFC          Function Controls
              1... ....        IODPAC_VPCIEAS          DMA registered
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      39  27  Character     1  IODPAC_FMBFMT          Determines the format of the
                                                      variable PCI function data
                                                      When:
                                                       0 = IODPAC_FORM_0
                                                       1 = IODPAC_FORM_1
                                                       2 = IODPAC_FORM_2
                                                       3 = IODPAC_FORM_3
      40  28  Character     8  IODPAC_RPCIHPIN        Unsigned 64-bit integer
                                                      Cardinal count of host
                                                      pages currently pinned.
      48  30  Character     8  IODPAC_RPCIPCNT        Cardinal count of shadow
                                                      tables in use since
                                                      last DMA register.
                                                      Valid when DMA registered.
                                                      (MTRPCI_VPCIEAS bit on).
                                                      Reset to zero when operation
                                                      unreg is successful(MRIODPMD
                                                      is cut with IODPMD_DMAUNREG)
      56  38  Character     8  IODPAC_VPCIRPCN        Count of guest RDMA mapping
                                                      requests
      64  40  Unsigned      4  IODPAC_FMBSMPCT        Cumulative sample count of
                                                      the number of times the
                                                      PCI-Function measurement
                                                      block has been updated. This
                                                      field wraps to zero with no
                                                      notification when counter
                                                      overflow occurs.
      68  44  Character     8  IODPAC_FMBTOD          Time of last update where
                                                      the resolution is identical
                                                      to that of bits 0-62 of the
                                                      TOD clock and is not
                                                      necessarily synchronized with
                                                      the TOD clock. Reset to zero
                                                      when record MRIODPEN is cut
                                                      (measurements ar enabled) and
                                                      are no longer valid /useful
                                                      when record MRIODPDS is cut
                                                      (measurements are disabled).
                                                      Can be used to calculate time
                                                      elapsed (delta) since last
                                                      measurements gatherd.
      76  4C  Character     8  IODPAC_FMBLGCNT        Unsigned 64-bit integer
                                                      Count of successful reads
                                                      from the PCI function memory
                                                      or configuration space during
                                                      the update interval. This
                                                      value may be wrapped. Reset
                                                      to zero when record MRIODPEN
                                                      is cut (measurements are
                                                      enabled) and are no longer
                                                      valid/useful when record
                                                      MRIODPDS is cut (measurements
                                                      are disabled).
      84  54  Character     8  IODPAC_FMBSGCNT        Unsigned 64-bit integer
                                                      Count of successful writes to
                                                      the PCI function memory or
                                                      configuration space during
                                                      the update interval. This
                                                      value may be wrapped. Reset
                                                      to zero when record MRIODPEN
                                                      is cut (measurements are
                                                      enabled) and are no longer
                                                      valid/useful when record
                                                      MRIODPDS is cut (
                                                      measurements are disabled).
      92  5C  Character     8  IODPAC_FMBSBCNT        Unsigned 64-bit integer
                                                      Count of successful block
                                                      writes to the PCI function
                                                      memory or configuration space
                                                      during the update interval.
                                                      This value may be wrapped.
                                                      Reset to zero when record
                                                      MRIODPEN is cut (measurements
                                                      are enabled) and are no
                                                      longer valid/useful when
                                                      record MRIODPDS is cut (
                                                      measurements are disabled).
     100  64  Character     8  IODPAC_FMBRPCNT        Unsigned 64-bit integer
                                                      Count of successful
                                                      address-translation refreshes
                                                      during the update interval.
                                                      This value may be wrapped.
                                                      Reset to zero when record
                                                      MRIODPEN is cut (measurements
                                                      are enabled) and are no
                                                      longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).
     108  6C  Unsigned      2  IODPAC_VAROFSET        Offset within this record
                                                      where the PCI function
                                                      variable measurement data
                                                      begins.
     110  6E  Unsigned      2  IODPAC_VARLEN          Length of the PCI function
                                                      variable measurement data.
     112  70  Character     0  *                      Additional fields may be
                                                      inserted before here. Use
                                                      offsets to locate any fields
                                                      after this point.
       0   0  Character     0  IODPAC_VAR_DATA        Start of the PCI variable
                                                      function data. To find the
                                                      start of this data use
                                                      IODPAC_VAROFSET. To find the
                                                      length of this data use
                                                      IODPAC_VARLEN.
    Mapping of PCI function variable measurement data

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    16  IODPAC_FORM_0          Describes the fields in the
                                                      Format 0 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPAC_FMBDRCNT        Unsigned 64-bit integer
                                                      Number of bytes read from
                                                      main memory by the PCI function
                                                      during the update
                                                      interval. This value is always
                                                      zero.
       8   8  Character     8  IODPAC_FMBDWCNT        Unsigned 64-bit integer
                                                      Number of bytes written to
                                                      main memory by the PCI function
                                                      during the update
                                                      interval. This value is always
                                                      zero.

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    32  IODPAC_FORM_1          Describes the fields in the
                                                      Format 1 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPAC_FMBRBCNT        Unsigned 64-bit integer
                                                      Number of bytes received on the
                                                      external ethernet interface
                                                      during the update interval. This
                                                      value may be wrapped. Reset to
                                                      zero when record MRIODPEN is cut
                                                      (measurements are enabled) and
                                                      is no longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).
       8   8  Character     8  IODPAC_FMBRPKNT        Unsigned 64-bit integer
                                                      Number of packets received on
                                                      the external ethernet interface
                                                      during the update interval. This
                                                      value may be wrapped. Reset to
                                                      zero when record MRIODPEN is cut
                                                      (measurements are enabled) and
                                                      is no longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).
      16  10  Character     8  IODPAC_FMBTBCNT        Unsigned 64-bit integer
                                                      Number of bytes transmitted on
                                                      the external ethernet interface
                                                      during the update interval. This
                                                      value may be wrapped. Reset to
                                                      zero when record MRIODPEN is cut
                                                      (measurements are enabled) and
                                                      is no longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).
      24  18  Character     8  IODPAC_FMBTPCNT        Unsigned 64-bit integer
                                                      Number of packets transmitted on
                                                      the external ethernet interface
                                                      during the update interval. This
                                                      value may be wrapped. Reset to
                                                      zero when record MRIODPEN is cut
                                                      (measurements are enabled) and
                                                      is no longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    16  IODPAC_FORM_2          Describes the fields in the
                                                      Format 2 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPAC_FMBCWUCT        Unsigned 64-bit integer
                                                      Number of work units processed
                                                      by the PCI function during the
                                                      update interval.  This value
                                                      may be wrapped.  Reset to zero
                                                      when record MRIODPEN is cut
                                                      (measurements are enabled) and
                                                      is no longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).
       8   8  Character     8  IODPAC_FMBMWUCT        Unsigned 64-bit integer
                                                      The maximum number of work units
                                                      that the PCI function is capable
                                                      of processing per second. This
                                                      value is static. Reset to zero
                                                      when record MRIODPEN is cut
                                                      (measurements are enabled) and
                                                      is no longer valid/useful when
                                                      record MRIODPDS is cut
                                                      (measurements are disabled).

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure     8  IODPAC_FORM_3          Describes the fields in the
                                                      Format 3 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPAC_FMBTRCNT        Unsigned 64-bit integer
                                                      Number of bytes transmitted over
                                                      the ISM function during the
                                                      update interval. This value
                                                      may be wrapped. Reset to zero
                                                      when the MRIODPEN is cut
                                                      (measurements are enabled)
                                                      and is no longer valid/useful
                                                      when record MRIODPDS is cut
                                                      (measurements are disabled)

#### MRIODPAC Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODPAC                     0    112+
    IODPAC_CALENABL           25           80
    IODPAC_CALFLAG            25      1
    IODPAC_END                 *      0
    IODPAC_FMBCWUCT            0      8
    IODPAC_FMBDRCNT            0      8
    IODPAC_FMBDWCNT            8      8
    IODPAC_FMBFMT             27      1
    IODPAC_FMBLGCNT           4C      8
    IODPAC_FMBMWUCT            8      8
    IODPAC_FMBRBCNT            0      8
    IODPAC_FMBRBCNT            0      8
    IODPAC_FMBRPCNT           64      8
    IODPAC_FMBRPKNT            8      8
    IODPAC_FMBSBCNT           5C      8
    IODPAC_FMBSGCNT           54      8
    IODPAC_FMBSMPCT           40      4
    IODPAC_FMBTBCNT           10      8
    IODPAC_FMBTOD             44      8
    IODPAC_FMBTPCNT           18      8
    IODPAC_FMBTRCNT            0      8
    IODPAC_FORM_0              *     16
    IODPAC_FORM_1              *     32
    IODPAC_FORM_2              *     16
    IODPAC_FORM_3              *      8
    IODPAC_MRHDR               0      0
    IODPAC_RPCIBLOK           24           10
    IODPAC_RPCICFLG           24      1
    IODPAC_RPCICONF           24           80
    IODPAC_RPCIDEAD           24           01
    IODPAC_RPCIERR            24           20
    IODPAC_RPCIHPIN           28      8
    IODPAC_RPCIINIT           24           02
    IODPAC_RPCIPCNT           30      8
    IODPAC_RPCIPERM           24           40
    IODPAC_RPCIPFID           14      4
    IODPAC_RPCIUNEN           24           04
    IODPAC_VARLEN             6E      2
    IODPAC_VAROFSET           6C      2
    IODPAC_VAR_DATA            *      *
    IODPAC_VMDUSER            1C      8
    IODPAC_VPCIEAS            26           80
    IODPAC_VPCIFC             26      1
    IODPAC_VPCIPFID           18      4
    IODPAC_VPCIRPCN           38      8
    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 09 August 2020 at 16:15:34.

    Copyright IBM Corporation, 1990, 2020