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
Storage Layout
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   64  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
 62  3E  Unsigned     2  *                   Reserved for IBM use
 64  40  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     64
STOASS_CPVOLSER        14      6
STOASS_END             40      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_SCMSSCH         3C      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