Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSTOSHR

Prolog
Control Block Contents
Cross Reference

MRSTOSHR Prolog

 DSECT NAME - STOSHR
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRSTOSHR
 DESCRIPTIVE NAME - Monitor Sample Record
                    Domain 3 - Storage Domain
                    Record 3 - Shared Storage Management
                               (per NSS or DCSS)
 DESCRIPTION - Describes shared storage use for Named Saved
               Systems (NSSs), Discontiguous Saved Segments,
               (DCSSs), and Segment Spaces (SSPs).  A
               separate record is generated for each active
               saved system/segment.


MRSTOSHR Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)             Description
 
  0   0  Structure  112  STOSHR                 Start of monitor record
  0   0  Character    0  STOSHR_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  STOSHR_SNTNAME         Shared system or segment name
 28  1C  Signed       2  STOSHR_SDFIDNUM        Spool file ID number
 30  1E  Signed       2  *                      Reserved for IBM use
 32  20  Unsigned     4  STOSHR_SDFCLTIM        Time of data file creation
 36  24  Unsigned     2  STOSHR_SNTUSRSH        Cardinal count of users that
                                                are accessing this saved
                                                System/Segment in shared mode.
 38  26  Unsigned     2  STOSHR_SNTUSREX        Cardinal count of users that
                                                that are accessing this saved
                                                System/Segment in exclusive
                                                mode.
 40  28  Unsigned     4  STOSHR_ASCCTPRS        Cardinal count of resident
                                                pages <2G for this saved
                                                segment. See STOSHR_ASCCTPRG
                                                for the >2G value.
 44  2C  Unsigned     4  STOSHR_SNTSTRCT        Number of pages saved in the
                                                saved System/Segment.
 48  30  Unsigned     4  STOSHR_SNTNDTCT        Number of storage pages
                                                defined with a 'no data saved'
                                                page descriptor code.
 52  34  Unsigned     4  STOSHR_ASCCSPST        Count of frames stolen from
                                                this saved System/Segment. This
                                                counter will be reset to zero
                                                when the saved System/Segment
                                                is no longer in use (released
                                                by its last user.
 56  38  Unsigned     4  STOSHR_ASCPTRSH        Count of page translations of
                                                shared pages for this saved
                                                System/Segment. This counter
                                                will be reset to zero when the
                                                saved System/Segment is no
                                                longer in use (released by its
                                                last user.
 60  3C  Character    8  *                      Reserved for IBM use
 68  44  Unsigned     4  STOSHR_ASCCSPGR        Count of pages read from DASD
                                                to main storage for this saved
                                                System/Segment. This counter
                                                will be reset to zero when the
                                                saved System/Segment is no
                                                longer in use (released by its
                                                last user.
 72  48  Unsigned     4  STOSHR_ASCCSPGW        Count of pages written from
                                                main storage to DASD for this
                                                saved System/Segment. This
                                                counter will be reset to zero
                                                when the saved System/Segment
                                                is no longer in use (released
                                                by its last user.
 76  4C  Unsigned     4  STOSHR_ASCCSXRD        Count of pages read from
                                                expanded storage to main
                                                storage for this saved
                                                System/Segment. This counter
                                                will be reset to zero when the
                                                saved System/Segment is no
                                                longer in use (released by its
                                                last user.
 80  50  Unsigned     4  STOSHR_ASCCSXWT        Count of pages written from
                                                main storage to expanded
                                                storage for this saved
                                                System/Segment. This counter
                                                will be reset to zero when the
                                                saved System/Segment is no
                                                longer in use (released by its
                                                last user.
 84  54  Unsigned     4  STOSHR_ASCCSMIG        Count of pages migrated by CP
                                                from expanded storage to DASD
                                                for this saved System/Segment.
                                                This counter will be reset to
                                                zero when the saved
                                                System/Segment is no longer in
                                                use (released by its last user.
 88  58  Unsigned     4  *                      Reserved for IBM use.
                                                Previous field is no longer
                                                available. (STOSHR_ASCCTPLK)
 92  5C  Unsigned     4  STOSHR_ASCCTPGS        Cardinal count of
                                                non-preferred paging slots for
                                                this saved System/Segment.
 96  60  Unsigned     4  STOSHR_ASCCTXBK        Count of xstore blocks in
                                                this saved System/Segment.
100  64  Unsigned     4  STOSHR_ASCCTPRG        Cardinal count of resident
                                                pages >2G for this saved
                                                segment. See STOSHR_ASCCTPRS
                                                for the <2G value.
104  68  Unsigned     4  STOSHR_ASCHLLC         Count of pages locked in Host
                                                Logical storage for this saved
                                                segment.
108  6C  Unsigned     4  STOSHR_ASCHLRC         Host logical resident count.
112  70  Character    0  STOSHR_END             

MRSTOSHR 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
STOSHR                     0    112
STOSHR_ASCCSMIG           54      4
STOSHR_ASCCSPGR           44      4
STOSHR_ASCCSPGW           48      4
STOSHR_ASCCSPST           34      4
STOSHR_ASCCSXRD           4C      4
STOSHR_ASCCSXWT           50      4
STOSHR_ASCCTPGS           5C      4
STOSHR_ASCCTPRG           64      4
STOSHR_ASCCTPRS           28      4
STOSHR_ASCCTXBK           60      4
STOSHR_ASCHLLC            68      4
STOSHR_ASCHLRC            6C      4
STOSHR_ASCPTRSH           38      4
STOSHR_END                70      0
STOSHR_MRHDR               0      0
STOSHR_SDFCLTIM           20      4
STOSHR_SDFIDNUM           1C      2
STOSHR_SNTNAME            14      8
STOSHR_SNTNDTCT           30      4
STOSHR_SNTSTRCT           2C      4
STOSHR_SNTUSREX           26      2
STOSHR_SNTUSRSH           24      2

This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007