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

MRMTRPCI

Prolog
Control Block Contents
Cross Reference

MRMTRPCI Prolog

 DSECT NAME - MTRPCI
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRMTRPCI
 DESCRIPTIVE NAME - Monitor Sample Configuration Record
                    Domain 1  - Monitor Domain
                    Record 27 - PCI function Configuration Data
 DESCRIPTION - Describes the configuration of a real PCI function.
               A separate record is generated for each real PCI
               function defined to the system.
 NOTES:
   Values for MTRPCI_RPCIPFT:
      '00'X - Unclassified type
      '02'X - RoCE Express type
      '03'X - zEDC type
      '05'X - ISM type
      '07'X - Sync IO type
      '08'X - RCE type
      '0A'X - CX4 type
      '0B'X - NVMe type

MRMTRPCI Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   140  MTRPCI
   0   0  Character     0  MTRPCI_MRHDR           Record header. See MRRECHDR
                                                  for details.
   0   0  Character    20  MRHDR
   0   0  Unsigned      2  MRHDRLEN               record length in bytes
   2   2  Unsigned      2  MRHDRZER               field of zeros
   4   4  Unsigned      1  MRHDRDM                domain identifier
   5   5  Unsigned      1  *
   6   6  Unsigned      2  MRHDRRC                record identifier
   8   8  Character     8  MRHDRTOD               Time at which this record
                                                  was built. In time-of-day
                                                  (TOD) clock format. See IBM
                                                  System 370 XA Principle of
                                                  Operation for explanation of
                                                  format.
  16  10  Character     4  *
  20  14  Character     0  MRHDR_END              End of header
  20  14  Unsigned      4  MTRPCI_RPCIPFID        PCI Function ID
  24  18  Unsigned      4  MTRPCI_VPCIPFID        Virtual PCI function ID
                                                  (zero if not attached)
  28  1C  Character     8  MTRPCI_VMDUSER         UserID to whom function
                                                  attached (zero if not
                                                  attached)
  36  24  Unsigned      4  MTRPCI_RPCIHNDG        PCI General Handle
  40  28  Unsigned      2  MTRPCI_RPCIDVID        PCI Device ID
  42  2A  Unsigned      2  MTRPCI_RPCIVDID        PCI Vendor ID
  44  2C  Bitstring     1  MTRPCI_RPCICFLG        PCI State Flag
          1... ....        MTRPCI_RPCICONF         PCI function is configured
          .1.. ....        MTRPCI_RPCIPERM         PCI function is in
                                                  permanent error state
          ..1. ....        MTRPCI_RPCIERR          PCI function is in error
                                                  state
          ...1 ....        MTRPCI_RPCIBLOK         PCI function blocked
          .... 1...        *
          .... .1..        MTRPCI_RPCIUNEN         PCI function is
                                                  unexpectedly in the enabled
                                                  state
          .... ..1.        MTRPCI_RPCIINIT         PCI function initialized
          .... ...1        MTRPCI_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
  45  2D  Bitstring     1  MTRPCI_VPCIFC          Function Controls
          1... ....        MTRPCI_VPCIEAS          DMA registered
          .1.. ....        *
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
  46  2E  Character     1  MTRPCI_FIBKYDTH        Host table type. (Valid
                                                  when DMA registered)
  47  2F  Character     1  MTRPCI_FIBKYDTG        Guest table type. (Valid
                                                  when DMA registered)
  48  30  Character     8  MTRPCI_FIBPBA          DMA base address (valid
                                                  when DMA registered)
  56  38  Character     8  MTRPCI_FIBPAL          DMA address limit(valid
                                                  when DMA registered)
  64  40  Character     2  MTRPCI_PCHID           Physical Channel Identifier
  66  42  Character     2  MTRPCI_PVFN            Virtual Function Number
  68  44  Character     2  MTRPCI_MUI             Measurement block update
                                                  interval (this is how often
                                                  the fields IODPAC_FMBxxxx
                                                  fields are updated)
  70  46  Character     2  MTRPCI_PFGID           Function Group ID
  72  48  Bitstring     1  MTRPCI_CALFLAG         PCI function state
          1... ....        MTRPCI_CALENABL         PCI function is enabled
          .1.. ....        *
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
  73  49  Bitstring     1  MTRPCI_FLAG            Flag
          1... ....        MTRPCI_UVALID           Utility String valid
          .1.. ....        *
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
  74  4A  Character     1  MTRPCI_RPCIPORT        PCI Function Port
  75  4B  Character     1  MTRPCI_RPCIPFT         PCI Function Type
  76  4C  Character    16  MTRPCI_NETID1          Utility String Network ID
                                                  1. Valid when MTRPCI_UVALID
                                                  is set
  92  5C  Character    16  MTRPCI_NETID2          Utility String Network ID
                                                  2. Valid when MTRPCI_UVALID
                                                  is set
 108  6C  Character    16  MTRPCI_NETID3          Utility String Network ID
                                                  3. Valid when MTRPCI_UVALID
                                                  is set
 124  7C  Character    16  MTRPCI_NETID4          Utility String Network ID
                                                  4. Valid when MTRPCI_UVALID
                                                  is set
 140  8C  Character     0  MTRPCI_END

MRMTRPCI Cross Reference

                      Hex           Hex
Name                  Offset Length Value
 
MRHDR                      0     20
MRHDR_END                 14      0
MRHDRDM                    4      1
MRHDRLEN                   0      2
MRHDRRC                    6      2
MRHDRTOD                   8      8
MRHDRZER                   2      2
MTRPCI                     0    140
MTRPCI_CALENABL           48           80
MTRPCI_CALFLAG            48      1
MTRPCI_END                8C      0
MTRPCI_FIBKYDTG           2F      1
MTRPCI_FIBKYDTH           2E      1
MTRPCI_FIBPAL             38      8
MTRPCI_FIBPBA             30      8
MTRPCI_FLAG               49      1
MTRPCI_MRHDR               0      0
MTRPCI_MUI                44      2
MTRPCI_NETID1             4C     16
MTRPCI_NETID2             5C     16
MTRPCI_NETID3             6C     16
MTRPCI_NETID4             7C     16
MTRPCI_PCHID              40      2
MTRPCI_PFGID              46      2
MTRPCI_PVFN               42      2
MTRPCI_RPCIBLOK           2C           10
MTRPCI_RPCICFLG           2C      1
MTRPCI_RPCICONF           2C           80
MTRPCI_RPCIDEAD           2C           01
MTRPCI_RPCIDVID           28      2
MTRPCI_RPCIERR            2C           20
MTRPCI_RPCIHNDG           24      4
MTRPCI_RPCIINIT           2C           02
MTRPCI_RPCIPERM           2C           40
MTRPCI_RPCIPFID           14      4
MTRPCI_RPCIPFT            4B      1
MTRPCI_RPCIPORT           4A      1
MTRPCI_RPCIUNEN           2C           04
MTRPCI_RPCIVDID           2A      2
MTRPCI_UVALID             49           80
MTRPCI_VMDUSER            1C      8
MTRPCI_VPCIEAS            2D           80
MTRPCI_VPCIFC             2D      1
MTRPCI_VPCIPFID           18      4

This information is
based on z/VM V6R4.0.

Last updated on 12 Sep 2019 at 12:28:14.
Copyright IBM Corporation, 1990, 2019