|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCTOP
PrologControl Block Contents
Cross Reference
MRPRCTOP Prolog
DSECT NAME - PRCTOP
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRPRCTOP
DESCRIPTIVE NAME - Monitor Event Record
Domain 5 - Processor Domain
Record 14 - 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
PRCTOP_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)
MRPRCTOP Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 36 PRCTOP Start of monitor record
0 0 Character 0 PRCTOP_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 PRCTOP_STSIOFF Offset to STSI 15.1.x
output
22 16 Unsigned 2 PRCTOP_STSILEN Length of STSI 15.1.x
output in this monitor record
24 18 Bitstring 1 PRCTOP_PCCMNEST Maximum MNest value from
the RSCP Information response
25 19 Bitstring 1 PRCTOP_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 PRCTOP_RCCTOPPL Cumulative number of times
CP checked for system
topology changes via PTF FC
2.
32 20 Unsigned 4 PRCTOP_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 PRCTOP_STSI STSI 15.1.x output. This
section is variable length.
PRCTOP_STSIOFF and
PRCTOP_STSILEN should always
be used to determine the byte
offset of this field in the
record and the byte length of
this field.
MRPRCTOP 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
PRCTOP 0 36
PRCTOP_MRHDR 0 0
PRCTOP_PCCMNEST 18 1
PRCTOP_RCCMNEST 19 1
PRCTOP_RCCTOPCH 20 4
PRCTOP_RCCTOPPL 1C 4
PRCTOP_STSI 24 0
PRCTOP_STSILEN 16 2
PRCTOP_STSIOFF 14 2
This information is
based on z/VM V6R1.0.
Last updated on 10 Apr 2012 at 13:01:13.
Copyright IBM Corporation, 1990, 2012