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

Last updated on 11 Sept 2018 at 20:12:53.
Copyright IBM Corporation, 1990, 2018