Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRSTOASS

Prolog
Control Block Contents
Cross Reference

#### MRSTOASS Prolog

####

####

     DSECT NAME - STOASS
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOASS
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3 - Storage Domain
                        Record 11 - Auxiliary Shared Storage Management
                                   (per Exposure)
     DESCRIPTION - Describes shared device space usage.  A separate
                   record is generated for each hardware exposure
                   associated with each CP-owned shared volume.
                   Note: This record will not contain paging and
                   spooling allocation.  This information is recorded
                   only on the system owning the device.

    MRSTOASS Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   72  STOASS                 Start of monitor record
      0   0  Character    0  STOASS_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    6  STOASS_CPVOLSER        VOLUME serial identifier
     26  1A  Character    2  *                      Reserved for IBM use
     28  1C  Unsigned     4  STOASS_RDEVSID         host subchannel I.D. number
                                                    defined at initialization
     32  20  Unsigned     4  STOASS_EXPCTSRD        Total number of spool reads
     36  24  Unsigned     4  STOASS_EXPCTSWR        Total number of spool writes
     40  28  Unsigned     4  STOASS_EXPCTPRD        Total number of page read
                                                    operations for this device.
                                                    Note that page read operations
                                                    may be directed to devices
                                                    without any cylinders
                                                    specifically defined as type
                                                    PAGE.
     44  2C  Unsigned     4  STOASS_EXPCTPWR        Total number of page write
                                                    operations for this device.
                                                    Note that page write operations
                                                    may be directed to devices
                                                    without any cylinders
                                                    specifically defined as type
                                                    PAGE.
     48  30  Unsigned     4  STOASS_EXPCURQC        The number of page/spool
                                                    read/writes that are currently
                                                    active or queued on this
                                                    logical device
     52  34  Unsigned     4  STOASS_EXPCTACP        The number of page/spool
                                                    reads/writes that are added
                                                    onto an executing channel
                                                    program without executing a
                                                    RSCH or SSCH
     56  38  Unsigned     4  STOASS_EXPCTUSI        Number of times user I/O
                                                    interferes with paging and
                                                    spooling I/O.
     60  3C  Unsigned     2  STOASS_SCMSSCH         Cumulative count of SSCH and
                                                    RSCH for this device. This
                                                    value may be wrapped when
                                                    format-1 measurement blocks are
                                                    being used (MTRSYS_CALFLG2 <>
                                                    x'80').
     62  3E  Unsigned     2  *                      Reserved for IBM use
     64  40  Unsigned     4  STOASS_SCGSSCH         Fullword cumulative count of
                                                    SSCH and RSCH for this device.
                                                    Available when format-1
                                                    measurement blocks are being
                                                    used (MTRSYS_CALFLG2 = x'80').
     68  44  Unsigned     2  STOASS_RDEVDEV         Device number
     70  46  Unsigned     2  *                      Reserved and available for
                                                    IBM use.
     72  48  Character    0  STOASS_END

    MRSTOASS 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
    STOASS                     0     72
    STOASS_CPVOLSER           14      6
    STOASS_END                48      0
    STOASS_EXPCTACP           34      4
    STOASS_EXPCTPRD           28      4
    STOASS_EXPCTPWR           2C      4
    STOASS_EXPCTSRD           20      4
    STOASS_EXPCTSWR           24      4
    STOASS_EXPCTUSI           38      4
    STOASS_EXPCURQC           30      4
    STOASS_MRHDR               0      0
    STOASS_RDEVDEV            44      2
    STOASS_RDEVSID            1C      4
    STOASS_SCGSSCH            40      4
    STOASS_SCMSSCH            3C      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