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

    Last updated on 05 August 2020 at 20:50:53.

    Copyright IBM Corporation, 1990, 2020