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
Storage Layout
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 V4R3.0.

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002