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 V4R4.0.

    Last updated on 27 Jun 2005 at 15:00:23.

    Copyright IBM Corporation, 1990, 2003