|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSETRE
PrologControl 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