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   Bitstring     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
                                                  80 = IODPAC_FORM_80
          1... ....        IODPAC_FMBFMT_EXT      Extended format
          .111 1111        IODPAC_FMT             Format number
  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)
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 160 IODPAC_FORM_80 Describes the fields in the extended format 0 PCI function variable measurement data. 0 0 Character 16 IODPAC_LSHDURD Cumulative number of 512- byte data units read from the device, in thousands rounded up 16 10 Character 16 IODPAC_LSHDUWR Cumulative number of 512- byte data units written to the device, in thousands rounded up 32 20 Character 16 IODPAC_LSHHRDCM Cumulative number of read commands completed. 48 30 Character 16 IODPAC_LSHHWRCM Cumulative number of write commands completed. 64 40 Character 16 IODPAC_LSHBUSTM Cumulative time the device has been busy with I/O commands, in minutes. 80 50 Character 16 IODPAC_LSHPWRCY Unsigned 128-bit integer Cumulative number of power cycles 96 60 Character 16 IODPAC_LSHPWRON Unsigned 128-bit integer Cumulative number of hours powered on 112 70 Character 16 IODPAC_LSHNDIER Unsigned 128-bit integer Cumulative number of unrecoverable media and data integrity errors 128 80 Character 16 IODPAC_LSHERRCT Unsigned 128-bit integer Cumulative number of error information log entries 144 90 Character 4 IODPAC_LSHWCTTM Unsigned 32-bit integer Cumulative time the Composite Temperature has been greater than or equal to the Warning Composite Temperature Threshold and less than or equal to the Critical Composite Temperature Threshold, in minutes 148 94 Character 4 IODPAC_LSHCCTTM Unsigned 32-bit integer Cumulative time the Composite Temperature has been greater than or equal to the Critical Composite Temperature Threshold, in minutes 152 98 Bitstring 1 IODPAC_LSHCRITW Critical warnings 1... .... IODPAC_LSHCRTAS Available spare capacity below threshold .1.. .... IODPAC_LSHCRTTM Temperature above high threshold or below low threshold ..1. .... IODPAC_LSHCRTME Significant media-related errors or internal errors encountered ...1 .... IODPAC_LSHCRTRO Media placed in read-only status .... 1... IODPAC_LSHCRTBU Volatile memory backup device failed .... .1.. * .... ..1. * .... ...1 * 153 99 Character 1 IODPAC_LSHASPAR Unsigned 8-bit integer Percentage of remaining spare capacity available, between 0 and 100 154 9A Character 1 IODPAC_LSHPCTUS Unsigned 8-bit integer Vendor-specific estimate of percentage of subsystem life used; may exceed 100 155 9B Character 1 * 156 9C Character 2 IODPAC_LSHCTEMP Unsigned 16-bit integer Composite temperature in degrees Kelvin 158 9E Character 2 *

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_FORM_80             *    160
IODPAC_LSHASPAR           99      1
IODPAC_LSHBUSTM           40     16
IODPAC_LSHCCTTM           94      4
IODPAC_LSHCRITW           98      1
IODPAC_LSHCRTAS           98           80
IODPAC_LSHCRTBU           98           08
IODPAC_LSHCRTME           98           20
IODPAC_LSHCRTRD           98           10
IODPAC_LSHCRTTM           98           40
IODPAC_LSHCTEMP           9C      2
IODPAC_LSHDURD             0     16
IODPAC_LSHDUWR            10     16
IODPAC_LSHERRCT           80     16
IODPAC_LSHHRDCM           20     16
IODPAC_LSHHWRCM           30     16
IODPAC_LSHMDIER           70     16
IODPAC_LSHPCTUS           9A      1
IODPAC_LSHPWRCY           50     16
IODPAC_LSHPWRON           60     16
IODPAC_LSHWCTTM           90      4
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 V7R3.0.

Last updated on 13 September 2022 at 13:29:05.
Copyright IBM Corporation, 1990, 2022