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  100  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
                                             for this saved System/Segment.
 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  STOSHR_ASCCTPLK     Cardinal count of frames locked
                                             for this saved System/Segment.
 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  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    100
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_ASCCTPLK        58      4
STOSHR_ASCCTPRS        28      4
STOSHR_ASCCTXBK        60      4
STOSHR_ASCPTRSH        38      4
STOSHR_END             64      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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003