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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011