|
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 or userids that are enabled 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'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. 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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003