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 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
                                                  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 V6R2.0.
Last updated on 02 Aug 2015 at 17:46:04.
Copyright IBM Corporation, 1990, 2015