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.
 
   PCI Function type values in IODPAD_RPCIPFT:
 
    x'00' Unclassified type
    x'02' RoCE Express type
    x'03' zEDC type
    x'05' ISM type
    x'0A' CX4 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
   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  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
IODPON_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 V6R3.0.

Last updated on 20 Aug 2017 at 20:22:00.
Copyright IBM Corporation, 2017