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
                                                   3 = 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. 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). * * 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_FMBTPCNT           18      8
IODPDS_FMBTRCNT            0      8
IODPDS_FMBTOD             48      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 V6R3.0.

Last updated on 21 Feb 2016 at 16:20:00.
Copyright IBM Corporation, 2016