|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRTOP
PrologControl Block Contents
Cross Reference
MRMTRTOP Prolog
DSECT NAME - MTRTOP
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRMTRTOP
DESCRIPTIVE NAME - Monitor Configuration Record
Domain 1 - Monitor Domain
Record 26 - System Topology
DESCRIPTION - Provides System Topology counts and
STSI 15.1.x output.
NOTES -
1. The system topology monitor records are identical
and need to stay that way. The identical records
are MRPRCTOP (D5R14) and MRMTRTOP (D1R26).
2. For additional information about the format and meaning
of fields defined in this record (especially the
MTRTOP_STSI field), refer to the following books:
- Principles of Operation for the layout of the
variable length STSI 15.1.x output which is
documented in Chapter 10 under "STORE SYSTEM
INFORMATION". Anyone looking at the STSI data
in this record should read about the format of
the data and the CPU Topology Overview contained
there. (SA22-7832-08)
MRMTRTOP Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 36 MTRTOP Start of monitor record
0 0 Character 0 MTRTOP_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 Unsigned 2 MTRTOP_STSIOFF Offset to STSI 15.1.x
output
22 16 Unsigned 2 MTRTOP_STSILEN Length of STSI 15.1.x
output in this monitor record
24 18 Bitstring 1 MTRTOP_PCCMNEST Maximum MNest value from
the RSCP Information response
25 19 Bitstring 1 MTRTOP_RCCMNEST The selector-2 (x) value
used for the STSI 15.1.x
output.
26 1A Unsigned 2 * Reserved for IBM Use
28 1C Unsigned 4 MTRTOP_RCCTOPPL Cumulative number of times
CP checked for system
topology changes via PTF FC
2.
32 20 Unsigned 4 MTRTOP_RCCTOPCH Cumulative number of times
CP updated the system
topology because it changed
(ie: the PTF FC 2 returned
CC=1).
36 24 Character 0 MTRTOP_STSI STSI 15.1.x output. This
section is variable length.
MTRTOP_STSIOFF and
MTRTOP_STSILEN should always
be used to determine the byte
offset of this field in the
record and the byte length of
this field.
MRMTRTOP 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
MTRTOP 0 36
MTRTOP_MRHDR 0 0
MTRTOP_PCCMNEST 18 1
MTRTOP_RCCMNEST 19 1
MTRTOP_RCCTOPCH 20 4
MTRTOP_RCCTOPPL 1C 4
MTRTOP_STSI 24 0
MTRTOP_STSILEN 16 2
MTRTOP_STSIOFF 14 2
This information is
based on z/VM V6R1.0.
Last updated on 10 Apr 2012 at 13:00:13.
Copyright IBM Corporation, 1990, 2012