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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005