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

Last updated on 5 Oct 2016 at 10:12:36.
Copyright IBM Corporation, 1990, 2016