Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
DSECT NAME - MTRMEM FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRMTRMEM DESCRIPTIVE NAME - Monitor Sample Configuration Record Domain 1 - Monitor Domain Record 7 - Memory Configuration Data DESCRIPTION - Defines the real memory configuration of the processor complex and the operating system.
MRMTRMEM Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 100 MTRMEM Start of monitor record 0 0 Character 0 MTRMEM_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 4 MTRMEM_RSASTORE Cardinal count of actual real storage size, in bytes, calculated during system initialization. This field is kept for compatability and may not be accurate for 64-bit systems. The preferred field is MTRMEM_RSAGSTOR. 24 18 Unsigned 4 MTRMEM_SYSTORS Storage size of the real machine (sysgenned storage) in bytes. This field is kept for compatability and may not be accurate for 64-bit systems. The preferred field is MTRMEM_SYSGTORS. 28 1C Unsigned 4 MTRMEM_SYSVRSZ Cardinal count of size of V=R area (excluding V=R reserved free storage) in bytes. It is set to 0 if there is no V=R machine defined, or set to the largest value V=R address. It is set to 0 when the V=R area is unlocked if the V=R user has logged off. 32 20 Unsigned 4 MTRMEM_SYSVRFRE Cardinal count of size of V=R reserved free storage (including the VMDBK) in bytes. It is set to 0 when the V=R area is unlocked if there are no outstanding free storage blocks. The sum of this value and MTRMEM_SYSVRSZ gives the total V=R size. 36 24 Unsigned 4 MTRMEM_SYSTRAC Cardinal count of frames that are used for CP trace pages for the master processor. 40 28 Address 4 MTRMEM_HCPMM1 Address of the Marker module to mark the start of the resident executable modules 44 2C Address 4 MTRMEM_HCPMM4 Address of the Marker module to mark the boundary between resident and pageable modules 48 30 Unsigned 4 MTRMEM_RSAPGABL Cardinal count of pageable frames in the system. This includes those that had been made non-pageable (see MTRMEM_RSANONPG). The size of the dynamic area (DPA) may be calculated by subtracting RSANONPG from RSAPGABL. 52 34 Unsigned 4 MTRMEM_RSANONPG Cardinal count of pageable frames in the system that have been made non-pageable. This includes pages locked for I/O, CP LOCK command, virtual system lock functions, etc. 56 38 Unsigned 4 MTRMEM_RSAOFFLN Cardinal count of off-line frames. 60 3C Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (MTRMEM_RSARIOSZ) 64 40 Unsigned 2 MTRMEM_SYSTRCPC Percentage of master processor trace table size to be used for alternate processors 66 42 Character 2 * Reserved for IBM use 68 44 Address 4 MTRMEM_HCPMM0 Address of the Marker module to mark the start of resident MP modules. 72 48 Address 4 MTRMEM_HCPSYS Address of the HCPSYS module which is the start of the resident CP nucleus. 76 4C Unsigned 4 MTRMEM_CALSCMAX Total number of SCMBKs contained in the contiguous storage set aside for the SCMBK area. 80 50 Unsigned 4 MTRMEM_SYSSCMEX Number of extra pages requested for the SCMBK area in the system config file. 84 54 Character 8 MTRMEM_SYSGTORS The sysgen specified storage size minus 1 byte. This includes storage above 2GB. The minus one notation is used so that a total size of 16 Exabytes may be represented without ambiguity (as x'FFFFFFFF_FFFFFFFF'). 92 5C Character 8 MTRMEM_RSAGSTOR The actual real storage size minuz 1 byte. This is calculated at system initialization and includes storage above 2GB. The minus one notation is used so that a total size of 16 Exabytes may be represented without ambiguity (as x'FFFFFFFF_FFFFFFFF'). 100 64 Character 0 MTRMEM_END
MRMTRMEM Cross ReferenceHex 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 MTRMEM 0 100 MTRMEM_CALSCMAX 4C 4 MTRMEM_END 64 0 MTRMEM_HCPMM0 44 4 MTRMEM_HCPMM1 28 4 MTRMEM_HCPMM4 2C 4 MTRMEM_HCPSYS 48 4 MTRMEM_MRHDR 0 0 MTRMEM_RSAGSTOR 5C 8 MTRMEM_RSANONPG 34 4 MTRMEM_RSAOFFLN 38 4 MTRMEM_RSAPGABL 30 4 MTRMEM_RSASTORE 14 4 MTRMEM_SYSGTORS 54 8 MTRMEM_SYSSCMEX 50 4 MTRMEM_SYSTORS 18 4 MTRMEM_SYSTRAC 24 4 MTRMEM_SYSTRCPC 40 2 MTRMEM_SYSVRFRE 20 4 MTRMEM_SYSVRSZ 1C 4
This information is based on z/VM V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002