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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011