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   68  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  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     68
    STOASS_CPVOLSER        14      6
    STOASS_END             44      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_RDEVSID         1C      4
    STOASS_SCGSSCH         40      4
    STOASS_SCMSSCH         3C      2

    This information is
    based on z/VM V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003