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

MRSTOASP

Prolog
Control Block Contents
Cross Reference

MRSTOASP Prolog

 DSECT NAME - STOASP
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRSTOASP
 DESCRIPTIVE NAME - Monitor Sample Record
                    Domain 3 - Storage Domain
                    Record 4 - Auxiliary Storage Management
                               (per Exposure)
 DESCRIPTION - Information concerning paging and spooling space
               usage.  A separate record is generated for each
               hardware exposure associated with each volume.
 NOTES:
   - A volume may be CP owned or a mapped mini-disk volume that
     is not CP owned.  See STOASP_CALFLAG1.
   - Some CP volumes may be mapped minidisk volumes.
     See STOASP_CALFLAG1.
   - For volumes where multiple exposures exist on the same
     device, the fields whose names begin with STOASP_EXPxxxxx
     apply only to the exposure. All other fields in this
     record apply to the device.


MRSTOASP Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)             Description
 
  0   0  Structure  172  STOASP                 Start of monitor record
  0   0  Character    0  STOASP_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  STOASP_CALVSER         Device volume serial
                                                identifier. For CP volumes this
                                                will be the CPvol serial id.
                                                For mapped mini-disk that are
                                                not CP vols, this will be the
                                                dasd vol serial id. See
                                                STOASP_CALFLAG1.
 26  1A  Unsigned     2  STOASP_RDEVDEV         Device number.
 28  1C  Unsigned     4  STOASP_RDEVSID         host subchannel I.D. number
                                                defined at initialization
 32  20  Unsigned     4  STOASP_CALSPOOL        Total number of spool slots
                                                in use on this CPVOL. Not
                                                applicable (and set to zero) if
                                                device is a mapped mini-disk
                                                that is not a CP volume. See
                                                STOASP_CALFLAG1.
 36  24  Unsigned     4  STOASP_CALPAGE         Total number of page slots in
                                                use on this CPVOL. Not
                                                applicable (and set to zero) if
                                                device is a mapped mini-disk
                                                that is not a CP volume. See
                                                STOASP_CALFLAG1.
 40  28  Unsigned     4  STOASP_EXPCTSRD        Total number of spool reads
 44  2C  Unsigned     4  STOASP_EXPCTSWR        Total number of spool writes
 48  30  Unsigned     4  STOASP_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.
 52  34  Unsigned     4  STOASP_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.
 56  38  Unsigned     4  STOASP_EXPCURQC        The number of page/spool
                                                read/writes that are currently
                                                active or queued on this
                                                logical device
 60  3C  Unsigned     4  STOASP_EXPCTACP        The number of page/spool
                                                reads/writes that are added
                                                onto an executing channel
                                                program without executing a
                                                RSCH or SSCH
 64  40  Unsigned     4  STOASP_EXPCTUSI        Number of times user I/O
                                                interferes with paging and
                                                spooling I/O.
 68  44  Unsigned     2  STOASP_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').
 70  46  Bitstring    1  STOASP_CALFLAG1        Flagbyte
          1... ....      STOASP_CALNOCPV        OFF = device is a CP volume.
                                                ON = device is not a CP volume.
          .1.. ....      STOASP_CALMDISK        Device is a mapped mini-disk
                                                volume. Device is also a CP
                                                volume if STOASP_CALNOCPV =
                                                OFF.
          ..1. ....      STOASP_CPVLDUMP        Dump only volume
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 71  47  Bitstring    1  STOASP_RDEVDRAN        Drain information for the
                                                device. If RDEVDRAN=0, the
                                                device is not being drained.
                                                Otherwise, the bit settings
                                                indicate the ALOC type being
                                                drained. These values can be
                                                found in HCPALOC COPY. For
                                                example: ALOCPAGE(x'01) - Page
                                                ALOCSPOL(x'02) - Spool
                                                ALOCTDSK(x'20) - Tdisk
                                                ALOCPERM(x'08) - Links
 72  48  Unsigned     4  STOASP_EXPCONT(1:20)   Number of times a contiguous
                                                free space of corresponding
                                                number of slots was found
                                                available. Each index number
                                                from 1 to 19 corresponds to the
                                                number of slots found
                                                available. Example:
                                                STOASP_EXPCONT(8) = the number
                                                of times a contiguous free
                                                space of 8 slots was found
                                                available. For index number 20,
                                                this is the number of times a
                                                contiguous free space of 20 or
                                                more slots was found available.
152  98  Unsigned     4  STOASP_EXPDEVST        The service time for a paging
                                                device. This is the average
                                                time in millisecond that takes
                                                for this device to process a
                                                page I/O and it is computed by
                                                dividing the total amount of
                                                time in millisecond spend in
                                                I/O for the last group of I/O
                                                requests by the number of pages
                                                moved in that group of I/O
                                                requests.
156  9C  Unsigned     4  STOASP_EXPMLOAD        Modified Device Load (MLOAD).
                                                This is the product of the
                                                number of pages in the
                                                outstanding I/O requests on the
                                                device multiplied by the
                                                service time of the device.
                                                When the system needs to decide
                                                what paging device to use next,
                                                it picks a device whose MLOAD
                                                is smaller than the average
                                                system MLOAD.
160  A0  Unsigned     4  STOASP_CPVLOKAT        Count of times this volume
                                                was looked at while choosing a
                                                volume for allocation. This
                                                count is not incremented if the
                                                volume is full. Not applicable
                                                (and set to zero) if device is
                                                a mapped mini-disk that is not
                                                a CP volume. See
                                                STOASP_CALFLAG1.
164  A4  Unsigned     4  STOASP_CPVALOCD        Count of times this volume
                                                was chosen for allocation. Not
                                                applicable (and set to zero) if
                                                device is a mapped mini-disk
                                                that is not a CP volume. See
                                                STOASP_CALFLAG1.
168  A8  Unsigned     4  STOASP_SCGSSCH         Fullword cumulative count of
                                                SSCH and RSCH for this device.
                                                Available when format-1
                                                measurement blocks are being
                                                used (MTRSYS_CALFLG2 = x'80').
172  AC  Character    0  STOASP_END             

MRSTOASP 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
STOASP                     0    172
STOASP_CALFLAG1           46      1
STOASP_CALMDISK           46           40
STOASP_CALNOCPV           46           80
STOASP_CALPAGE            24      4
STOASP_CALSPOOL           20      4
STOASP_CALVSER            14      6
STOASP_CPVALOCD           A4      4
STOASP_CPVLDUMP           46           20
STOASP_CPVLOKAT           A0      4
STOASP_END                AC      0
STOASP_EXPCONT            48     80
STOASP_EXPCTACP           3C      4
STOASP_EXPCTPRD           30      4
STOASP_EXPCTPWR           34      4
STOASP_EXPCTSRD           28      4
STOASP_EXPCTSWR           2C      4
STOASP_EXPCTUSI           40      4
STOASP_EXPCURQC           38      4
STOASP_EXPDEVST           98      4
STOASP_EXPMLOAD           9C      4
STOASP_MRHDR               0      0
STOASP_RDEVDEV            1A      2
STOASP_RDEVDRAN           47      1
STOASP_RDEVSID            1C      4
STOASP_SCGSSCH            A8      4
STOASP_SCMSSCH            44      2

This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007