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