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 - SYTRSG FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSYTRSG DESCRIPTIVE NAME - Monitor Sample Record Domain 0 - System Domain Record 3 - Real Storage Data (Global) DESCRIPTION - Real storage allocation and use. Provides dynamically changing classes of usage. Static classes of usage are provided in the MONITOR domain.
MRSYTRSG Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 224 SYTRSG Start of monitor record 0 0 Character 0 SYTRSG_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 * Reserved for IBM use. Previous field is no longer meangingul. (SYTRSG_RSAFSTOR) 24 18 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SYTRSG_SYSVRSZ) 28 1C Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SYTRSG_RSAFSYUD) 32 20 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SYTRSG_RSAFVRUD) 36 24 Unsigned 4 SYTRSG_SYSRSVPG Cardinal count of reserved pages. 40 28 Unsigned 4 SYTRSG_RSACPLOK Cardinal count of frames locked below 2G by the CP LOCK REAL command. See SYTRSG_RSACPLKG for the >2G count. 44 2C Unsigned 4 SYTRSG_RSANONPG Cardinal count of <2G 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. See SYTRSG_RSAPGABL and SYTRSG_RSALGFRM. 48 30 Unsigned 4 SYTRSG_RSAPGABL Cardinal count of <2G pageable frames in the system. This includes those that had been made non-pageable (see SYTRSG_RSANONPG). The size of the dynamic area (DPA) or the count of useable frames may be calculated by subtracting RSANONPG from RSAPGABL. See SYTRSG_RSALGFRM for the >2G field for the count of useable frames. NOTE: There is no separate count for pageable frames (RSAPAGBL) and frames made non-pageable (RSANONPG) >2G. 52 34 Unsigned 4 SYTRSG_RSAAVAIL Cardinal count of frames that are currently on the <2G available list. See SYTRSG_RSA2GAVL for the >2G count. 56 38 Unsigned 4 SYTRSG_RSAFRQWT Cardinal count of deferred tasks waiting for a frame. This represents the number of requests for real frames which have not been satisfied yet because no frames are available. It includes both tasks waiting for frames above and below the 2GB line. For a count of tasks waiting for a frame below 2GB, subtract SYTRSG_RSA2GDCT from this field. 60 3C Unsigned 4 SYTRSG_RSAXTEND Cardinal count of frames missing from the free storage reserved frames list. 64 40 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SYTRSG_RSAXFREE) 68 44 Unsigned 4 SYTRSG_RSASAVFR Cardinal count of frames in use for saveareas. 72 48 Bitstring 1 * Reserved for IBM use. Previous field is no longer meaningful. (SYTRSG_CALSTAT) 73 49 Bitstring 1 SYTRSG_CALFLAG1 Flags byte. 1... .... SYTRSG_TCMCACHE Minidisk Caching is enabled. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 74 4A Unsigned 2 SYTRSG_HCPSTPMB Bias for minidisk cache use of real storage. A decimal point is assumed to the left of the low order 2 digits. For example, a value of decimal 95 in this field would be a bias setting of .95 . 76 4C Unsigned 4 SYTRSG_SYS98XA Cardinal number of pages locked by Diagnose X'98' in 31-bit mode 80 50 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SYTRSG_SYS98370) 84 54 Unsigned 4 SYTRSG_TCMMIDSZ Maximum allowable number of pages in mindisk cache (based on average age of a page in DPA). 88 58 Unsigned 4 SYTRSG_TCMMAIN Current number of pages in main storage being used as track cache pages. For a breakdown of pages below and above the 2GB line, see SYTRSG_TCMMNBLW and SYTRSG_TCMMNABV. 92 5C Unsigned 4 SYTRSG_TCMMNMIN Minimum number of main storage pages used by cache as set by user command 96 60 Unsigned 4 SYTRSG_TCMMNMAX Maximum number of main storage pages used by cache as set by user command 100 64 Unsigned 4 SYTRSG_TCMMNDL Number of main storage pages deleted from cache 104 68 Unsigned 4 SYTRSG_TCMSTLMN Number of times the steal function was invoked to steal main storage pages from the track cache 108 6C Unsigned 4 SYTRSG_SYSSCMAV Number of SCMBKs that are available. This field is valid only when format-0 measurement blocks are being used (MTRSYS_CALFLG2 <> x'80'). 112 70 Unsigned 4 SYTRSG_TCMMNBLW Number of pages in main storage below 2GB in use as track cache pages. For ESA/390 systems this field will be equal to SYTRSG_TCMMAIN. 116 74 Unsigned 4 SYTRSG_TCMMNABV Number of pages in main storage at or above 2GB in use as track cache pages. For ESA/390 systems this field will be zero. 120 78 Unsigned 4 SYTRSG_RSA2GDCT Cardinal count of deferred tasks that are waiting for frames that can be above the 2GB line. See SYTRSG_RSADFRQWT for the total count. For a count of tasks waiting for frames below the 2GB line, subtract this field from SYTRSG_RSADFRQWT. 124 7C Unsigned 4 SYTRSG_SYSSCGCT Number of SCGBKs currently allocated. This field is valid only when format-1 measurement blocks are being used (MTRSYS_CALFLG2 = x'80'). 128 80 Character 8 SYTRSG_RSALGFRM Cardinal count of >2G useable frames. See SYTRSG_RSAPGABL and STYRSG_RSANONPG for the <2G value. 136 88 Unsigned 4 SYTRSG_RSACPLKG Cardinal count of frames locked above 2G by the CP LOCK REAL command. See SYTRSG_RSACPLOK for the <2G count. 140 8C Character 8 SYTRSG_RSA2GAVL Cardinal count of frames that are currently on the >2G available list. See SYTRSG_RSAAVAIL for the <2G count. 148 94 Unsigned 4 SYTRSG_RSAFSB2G Count of doublewords assigned to subpool free storage backed below 2G. 152 98 Unsigned 4 SYTRSG_RSAFSA2G Count of doublewords assigned to subpool free storage backed above 2G. 156 9C Unsigned 4 SYTRSG_RSAFSYUB Count of doublewords of in use subpool free storage backed below 2G. 160 A0 Unsigned 4 SYTRSG_RSAFSYUA Count of doublewords of in use subpool free storage backed above 2G. 164 A4 Unsigned 4 SYTRSG_RSASXCPL Count of locked System Execution Space alias pages locked in logical via the CP LOCK command. 168 A8 Unsigned 4 SYTRSG_RSASXCLA Count of locked System Execution Space alias pages locked in logical. RSASXCLA >= RSASXCPL 172 AC Unsigned 4 SYTRSG_RSARFRST Count of frames allocated for real free storage <2G. 176 B0 Character 8 SYTRSG_RSARFRSG Count of frames allocated for real free storage >2G. 184 B8 Unsigned 4 SYTRSG_RSASXBCT Count of SXS pages on the queue of SXS pages backed below 2G. 188 BC Unsigned 4 SYTRSG_RSASXACT Count of SXS pages on the queue of SXS pages backed above 2G. 192 C0 Unsigned 4 SYTRSG_RSAAFRDB Count of doublewords of aligned real free storage <2G. This count includes active as well as inactive aligned free storage. 196 C4 Character 8 SYTRSG_RSAAFRDW Count of doublewords of aligned real free storage >2G. This count includes active as well as inactive aligned free storage. 204 CC Unsigned 4 SYTRSG_RSAAFRIB Count of doublewords of in use aligned real free storage <2G. This count includes only active aligned free storage. 208 D0 Character 8 SYTRSG_RSAAFRIU Count of doublewords of in use aligned real free storage >2G. This count includes only active aligned free storage. 216 D8 Character 8 SYTRSG_RSACALCT Count of the total number of frames on the cleared available list. 224 E0 Character 0 SYTRSG_END
MRSYTRSG 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 SYTRSG 0 224 SYTRSG_CALFLAG1 49 1 SYTRSG_END E0 0 SYTRSG_HCPSTPMB 4A 2 SYTRSG_MRHDR 0 0 SYTRSG_RSAAFRDB C0 4 SYTRSG_RSAAFRDW C4 8 SYTRSG_RSAAFRIB CC 4 SYTRSG_RSAAFRIU D0 8 SYTRSG_RSAAVAIL 34 4 SYTRSG_RSACALCT D8 8 SYTRSG_RSACPLKG 88 4 SYTRSG_RSACPLOK 28 4 SYTRSG_RSAFRQWT 38 4 SYTRSG_RSAFSA2G 98 4 SYTRSG_RSAFSB2G 94 4 SYTRSG_RSAFSYUA A0 4 SYTRSG_RSAFSYUB 9C 4 SYTRSG_RSALGFRM 80 8 SYTRSG_RSANONPG 2C 4 SYTRSG_RSAPGABL 30 4 SYTRSG_RSARFRSG B0 8 SYTRSG_RSARFRST AC 4 SYTRSG_RSASAVFR 44 4 SYTRSG_RSASXACT BC 4 SYTRSG_RSASXBCT B8 4 SYTRSG_RSASXCLA A8 4 SYTRSG_RSASXCPL A4 4 SYTRSG_RSAXTEND 3C 4 SYTRSG_RSA2GAVL 8C 8 SYTRSG_RSA2GDCT 78 4 SYTRSG_SYSRSVPG 24 4 SYTRSG_SYSSCGCT 7C 4 SYTRSG_SYSSCMAV 6C 4 SYTRSG_SYS98XA 4C 4 SYTRSG_TCMCACHE 49 80 SYTRSG_TCMMAIN 58 4 SYTRSG_TCMMIDSZ 54 4 SYTRSG_TCMMNABV 74 4 SYTRSG_TCMMNBLW 70 4 SYTRSG_TCMMNDL 64 4 SYTRSG_TCMMNMAX 60 4 SYTRSG_TCMMNMIN 5C 4 SYTRSG_TCMSTLMN 68 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