|
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 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
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 V6R2.0.
Last updated on 02 Aug 2015 at 17:46:04.
Copyright IBM Corporation, 1990, 2015