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 V7R2.0.

    Last updated on 09 August 2020 at 15:24:14.

    Copyright IBM Corporation, 1990, 2020