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
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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002