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

#### MRUSETRE

Prolog
Control Block Contents
Cross Reference

#### MRUSETRE Prolog

####

####

     DSECT NAME - USETRE
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRUSETRE
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 4 - User Domain
                        Record 8 - User Transaction End
     DESCRIPTION - Provides dispatch and suspend times for a VMDBK.
                   A separate record is generated for each VMDBK in a
                   virtual complex that contributed to the transaction.

    MRUSETRE Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   60  USETRE                 Start of monitor record
      0   0  Character    0  USETRE_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  Character    8  USETRE_VMDUSER         User logon identification
     28  1C  Unsigned     2  USETRE_VMDCPUAD        Processor address
     30  1E  Character    2  USETRE_CALTRIV         'YE' = trivial transaction.
                                                    'NO' = non-trivial translation
     32  20  Character    8  USETRE_VMDDQTOD        Time of day clock at the time
                                                    that the VMDBK was dropped from
                                                    the dispatch list
     40  28  Character    8  USETRE_VMDSUSCK        Time of day clock at the time
                                                    the VMDBK was last marked
                                                    suspended
     48  30  Character    8  USETRE_VMDMTTOD        Time of day clock when the
                                                    last transaction started
     56  38  Bitstring    1  USETRE_CALFLAG1        Flag byte
              1... ....      USETRE_CALBASE         If on, this is the base
                                                    VMDBK. VMDBASE
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     57  39  Unsigned     1  USETRE_VMDPUTYP        Old CPU Type. 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)
     58  3A  Bitstring    1  USETRE_VMDCFGEM        Virtual configuration
                                                    indicators. Valid in base VMDBK
                                                    only
              1... ....      *
              .1.. ....      USETRE_VMDCPUAF        User requested CPU Affinity
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     59  3B  Bitstring    1  USETRE_VMDPUST         CPU Status flag
              1... ....      USETRE_VMDAFSUP        CPU Affinity suppressed
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     60  3C  Character    0  USETRE_END

    MRUSETRE 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
    USETRE                     0     60
    USETRE_CALBASE            38           80
    USETRE_CALFLAG1           38      1
    USETRE_CALTRIV            1E      2
    USETRE_END                3C      0
    USETRE_MRHDR               0      0
    USETRE_VMDAFSUP           3B           80
    USETRE_VMDCFGEM           3A      1
    USETRE_VMDCPUAD           1C      2
    USETRE_VMDCPUAF           3A           40
    USETRE_VMDDQTOD           20      8
    USETRE_VMDMTTOD           30      8
    USETRE_VMDPUST            3B      1
    USETRE_VMDPUTYP           39      1
    USETRE_VMDSUSCK           28      8
    USETRE_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