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 - STORSG FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor control area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSTORSG DESCRIPTIVE NAME - Monitor Sample Record Domain 3 - Storage Domain Record 1 - Real Storage Management (Global) DESCRIPTION - Utilization of real memory. This includes available list replenishment and free storage management.
MRSTORSG Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 300 STORSG Start of monitor record 0 0 Character 0 STORSG_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 STORSG_CALSSUBT Cardinal count of blocks on each regular free storage subpool list <2G. See STORSG_CALSSUBG for the >2G value. 24 18 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (STORSG_CALVSUBT) 28 1C Unsigned 4 STORSG_RSASAVFR Cardinal count of frames in use for saveareas. 32 20 Unsigned 4 STORSG_RSAMAXPP Cardinal count of reserved frames per processor. See also STORSG_RSARSVSY. 36 24 Unsigned 4 STORSG_RSACPLOK Cardinal count of frames locked below 2G by the CP LOCK REAL command. See STORSG_RSACPLKG for the >2G count. 40 28 Unsigned 4 STORSG_RSAAVLLT Cardinal count of <2G available list low threshold value. Indicates when the <2G demand scan should be invoked. This provides a buffer of frames for the system to use while the demand scan is replenishing the <2G available list. See STORSG_RSAAVLLG for the >2G value. 44 2C Unsigned 4 STORSG_RSAAVLHT Cardinal count of <2G available list high threshold. Number of frames that should be taken by the <2G available list replenishment functions to satisfy the current user and system needs. See STORSG_RSAAVLHG for the >2G value. 48 30 Unsigned 4 STORSG_XSTBPRCT Number of page faults that involved DASD blocked pages 52 34 Unsigned 4 STORSG_XSTSRGCT Number of single page reads for a guest 56 38 Unsigned 4 STORSG_XSTMRABI Number of pages that were brought in as part of a block (the guest referenced a different page that was a member of the block) but which have not been referenced by the time they were selected for migration 60 3C Unsigned 4 STORSG_XSTSRABI Number of pages that were brought in as part of a block (the guest referenced a different page that was a member of the block) but which have not been referenced by the time they were selected for steal 64 40 Unsigned 4 STORSG_XSTSRSCT Number of single reads for the system. System pages are never formed into blocks, so this number represents all system page reads 68 44 Unsigned 4 STORSG_CALPTRRT Number of times the pageable page address space was reorganized to manage the segment paging control fragmentation. PTRROGCT 72 48 Unsigned 4 STORSG_CALCAAFP Number of allocated, but unused, pages of virtual storage for paging virtual segment control. CAAFPAG 76 4C Unsigned 4 STORSG_CALASCUT Number of frames of storage used for paging virtual segment control. ASCUSTE 80 50 Unsigned 4 STORSG_RSASXCPL Count of locked System Execution Space alias pages locked in logical via the CP LOCK command. 84 54 Unsigned 4 STORSG_RSASXCLA Count of locked System Execution Space alias pages locked in logical. RSASXCLA >= RSASXCPL 88 58 Unsigned 4 STORSG_RSAAVLHG Cardinal count of >2G available list high threshold. Number of frames that should be taken by the >2G available list replenishment functions to satisfy the current user and system needs. See STORSG_RSAAVLHT for the <2G value. 92 5C Unsigned 4 STORSG_RSAAVLLG Cardinal count of >2G available list low threshold value. Indicates when the >2G demand scan should be invoked. This provides a buffer of frames for the system to use while the demand scan is replenishing the >2G available list. See STORSG_RSAAVLLT for the <2G value. 96 60 Unsigned 4 STORSG_RSACPLKG Cardinal count of frames locked above 2G by the CP LOCK REAL command. See STORSG_RSACPLOK for the <2G count. 100 64 Unsigned 4 STORSG_CALSSUBG Cardinal count of blocks on each regular free storage subpool list >2G. See STORSG_CALSSUBT for the <2G value. 104 68 Unsigned 4 STORSG_RSARSVSY Total count of reserved pages including the number of pages reserved per processor. See STORSG_RSAMAXPP. 108 6C Character 8 STORSG_RSACALLT Lower Threshold: Non-negative number of FRMTEs on the Cleared Available List below which the the Dispatcher must call a foreground replenishment task since the background task is not being called frequently enough to keep the list at a sufficient level. 116 74 Character 8 STORSG_RSACALMT Middle Threshold: Non-negative number of FRMTEs for the foreground replenishment task to have on the Cleared Available List. Note that we do not want to fill to the Upper Threshold in the foreground because this might take too long and we would rather have the replenishment done in the background if possible. 124 7C Character 8 STORSG_RSACALUT Upper Threshold: Non-negative target number of FRMTEs for the background replenishment task to have on the Cleared Available List. 132 84 Unsigned 4 STORSG_RSAAFSDW Count of doublewords of host logical aligned free storage backed >2G. 136 88 Unsigned 4 STORSG_RSAAFSDB Count of doublewords of host logical aligned free storage backed <2G. 140 8C Unsigned 4 STORSG_RSAAFSIU Count of doublewords of in-use host logical aligned free storage backed >2G. 144 90 Unsigned 4 STORSG_RSAAFSIB Count of doublewords of in-use host logical aligned free storage backed <2G. 148 94 Unsigned 4 STORSG_RSAVCBDW Count of doublewords of verifiable free storage backed >2G. 152 98 Unsigned 4 STORSG_RSAVCBDB Count of doublewords of verifiable free storage backed <2G. 156 9C Unsigned 4 STORSG_RSAVCBIU Count of doublewords of in-use verifiable free storage backed >2G. 160 A0 Unsigned 4 STORSG_RSAVCBIB Count of doublewords of in-use verifiable free storage backed <2G. 164 A4 Unsigned 4 STORSG_RSAVFSDW Count of doublewords of virtual free storage. 168 A8 Unsigned 4 STORSG_RSAVFSIU Count of doublewords of virtual free storage in use. 172 AC Unsigned 4 STORSG_RSA2GDCT Count of deferred frame requests that are waiting for any available frame. This count plus RSAFRQWT is the total wait count. 176 B0 Unsigned 4 STORSG_RSAFRQWT Non-negative count of deferred requests for real frames which have not yet been satisfied since there are no frames available. Requests are for frames <2G. See STORSG_RSA2GDCT. 180 B4 Unsigned 4 STORSG_RSAFRRDA Count of attempts to redrive tasks waiting for frames <2G. 184 B8 Unsigned 4 STORSG_RSAFRRDC Count of individual task redrives performed for frames <2G. 188 BC Unsigned 4 STORSG_RSASTLWT Count of available list replenishment page writes (steal writes) for <2G frames. 192 C0 Unsigned 4 STORSG_RSASWG2G Count of available list replenishment page writes (steal writes) for >=2G frames. 196 C4 Unsigned 4 STORSG_RSAFVMUD Count of doublewords of VMDBK free storage in use >2G. Allocated from VMDBKs, VMDBK free storage pages, and system free storage pages. This count does not include the storage allocated from the free storage subpools. 200 C8 Unsigned 4 STORSG_RSAFVMUB Count of doublewords of VMDBK free storage in use <2G. Allocated from VMDBKs, VMDBK free storage pages, and system free storage pages. This count does not include the storage allocated from the free storage subpools. 204 CC Unsigned 4 STORSG_RSAVMXFR Count of pages in use for VMDBK free storage >2G, i.e., user free pages allocated. This count does not include VMDBKs themselves. 208 D0 Unsigned 4 STORSG_RSAVMXFB Count of pages in use for VMDBK free storage <2G, i.e., user free pages allocated. This count does not include VMDBKs themselves. 212 D4 Unsigned 4 STORSG_RSAVMXUD Count of in-use user free storage doublewords (allocated from VMDBK free storage pages) backed >2G. This count does not include storage in the VMDBKs themselves. 216 D8 Unsigned 4 STORSG_RSAVMXUB Count of in-use user free storage doublewords (allocated from VMDBK free storage pages) backed <2G. This count does not include storage in the VMDBKs themselves. 220 DC Unsigned 4 STORSG_RSASYSFR Count of pages in use for system free storage >2G. 224 E0 Unsigned 4 STORSG_RSASYSFB Count of pages in use for system free storage <2G. 228 E4 Unsigned 4 STORSG_RSASYSUD Count of doublewords of in-use system free storage >2G. 232 E8 Unsigned 4 STORSG_RSASYSUB Count of doublewords of in-use system free storage <2G. 236 EC Unsigned 4 STORSG_RSAPLPCT Count of processors looping in HCPFRFGP/GB trying to get a System Execution Space page backed any for free storage. 240 F0 Unsigned 4 STORSG_RSAPLPCB Count of processors looping in HCPFRFGP/GB trying to get a System Execution Space page backed <2G for free storage. 244 F4 Unsigned 4 STORSG_RSANPGCT Count of consecutive failures from SXPFS where no pages were available for free storage. 248 F8 Unsigned 4 STORSG_RSANPGHI High water mark for number of consecutive failures from SXPFS when trying to get a page for free storage (all processors). 252 FC Unsigned 4 STORSG_RSANOLKL Count of no-owned locked pages in host logical storage. 256 100 Character 8 STORSG_RSANOLKA Count of no-owned locked pages in absolute storage. 264 108 Unsigned 4 STORSG_RSASXNOP Count of no-owned System Execution Space aliases. 268 10C Unsigned 4 STORSG_RSAPPTPS Access Register Translaton Lookaside Buffer (ALB) and Translation Lookaside Buffer (TLB) purges started prior to entering wait. 272 110 Unsigned 4 STORSG_RSAPPTPF ALB/TLB purges finished prior to entering wait. 276 114 Unsigned 4 STORSG_RSAPPTCS ALB/TLB purges using Compare, Swap and Purge (CSP) during emergency Paged PGMBK aging list (PPAL) processing. 280 118 Unsigned 4 STORSG_RSABLKGC Count of tasks representing frame requests requesting or deferred on the RSABLKGF lock. 284 11C Unsigned 4 STORSG_RSAFRQMW Count of tasks currently attempting to obtain multiple frames for PGMBKs. 288 120 Unsigned 4 STORSG_RSAFRQDF Count of deferred multiple frame requests for PGMBKs. 292 124 Unsigned 4 STORSG_RSAFRQDL Count of delayed multiple frame requests for PGMBKs. 296 128 Unsigned 4 STORSG_RSAALFMF Total count of contiguous frames being scanned for by active frame table scan (HCPALFMF FREXSCAN) tasks. 300 12C Character 0 STORSG_END
MRSTORSG 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 STORSG 0 300 STORSG_CALASCUT 4C 4 STORSG_CALCAAFP 48 4 STORSG_CALPTRRT 44 4 STORSG_CALSSUBG 64 4 STORSG_CALSSUBT 14 4 STORSG_END 12C 0 STORSG_MRHDR 0 0 STORSG_RSAAFSDB 88 4 STORSG_RSAAFSDW 84 4 STORSG_RSAAFSIB 90 4 STORSG_RSAAFSIU 8C 4 STORSG_RSAALFMF 128 4 STORSG_RSAAVLHG 58 4 STORSG_RSAAVLHT 2C 4 STORSG_RSAAVLLG 5C 4 STORSG_RSAAVLLT 28 4 STORSG_RSABLKGC 118 4 STORSG_RSACALLT 6C 8 STORSG_RSACALMT 74 8 STORSG_RSACALUT 7C 8 STORSG_RSACPLKG 60 4 STORSG_RSACPLOK 24 4 STORSG_RSAFRQDF 120 4 STORSG_RSAFRQDL 124 4 STORSG_RSAFRQMW 11C 4 STORSG_RSAFRQWT B0 4 STORSG_RSAFRRDA B4 4 STORSG_RSAFRRDC B8 4 STORSG_RSAFVMUB C8 4 STORSG_RSAFVMUD C4 4 STORSG_RSAMAXPP 20 4 STORSG_RSANOLKA 100 8 STORSG_RSANOLKL FC 4 STORSG_RSANPGCT F4 4 STORSG_RSANPGHI F8 4 STORSG_RSAPLPCB F0 4 STORSG_RSAPLPCT EC 4 STORSG_RSAPPTCS 114 4 STORSG_RSAPPTPF 110 4 STORSG_RSAPPTPS 10C 4 STORSG_RSARSVSY 68 4 STORSG_RSASAVFR 1C 4 STORSG_RSASTLWT BC 4 STORSG_RSASWG2G C0 4 STORSG_RSASXCLA 54 4 STORSG_RSASXCPL 50 4 STORSG_RSASXNOP 108 4 STORSG_RSASYSFB E0 4 STORSG_RSASYSFR DC 4 STORSG_RSASYSUB E8 4 STORSG_RSASYSUD E4 4 STORSG_RSAVCBDB 98 4 STORSG_RSAVCBDW 94 4 STORSG_RSAVCBIB A0 4 STORSG_RSAVCBIU 9C 4 STORSG_RSAVFSDW A4 4 STORSG_RSAVFSIU A8 4 STORSG_RSAVMXFB D0 4 STORSG_RSAVMXFR CC 4 STORSG_RSAVMXUB D8 4 STORSG_RSAVMXUD D4 4 STORSG_RSA2GDCT AC 4 STORSG_XSTBPRCT 30 4 STORSG_XSTMRABI 38 4 STORSG_XSTSRABI 3C 4 STORSG_XSTSRGCT 34 4 STORSG_XSTSRSCT 40 4
This information is based on z/VM V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005