Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSTOASI

Prolog
Control 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