Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSTOASI
PrologControl Block Contents
Cross Reference
MRSTOASI Prolog
DSECT NAME - STOASI FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSTOASI DESCRIPTIVE NAME - Monitor Sample Record Domain 3 - Storage Domain Record 14 - Address Space Information Record DESCRIPTION - Information concerning a shared address space usage.
MRSTOASI Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 196 STOASI Start of monitor record 0 0 Character 0 STOASI_MRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Character 8 STOASI_ASCUSRID Owning userid, padded on the right with blanks. 28 1C Character 24 STOASI_ASCNAME Address space name, padded on the right with blanks. 52 34 Bitstring 1 STOASI_CALSTATE Address space current attribute. 1... .... STOASI_ASCSHARE At least one configuration other than the owner has permission to access this address space. .1.. .... STOASI_ASCPUBLC Any user may attach this address space to their guest use access list for read only access. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 53 35 Character 3 * Reserved for IBM use. 56 38 Unsigned 4 STOASI_ASCCTSPI Number of users permitted to use this address space. If this field is all X'FF's, this address space has been made public. 60 3C Unsigned 4 STOASI_ASCCTPRS Cardinal count of resident pages <2G for this address space. See STOASI_ASCCTPRG for the >2G value. 64 40 Unsigned 4 STOASI_ASCCSPST Cumulative count of pages reclaimed from this address space while shared. 68 44 Unsigned 4 STOASI_ASCCSPGR Cumulative count of pages read from DASD to main storage for for this address space while shared. 72 48 Unsigned 4 STOASI_ASCCSPGW Cumulative count of pages written from main storage to DASD for this address space while shared. 76 4C Unsigned 4 * Reserved for IBM use - was STOASI_ASCCSXRD 80 50 Unsigned 4 * Reserved for IBM use - was STOASI_ASCCSXWT 84 54 Unsigned 4 * Reserved for IBM use - was STOASI_ASCCSMIG 88 58 Unsigned 4 STOASI_ASCCTPLK Cardinal count of pages <2G locked by this address space. See STOASI_ASCCTPLKA for the >2G value. 92 5C Unsigned 4 STOASI_ASCCTPGS Cardinal count of non-preferred paging slots for this address space. 96 60 Unsigned 4 * Reserved for IBM use - was STOASI_ASCCTXBK 100 64 Unsigned 4 STOASI_ASCSSIZE Size of address space, in bytes. This field is kept for compatability reasons, but may not be accurate for z/Arch systems where larger address spaces are valid. The preferred field is STOASI_ASCDEFSZ. 104 68 Character 8 STOASI_ASCDEFSZ Defined address space size in addressable bytes, minus one. The minus one notation is used so that a total size of 16 Exabytes may be represented without ambiguity (as x'FFFFFFFF_FFFFFFFF'). 104 68 Character 4 STOASI_CALDEFHI high four bytes 108 6C Character 4 STOASI_CALDEFLO low four bytes 112 70 Unsigned 4 STOASI_ASCMVB2G Number of times page translation moved a page in this address space from a frame with an address >= 2GB to one < 2GB. 116 74 Unsigned 4 STOASI_ASCCTPRG Cardinal count of resident pages >2G for this address space. See STOASI_ASCCTPRS for the <2G value. 120 78 Unsigned 4 STOASI_ASCHLLC Count of pages locked in Host Logical storage for this address space. 124 7C Unsigned 4 STOASI_ASCHLRC Host logical resident count. 128 80 Character 8 STOASI_ASCCTPLKA Cardinal count of pages >2G locked by this address space. See STOASI_ASCCTPLK for the <2G value. 136 88 Unsigned 4 STOASI_ASCCTINS Cardinal count of shared instantiated pages. 140 8C Unsigned 4 STOASI_ASCCTIBRB2G Cardinal count of shared IBR pages on the UFO and backed by frames < 2G. 144 90 Unsigned 4 STOASI_ASCCTIBRA2G Cardinal count of shared IBR pages on the UFO and backed by frames > 2G. 148 94 Unsigned 4 STOASI_ASCCTAGLB2G Cardinal count of shared IBR pages on the global aging list and backed by frames < 2G. 152 98 Unsigned 4 STOASI_ASCCTAGLA2G Cardinal count of shared IBR pages on the global aging list and backed by frames > 2G. 156 9C Unsigned 4 STOASI_ASCCTRABISB2G Cardinal count of shared non-faulted pages read in by a block read, made IBR, currently on the UFO or the global aging list, and backed by frames < 2G. 160 A0 Unsigned 4 STOASI_ASCCTRABISA2G Cardinal count of shared non-faulted pages read in by a block read, made IBR, currently on the UFO or the global aging list, and backed by frames > 2G. 164 A4 Unsigned 4 STOASI_ASCCSINT Cumulative count of shared instantiated pages. 168 A8 Unsigned 4 STOASI_ASCCSREL Cumulative count of shared pages whose frames were reclaimed without preserving page content because of the guest page state (that is, the collaborative memory management state or because the contents was released by the guest via DIAG x10 or DIAG x214). 172 AC Unsigned 4 STOASI_ASCCSINV Cumulative count of shared pages made IBR. 176 B0 Unsigned 4 STOASI_ASCCSPFI Cumulative count of shared IBR pages revalidated while on the UFO. 180 B4 Unsigned 4 STOASI_ASCCSPFA Cumulative count of shared IBR pages revalidated while on the global aging list. 184 B8 Unsigned 4 STOASI_ASCCSFRY Cumulative count of shared IBR pages residing on the global aging list that were already backed on auxiliary storage when their frames were reclaimed. 188 BC Unsigned 4 STOASI_ASCCSFNR Cumulative count of shared IBR pages residing on the UFO list that were written to auxiliary storage immediately prior to frame reclaim 192 C0 Unsigned 4 * Reserved for IBM use - was STOASI_ASCCSXRL 196 C4 Character 0 STOASI_END
MRSTOASI 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 STOASI 0 196 STOASI_ASCCSFNR BC 4 STOASI_ASCCSFRY B8 4 STOASI_ASCCSINT A4 4 STOASI_ASCCSINV AC 4 STOASI_ASCCSPFA B4 4 STOASI_ASCCSPFI B0 4 STOASI_ASCCSPGR 44 4 STOASI_ASCCSPGW 48 4 STOASI_ASCCSPST 40 4 STOASI_ASCCSREL A8 4 STOASI_ASCCTAGLA2G 98 4 STOASI_ASCCTAGLB2G 94 4 STOASI_ASCCTIBRA2G 90 4 STOASI_ASCCTIBRB2G 8C 4 STOASI_ASCCTINS 88 4 STOASI_ASCCTPGS 5C 4 STOASI_ASCCTPLK 58 4 STOASI_ASCCTPLKA 80 8 STOASI_ASCCTPRG 74 4 STOASI_ASCCTPRS 3C 4 STOASI_ASCCTRABISA2G A0 4 STOASI_ASCCTRABISB2G 9C 4 STOASI_ASCCTSPI 38 4 STOASI_ASCDEFSZ 68 8 STOASI_ASCHLLC 78 4 STOASI_ASCHLRC 7C 4 STOASI_ASCMVB2G 70 4 STOASI_ASCNAME 1C 24 STOASI_ASCPUBLC 34 40 STOASI_ASCSHARE 34 80 STOASI_ASCSSIZE 64 4 STOASI_ASCUSRID 14 8 STOASI_CALDEFHI 68 4 STOASI_CALDEFLO 6C 4 STOASI_CALSTATE 34 1 STOASI_END C4 0 STOASI_MRHDR 0 0
This information is based on z/VM V6R4.0.
Last updated on 5 Oct 2016 at 10:12:36.
Copyright IBM Corporation, 1990, 2016