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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005