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