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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004