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   120  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
   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  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 reclaimed
                                                  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  *                      Reserved for IBM use - was
                                                  STOSHR_ASCCSXRD
  80  50  Unsigned      4  *                      Count of pages written from
                                                  - was STOSHR_ASCCSXWT
  84  54  Unsigned      4  *                      Count of pages migrated by
                                                  - was STOSHR_ASCCSMIG
  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  *                      Reserved for IBM use - was
                                                  STOSHR_ASCCTXBK
 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  Unsigned      4  STOSHR_ASCCTRSV        Number of frames reserved
                                                  via the SET RESERVED command.
 116  74  Unsigned      4  STOSHR_ASCDSRSV        Cumulative count of times
                                                  demand scan could not move
                                                  any frames for the saved
                                                  System/Segment from the SUFO
                                                  to the global aging list
                                                  because it would violate its
                                                  SET RESERVED setting.
 120  78  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    120
STOSHR_ASCCSPGR           44      4
STOSHR_ASCCSPGW           48      4
STOSHR_ASCCSPST           34      4
STOSHR_ASCCTPGS           5C      4
STOSHR_ASCCTPRG           64      4
STOSHR_ASCCTPRS           28      4
STOSHR_ASCCTRSV           70      4
STOSHR_ASCDSRSV           74      4
STOSHR_ASCHLLC            68      4
STOSHR_ASCHLRC            6C      4
STOSHR_ASCPTRSH           38      4
STOSHR_END                78      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 V7R2.0.

Last updated on 08 August 2020 at 13:01:54.
Copyright IBM Corporation, 1990, 2020