|
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