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

#### MRIODPDS

Prolog
Control Block Contents
Cross Reference

#### MRIODPDS Prolog

     DSECT NAME - IODPDS
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODPDS
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6 - I/O Domain
                        Record 40 - Guest Disables a PCI Function
     DESCRIPTION -  This record indicates when a guest disables a PCI
                    function.
     NOTES:
       Anytime that a guest succesfully disables a PCI function, this
       record will be built to indicate that event occurring.

#### MRIODPDS Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   116+ IODPDS
       0   0  Character     0  IODPDS_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  IODPDS_RPCIPFID        Real PCI Function ID
      24  18  Unsigned      4  IODPDS_VPCIPFID        Virt PCI Function ID
      28  1C  Character     8  IODPDS_VMDUSER         User Name of Function Owner
      36  24  Unsigned      4  IODPDS_VPCIHNDG        PCI General Handle
      40  28  Bitstring     1  IODPDS_FLAGS           General Flags
              1... ....        IODPDS_DSNOSUCC         DISABLE not issued or it
                                                      failed
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      41  29  Character     1  IODPDS_FMBFMT          Determines the format of
                                                      the variable PCI function
                                                      data.
                                                      When:
                                                       0 = IODPDS_FORM_0
                                                       1 = IODPDS_FORM_1
                                                       2 = IODPDS_FORM_2
                                                       2 = IODPDS_FORM_3
      42  2A  Character     2  *                      Reserved and available for
                                                      IBM Use
      44  2C  Character     8  IODPDS_RPCIHPIN        Unsigned 64-bit integer
                                                      Cumulative count of host
                                                      pages currently pinned.
      52  34  Character     8  IODPDS_RPCIPCNT        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)
      60  3C  Character     8  IODPDS_VPCIRPCN        Count of guest RDMA mapping
                                                      requests
      68  44  Unsigned      4  IODPDS_FMBSMPCT        Cumulative sample count of
                                                      the number of times the
                                                      PCI-Function measurement
                                                      block has been updated. This
                                                      value may be wrapped.
      72  48  Character     8  IODPDS_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.
      80  50  Character     8  IODPDS_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).
      88  58  Character     8  IODPDS_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).
      96  60  Character     8  IODPDS_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).
     104  68  Character     8  IODPDS_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).
     112  70  Unsigned      2  IODPDS_VAROFSET        Offset within this record
                                                      where the PCI function
                                                      variable measurement data
                                                      begins.
     114  72  Unsigned      2  IODPDS_VARLEN          Length of the PCI function
                                                      variable measurement data.
     116  74  Character     0  *                      Additional fields may be
                                                      inserted before here. Use
                                                      offsets to locate any fields
                                                      after this point.
       0   0  Character     0  IODPDS_VAR_DATA        Start of the PCI variable
                                                      function data. To find the
                                                      start of this data use
                                                      IODPDS_VAROFSET. To find the
                                                      length of this data use
                                                      IODPDS_VARLEN.
    Mapping of PCI function variable measurement data

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    16  IODPDS_FORM_0          Describes the fields in the
                                                      Format 0 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPDS_FMBDRCNT        Unsigned 64-bit integer
                                                      Number of bytes transferred
                                                      to the PCI function from main
                                                      memory 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).
       8   8  Character     8  IODPDS_FMBDWCNT        Unsigned 64-bit integer
                                                      Number of bytes transferred
                                                      from the PCI function to main
                                                      memory 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).

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    32  IODPDS_FORM_1          Describes the fields in the
                                                      Format 1 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPDS_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  IODPDS_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  IODPDS_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  IODPDS_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  IODPDS_FORM_2          Describes the fields in the
                                                      Format 2 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPDS_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  IODPDS_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  IODPDS_FORM_3          Describes the fields in the
                                                      Format 3 PCI function
                                                      variable measurement data.
       0   0  Character     8  IODPDS_FMBTRCNT        Unsigned 64-bit integer
                                                      Number of bytes transmitted on
                                                      the ISM function during the
                                                      update interval. This value
                                                      may be wrapped. Rest to zero
                                                      when record MRIODPEN is cut
                                                      (measurments are enabled)
                                                      and is no longer valid/useful
                                                      when record MRIODPDS is cut.
                                                      (measurments are disabled)
       *   *  Character     0  IODPDS_END

#### MRIODPDS Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODPDS                     0    116+
    IODPDS_DSNOSUCC           28           80
    IODPDS_END                 *      0
    IODPDS_FLAGS              28      1
    IODPDS_FMBCWUCT            0      8
    IODPDS_FMBDRCNT            0      8
    IODPDS_FMBDWCNT            8      8
    IODPDS_FMBMWUCT            8      8
    IODPDS_FMBFMT             29      1
    IODPDS_FMBLGCNT           50      8
    IODPDS_FMBRBCNT            0      8
    IODPDS_FMBRPCNT           68      8
    IODPDS_FMBRPKNT            8      8
    IODPDS_FMBSBCNT           60      8
    IODPDS_FMBSGCNT           58      8
    IODPDS_FMBSMPCT           44      4
    IODPDS_FMBTBCNT           10      8
    IODPDS_FMBTOD             48      8
    IODPDS_FMBTPCNT           18      8
    IODPDS_FMBTRCNT            0      8
    IODPDS_FORM_0              *     16
    IODPDS_FORM_1              *     32
    IODPDS_FORM_2              *     16
    IODPDS_FORM_3              *      8
    IODPDS_MRHDR               0      0
    IODPDS_RPCIHPIN           2C      8
    IODPDS_RPCIPCNT           34      8
    IODPDS_RPCIPFID           14      4
    IODPDS_VARLEN             72      2
    IODPDS_VAROFSET           70      2
    IODPDS_VAR_DATA            *      *
    IODPDS_VMDUSER            1C      8
    IODPDS_VPCIHNDG           24      4
    IODPDS_VPCIPFID           18      4
    IODPDS_VPCIRPCN           3C      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:17:34.

    Copyright IBM Corporation, 1990, 2020