Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRMEM
PrologControl Block Contents
Cross Reference
MRMTRMEM Prolog
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 Contents
Offsets 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 z/Arch 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 z/Arch 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 But since we have no more Pageable modules, this effectively marks the end of the executable nucleus. However, HCPMM3 officially provides the "end of nucleus" marker and should continue to be used for that purpose. 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 When MTRSYS_CALFLG2 <> x'80' (format-0 measurement blocks), this is the total number of SCMBKs contained in the contiguous storage set aside for the SCMBK area. When When MTRSYS_CALFLG2 = x'80' (format-1 measurement blocks), this is the total number of SCGBKs allocated. 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 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 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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004