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   196  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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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
                                                      reclaimed 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  *                      Reserved for IBM use - was
                                                      STOASI_ASCCSXRD
      80  50  Unsigned      4  *                      Reserved for IBM use - was
                                                      STOASI_ASCCSXWT
      84  54  Unsigned      4  *                      Reserved for IBM use - was
                                                      STOASI_ASCCSMIG
      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  *                      Reserved for IBM use - was
                                                      STOASI_ASCCTXBK
     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  Unsigned      4  STOASI_ASCCTINS        Cardinal count of shared
                                                      instantiated pages.
     140  8C  Unsigned      4  STOASI_ASCCTIBRB2G     Cardinal count of shared
                                                      IBR pages on the UFO and
                                                      backed by frames < 2G.
     144  90  Unsigned      4  STOASI_ASCCTIBRA2G     Cardinal count of shared
                                                      IBR pages on the UFO and
                                                      backed by frames > 2G.
     148  94  Unsigned      4  STOASI_ASCCTAGLB2G     Cardinal count of shared
                                                      IBR pages on the global aging
                                                      list and backed by frames <
                                                      2G.
     152  98  Unsigned      4  STOASI_ASCCTAGLA2G     Cardinal count of shared
                                                      IBR pages on the global aging
                                                      list and backed by frames >
                                                      2G.
     156  9C  Unsigned      4  STOASI_ASCCTRABISB2G   Cardinal count of shared
                                                      non-faulted pages read in by
                                                      a block read, made IBR,
                                                      currently on the UFO or the
                                                      global aging list, and backed
                                                      by frames < 2G.
     160  A0  Unsigned      4  STOASI_ASCCTRABISA2G   Cardinal count of shared
                                                      non-faulted pages read in by
                                                      a block read, made IBR,
                                                      currently on the UFO or the
                                                      global aging list, and backed
                                                      by frames > 2G.
     164  A4  Unsigned      4  STOASI_ASCCSINT        Cumulative count of shared
                                                      instantiated pages.
     168  A8  Unsigned      4  STOASI_ASCCSREL        Cumulative count of shared
                                                      pages whose frames were
                                                      reclaimed without preserving
                                                      page content because of the
                                                      guest page state (that is,
                                                      the collaborative memory
                                                      management state or because
                                                      the contents was released by
                                                      the guest via DIAG x10 or
                                                      DIAG x214).
     172  AC  Unsigned      4  STOASI_ASCCSINV        Cumulative count of shared
                                                      pages made IBR.
     176  B0  Unsigned      4  STOASI_ASCCSPFI        Cumulative count of shared
                                                      IBR pages revalidated while
                                                      on the UFO.
     180  B4  Unsigned      4  STOASI_ASCCSPFA        Cumulative count of shared
                                                      IBR pages revalidated while
                                                      on the global aging list.
     184  B8  Unsigned      4  STOASI_ASCCSFRY        Cumulative count of shared
                                                      IBR pages residing on the
                                                      global aging list that were
                                                      already backed on auxiliary
                                                      storage when their frames
                                                      were reclaimed.
     188  BC  Unsigned      4  STOASI_ASCCSFNR        Cumulative count of shared
                                                      IBR pages residing on the UFO
                                                      list that were written to
                                                      auxiliary storage immediately
                                                      prior to frame reclaim
     192  C0  Unsigned      4  *                      Reserved for IBM use - was
                                                      STOASI_ASCCSXRL
     196  C4  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    196
    STOASI_ASCCSFNR           BC      4
    STOASI_ASCCSFRY           B8      4
    STOASI_ASCCSINT           A4      4
    STOASI_ASCCSINV           AC      4
    STOASI_ASCCSPFA           B4      4
    STOASI_ASCCSPFI           B0      4
    STOASI_ASCCSPGR           44      4
    STOASI_ASCCSPGW           48      4
    STOASI_ASCCSPST           40      4
    STOASI_ASCCSREL           A8      4
    STOASI_ASCCTAGLA2G        98      4
    STOASI_ASCCTAGLB2G        94      4
    STOASI_ASCCTIBRA2G        90      4
    STOASI_ASCCTIBRB2G        8C      4
    STOASI_ASCCTINS           88      4
    STOASI_ASCCTPGS           5C      4
    STOASI_ASCCTPLK           58      4
    STOASI_ASCCTPLKA          80      8
    STOASI_ASCCTPRG           74      4
    STOASI_ASCCTPRS           3C      4
    STOASI_ASCCTRABISA2G      A0      4
    STOASI_ASCCTRABISB2G      9C      4
    STOASI_ASCCTSPI           38      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                C4      0
    STOASI_MRHDR               0      0

    This information is
    based on z/VM V7R2.0.

    Last updated on 08 August 2020 at 21:29:36.

    Copyright IBM Corporation, 1990, 2020