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 V5R2.0.

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005