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

#### MRIODPAD

Prolog
Control Block Contents
Cross Reference

#### MRIODPAD Prolog

     DSECT NAME - IODPAD
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODPAD
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6 - I/O Domain
                        Record 42 - PCI function added to the system
     DESCRIPTION -  This record indicates when an RPCI control block
                    is being built for a new PCI function that is being
                    added to the I/O configuration.
     NOTES:
       Anytime that a new PCI function is discovered by the system
       an RPCI control block is built to represent the new function.
       This record will be built to indicate that event occurring.
       Values for IODPAD_RPCIPFT:
          '00'X - Unclassified type
          '02'X - RoCE Express type
          '03'X - zEDC type
          '05'X - ISM type
          '0A'X - CX4 type
          '0B'X - NVMe type

#### MRIODPAD Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   112  IODPAD
       0   0  Character     0  IODPAD_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  IODPAD_RPCIPFID        PCI Function ID
      24  18  Unsigned      4  IODPAD_RPCIHNDG        PCI General Handle
      28  1C  Unsigned      2  IODPAD_RPCIDVID        PCI Device ID
      30  1E  Unsigned      2  IODPAD_RPCIVDID        PCI Vendor ID
      32  20  Bitstring     1  IODPAD_RPCICFLG        PCI State Flag
              1... ....        IODPAD_RPCICONF         PCI function is configured
              .1.. ....        IODPAD_RPCIPERM         PCI function is in
                                                      Permanent Error state
              ..1. ....        IODPAD_RPCIERR          PCI function is in Error
                                                      state
              ...1 ....        IODPAD_RPCIBLOK         PCI function is Blocked
              .... 1...        *
              .... .1..        IODPAD_RPCIUNEN         PCI function is
                                                      unexpectedly in the enabled
                                                      state
              .... ..1.        IODPAD_RPCIINIT         PCI Function initialized
              .... ...1        IODPAD_RPCIDEAD         Indicates RPCI has been
                                                      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
      33  21  Character     3  *                      Reserved and available for
                                                      IBM Use
      36  24  Character     2  IODPAD_PCHID           Physical Channel ID
      38  26  Character     2  IODPAD_PVFN            Virtual Function Num
      40  28  Character     2  IODPAD_MUI             Measurement block update
                                                      interval (This is how often
                                                      the FMBxxxxx fields, used to
                                                      populate the IODPAC_FMBxxxxx
                                                      fields, are updated.)
      42  2A  Character     2  IODPAD_PFGID           Function Group ID
      44  2C  Bitstring     1  IODPAD_FLAG            General Flags
              1... ....        IODPAD_UVALID           Utility String valid
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      45  2D  Character     1  *                      Reserved and available for
                                                      IBM Use
      46  2E  Character     1  IODPAD_RPCIPORT        PCI Function Port
      47  2F  Character     1  IODPAD_RPCIPFT         PCI Function Type
      48  30  Character    16  IODPAD_NETID1          Utility String - Network ID
                                                      1. Valid when IOPAD_UVALID is
                                                      set.
      64  40  Character    16  IODPAD_NETID2          Utility String - Network ID
                                                      2. Valid when IOPAD_UVALID is
                                                      set.
      80  50  Character    16  IODPAD_NETID3          Utility String - Network ID
                                                      3. Valid when IOPAD_UVALID is
                                                      set.
      96  60  Character    16  IODPAD_NETID4          Utility String - Network ID
                                                      4. Valid when IOPAD_UVALID is
                                                      set.
     112  70  Character     0  IODPAD_END

#### MRIODPAD Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODPAD                     0    112
    IODPAD_END                70      0
    IODPAD_FLAG               2C      1
    IODPAD_MRHDR               0      0
    IODPAD_MUI                28      2
    IODPAD_NETID1             30     16
    IODPAD_NETID2             40     16
    IODPAD_NETID3             50     16
    IODPAD_NETID4             60     16
    IODPAD_PCHID              24      2
    IODPAD_PFGID              2A      2
    IODPAD_PVFN               26      2
    IODPAD_RPCIBLOK           20           10
    IODPAD_RPCICFLG           20      1
    IODPAD_RPCICONF           20           80
    IODPAD_RPCIDEAD           20           01
    IODPAD_RPCIDVID           1C      2
    IODPAD_RPCIERR            20           20
    IODPAD_RPCIHNDG           18      4
    IODPAD_RPCIINIT           20           02
    IODPAD_RPCIPERM           20           40
    IODPAD_RPCIPFID           14      4
    IODPAD_RPCIPFT            2F      1
    IODPAD_RPCIPORT           2E      1
    IODPAD_RPCIUNEN           20           04
    IODPAD_RPCIVDID           1E      2
    IODPAD_UVALID             2C           80
    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:15:34.

    Copyright IBM Corporation, 1990, 2020