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
Storage Layout
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.


MRSTOASP Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)         Description
 
  0   0  Structure  168  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
 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  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    168
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             A8      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_SCMSSCH         44      2

This information is based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001