|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRDDR
PrologControl Block Contents
Cross Reference
MRMTRDDR Prolog
DSECT NAME - MTRDDR
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRMTRDDR
DESCRIPTIVE NAME - Monitor Event and Sample Configuration Record
Domain 1 - Monitor Domain
Record 14 - Domain Detail
DESCRIPTION - A list of devices, userids, or identifiers of
domain specific subsets that are enable for
monitoring. A separate record is generated for
each applicable event or sample domain.
NOTES:
-- The list of items (MTRDDR_DMITEMS) may be spanned across more
than one MRMTRDDR record. The flag, MTRDDR_CONT, indicates
whether the list is continued in the next MRMTRDDR record.
The record itself will not be spanned across a frame boundary.
When the spanning of the list becomes necessary, this record
will be followed by an End-of-Frame record (MRMTREOF, Domain 1,
Record 13), and the list will be continued in another MRMTRDDR
record in the next frame.
MRMTRDDR Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 28 MTRDDR Start of monitor record
0 0 Character 0 MTRDDR_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 MTRDDR_REQUIRED
20 14 Character 1 MTRDDR_PROFILE Monitor Profile code for this
record: 'E' = event record. 'S'
= sample record.
21 15 Unsigned 1 MTRDDR_DMNUMBER Code indicating the domain
for this record. x'02' =
scheduler domain. x'04' = user
domain. x'05' = processor
domain. x'06' = I/O domain
x'07' = seek domain. x'0A' =
appldata domain.
22 16 Bitstring 1 MTRDDR_DMSTATUS Code pertaining to the
contents of MTRDDR_DMITEMS
table, indicating which items
of the domain are being (or not
being) monitored: x'80' = all
items of the domain are being
monitored. x'40' = all items in
the table --- and only those so
listed---are being monitored.
x'20' = all items EXCEPT those
listed in the table are being
monitored.
23 17 Bitstring 1 MTRDDR_CALFLAGS Flag byte
1... .... MTRDDR_CONT OFF = This is the last or
only record of this set of
MRMTRDDR records pertaining to
the list of items for this
domain and the event or sample
profile. ON = The list of items
(in MTRDDR_DMITEMS), continues
in the next MRMTRDDR record.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
24 18 Signed 4 MTRDDR_DMITEMCT Number of items in the
MTRDDR_DMITEMS table in this
record. Zero if MTRDDR_DMSTATUS
= x'80'. If the list is spanned
across more than one record
(see MTRDDR_CONT), add up all
the MTRDDR_DMITEMCTs of this
set to get the total count of
the items.
28 1C Character 0 MTRDDR_DMITEMS Table of items of the domain,
8-char userids for user domain,
scheduler domain, or appldata
domain, 2-byte hex device
numbers for I/O or seek domain,
8-char identifier for processor
domain.
See codes in MTRDDR_DMNUMBER
and MTRDDR_DMSTATUS.
MRMTRDDR 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
MTRDDR 0 28
MTRDDR_CALFLAGS 17 1
MTRDDR_CONT 17 80
MTRDDR_DMITEMCT 18 4
MTRDDR_DMITEMS 1C 0
MTRDDR_DMNUMBER 15 1
MTRDDR_DMSTATUS 16 1
MTRDDR_MRHDR 0 0
MTRDDR_PROFILE 14 1
MTRDDR_REQUIRED 14 8
This information is
based on z/VM V5R4.0.
Last updated on 9 Aug 2011 at 16:09:41.
Copyright IBM Corporation, 1990, 2011