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  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 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  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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003