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

#### MRUSERDC

Prolog
Control Block Contents
Cross Reference

#### MRUSERDC Prolog

####

####

     DSECT NAME - USERDC
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRUSERDC
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 4 - User Domain
                        Record 7 - DEFINE CPU n AS
     DESCRIPTION - Records a virtual CPU that has been defined
                   by the DEFINE CPU n AS command.

    MRUSERDC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   36  USERDC                 Start of monitor record
      0   0  Character    0  USERDC_MRHDR           record header
      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  Character    8  USERDC_VMDUSER         User identification
     28  1C  Unsigned     2  USERDC_VMDCPUAD        Old Processor address
     30  1E  Unsigned     2  USERDC_NEWCPUAD        New Processor address
     32  20  Unsigned     1  USERDC_VMDPUTYP        Old CPU Type if a type
                                                    redefinition occurred or blank
                                                    (X'40) if not. Valid values:
                                                    X'00' - General Purpose (CP)
                                                    X'02' - zSeries Application
                                                    Assist (zAAP) X'03' -
                                                    Integrated Facility for Linux
                                                    (IFL) X'04' - Internal Coupling
                                                    Facility (ICF) X'05' - zSeries
                                                    Integrated Information (zIIP)
     33  21  Unsigned     1  USERDC_NEWPUTYP        New CPU Type. See
                                                    USERDC_VMDPUTYP for valid
                                                    values
     34  22  Bitstring    1  USERDC_VMDCFGEM        Virtual configuration
                                                    indicators. Valid in base VMDBK
                                                    only
              1... ....      *
              .1.. ....      USERDC_VMDCPUAF        User requested CPU Affinity
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     35  23  Bitstring    1  USERDC_VMDPUST         CPU Status flag
              1... ....      USERDC_VMDAFSUP        CPU Affinity suppressed
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     36  24  Character    0  USERDC_END

    MRUSERDC 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
    USERDC                     0     36
    USERDC_END                24      0
    USERDC_MRHDR               0      0
    USERDC_NEWCPUAD           1E      2
    USERDC_NEWPUTYP           21      1
    USERDC_VMDAFSUP           23           80
    USERDC_VMDCFGEM           22      1
    USERDC_VMDCPUAD           1C      2
    USERDC_VMDCPUAF           22           40
    USERDC_VMDPUST            23      1
    USERDC_VMDPUTYP           20      1
    USERDC_VMDUSER            14      8

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

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009