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