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
Storage Layout
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 116 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 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 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 beem made public. 60 3C Unsigned 4 STOASI_ASCCTPRS Cardinal count of resident frames for this address space. 64 40 Unsigned 4 STOASI_ASCCSPST Cumulative count of pages stolen 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 STOASI_ASCCSXRD Cumulative count of pages read from expanded storage to main storage for this address space while shared. 80 50 Unsigned 4 STOASI_ASCCSXWT Cumulative count of pages written from main storage to expanded storage for this address space while shared. 84 54 Unsigned 4 STOASI_ASCCSMIG Cumulative count of pages migrated by CP from expanded storage to DASD for this address space while shared. 88 58 Unsigned 4 STOASI_ASCCTPLK Cardinal count of pages locked by this address space. 92 5C Unsigned 4 STOASI_ASCCTPGS Cardinal count of non-preferred paging slots for this address space. 96 60 Unsigned 4 STOASI_ASCCTXBK Cardinal count of XSTORE blocks for this address space. 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 64-bit 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 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 116 STOASI_ASCCSMIG 54 4 STOASI_ASCCSPGR 44 4 STOASI_ASCCSPGW 48 4 STOASI_ASCCSPST 40 4 STOASI_ASCCSXRD 4C 4 STOASI_ASCCSXWT 50 4 STOASI_ASCCTPGS 5C 4 STOASI_ASCCTPLK 58 4 STOASI_ASCCTPRS 3C 4 STOASI_ASCCTSPI 38 4 STOASI_ASCCTXBK 60 4 STOASI_ASCDEFSZ 68 8 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 74 0 STOASI_MRHDR 0 0
This information is based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001