About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
|
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 136 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
pages <2G for this address
space. See STOASI_ASCCTPRG for
the >2G value.
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 <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 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 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 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 136
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_ASCCTPLKA 80 8
STOASI_ASCCTPRG 74 4
STOASI_ASCCTPRS 3C 4
STOASI_ASCCTSPI 38 4
STOASI_ASCCTXBK 60 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 88 0
STOASI_MRHDR 0 0
This information is
based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007
