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
Storage Layout
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     3  *                   Reserved for IBM use
     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_VMDCPUAD        1C      2
    USETRE_VMDDQTOD        20      8
    USETRE_VMDMTTOD        30      8
    USETRE_VMDSUSCK        28      8
    USETRE_VMDUSER         14      8

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

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002