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   228  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         Deprecated: Use
                                                      STOASP_CALPAGEG. 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. If the value is
                                                      too large to fit in this
                                                      32-bit field, then set to
                                                      x'FFFFFFFF'. See
                                                      STOASP_CALFLAG1.
      40  28  Unsigned      4  STOASP_EXPCTSRD        Total number of pages read
                                                      from spool.
      44  2C  Unsigned      4  STOASP_EXPCTSWR        Total number of pages
                                                      written to spool.
      48  30  Unsigned      4  STOASP_EXPCTPRD        Total number of (non-spool)
                                                      pages read from 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 (non-spool)
                                                      pages written to 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  Character     4  *                      Reserved for IBM use.
                                                      Previous field is no longer
                                                      meaningful. (STOASP_EXPCTACP)
      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        Volume response time for a
                                                      paging device. This is the
                                                      average time in units of 16
                                                      microseconds that it takes
                                                      for this device to process a
                                                      page. It is computed by
                                                      dividing the total amount of
                                                      time spent for the last group
                                                      of I/O requests by the the
                                                      number of pages moved in that
                                                      group. When STOASP_PHDHXPBK
                                                      is OFF, time is measured
                                                      starting from issuance of a
                                                      RSCH (or when the request is
                                                      handed to CP's I/O Subsystem
                                                      when a SSCH is to be done) up
                                                      until the interrupt
                                                      presentation back to the
                                                      paging subsystem. When
                                                      STOASP_PHDHXPBK is ON, time
                                                      is always measured starting
                                                      when the request is handed to
                                                      CP's I/O subsystem (an SSCH
                                                      is always done) up until the
                                                      interrupt presentation back
                                                      to the paging subsystem. In
                                                      this case HyperPAV alias
                                                      selection may also be done.
                                                      Whenever a SSCH is done, the
                                                      time may include queuing off
                                                      the RDEV.
     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.
                                                      The service time of the
                                                      device is in units of 16
                                                      microseconds.
     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  Bitstring     1  STOASP_PHDTYPEF        I/O protocol flags
              1... ....        STOASP_PHDHXPBK         The exposure block for
                                                      this device is an HXPBK. When
                                                      this bit is ON, the paging
                                                      subsystem exploits HyperPAV
                                                      and HPF when those features
                                                      are enabled and supported by
                                                      the device. When this bit is
                                                      OFF, the exposure block is an
                                                      EXPBK.
              .1.. ....        STOASP_PHDECKD          ECKD paging volume.
              ..1. ....        STOASP_PHDSCSI          SCSI paging volume.
              ...1 ....        STOASP_PHDFBA           FBA paging volume.
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     173  AD  Unsigned      3  *                      Reserved for IBM use.
     176  B0  Unsigned      4  STOASP_CALCURQS        Current number of pages
                                                      queued on the paging exposure
                                                      block originating from either
                                                      a single-page read or a
                                                      single-page write request.
     180  B4  Unsigned      4  STOASP_CALCURQMW       Current number of pages
                                                      queued on the paging exposure
                                                      block originating from a
                                                      multi-page write request.
     184  B8  Unsigned      4  STOASP_CALCURQMR       Current number of pages
                                                      queued on the paging exposure
                                                      block originating from a
                                                      multi-page read request.
     188  BC  Unsigned      4  STOASP_HXPIORAC        Current number of paging
                                                      subsystem IORBKs handed off
                                                      to the I/O subsystem. This
                                                      includes IORBKs active on the
                                                      base and aliases, and any
                                                      queued off the RDEV of the
                                                      base.
     192  C0  Unsigned      4  STOASP_HXPPAIOC        Cumulative count of times
                                                      the paging subsystem's
                                                      channel program build routine
                                                      (HCPPAIIO) was stacked.
     196  C4  Unsigned      4  STOASP_CALSSCHAL       Cumulative count of SSCHs
                                                      issued on HyperPAV alias
                                                      devices for this base device.
     200  C8  Unsigned      1  STOASP_HXPFLAGC        Capability flags.
              1... ....        STOASP_HXPHPAV          The last I/O to this
                                                      volume requested alias use.
                                                      HyperPAV is enabled and the
                                                      device is a HyperPAV base.
                                                      The I/O subsystem will
                                                      determine if the I/O is
                                                      executed via an alias.
              .1.. ....        STOASP_HXPHPF           The last I/O to this
                                                      volume was a transport mode
                                                      channel program. HPF is
                                                      enabled and the device is HPF
                                                      capable.
              ..1. ....        STOASP_HXPFCMD          The last I/O to this
                                                      volume was a command mode
                                                      channel program because it
                                                      was directed to a mapped
                                                      minidisk or was a retry from
                                                      an HPF error.
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     201  C9  Unsigned      1  STOASP_HXPNOHPF        HPF failure flags. Usage of
                                                      HPF has been suspended.
              1... ....        STOASP_HXPNPROG         An error other than
                                                      missing HPF feature has
                                                      occurred.
              .1.. ....        STOASP_HXPNFEAT         An HPF feature is no
                                                      longer available.
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     202  CA  Unsigned      1  STOASP_HXPRTYFT        Retry count for HPF feature
                                                      lost.
     203  CB  Unsigned      1  STOASP_HXPRTYOT        Retry count for failure
                                                      other than HPF feature lost.
     204  CC  Unsigned      4  STOASP_PHDSSCHR        Cumulative count of SSCHs
                                                      (and RSCHs when
                                                      STOASP_PHDHXPBK is OFF) for
                                                      read.
     208  D0  Unsigned      4  STOASP_PHDSSCHW        Cumulative count of SSCHs
                                                      (and RSCHs when
                                                      STOASP_PHDHXPBK is OFF) for
                                                      write.
     212  D4  Unsigned      4  STOASP_PHDLOCRR        Cumulative count of Locate
                                                      Record operations for read
                                                      (includes the initial search
                                                      even when the information is
                                                      provided by a Prefix CCW).
     216  D8  Unsigned      4  STOASP_PHDLOCRW        Cumulative count of Locate
                                                      Record operations for write
                                                      (includes the initial search
                                                      even when the information is
                                                      provided by a Prefix CCW).
     220  DC  Unsigned      8  STOASP_CALPAGEG        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.
     220  DC  Unsigned      4  STOASP_CALPAGEG_HI
     224  E0  Unsigned      4  STOASP_CALPAGEG_LO
     228  E4  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    228
    STOASP_CALCURQMR          B8      4
    STOASP_CALCURQMW          B4      4
    STOASP_CALCURQS           B0      4
    STOASP_CALFLAG1           46      1
    STOASP_CALMDISK           46           40
    STOASP_CALNOCPV           46           80
    STOASP_CALPAGE            24      4
    STOASP_CALPAGEG           DC      8
    STOASP_CALPAGEG_HI        DC      4
    STOASP_CALPAGEG_LO        E0      4
    STOASP_CALSPOOL           20      4
    STOASP_CALSSCHAL          C4      4
    STOASP_CALVSER            14      6
    STOASP_CPVALOCD           A4      4
    STOASP_CPVLDUMP           46           20
    STOASP_CPVLOKAT           A0      4
    STOASP_END                E4      0
    STOASP_EXPCONT            48     80
    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_HXPFCMD            C8           20
    STOASP_HXPFLAGC           C8      1
    STOASP_HXPHPAV            C8           80
    STOASP_HXPHPF             C8           40
    STOASP_HXPIORAC           BC      4
    STOASP_HXPNFEAT           C9           40
    STOASP_HXPNOHPF           C9      1
    STOASP_HXPNPROG           C9           80
    STOASP_HXPPAIOC           C0      4
    STOASP_HXPRTYFT           CA      1
    STOASP_HXPRTYOT           CB      1
    STOASP_MRHDR               0      0
    STOASP_PHDECKD            AC           40
    STOASP_PHDFBA             AC           10
    STOASP_PHDHXPBK           AC           80
    STOASP_PHDLOCRR           D4      4
    STOASP_PHDLOCRW           D8      4
    STOASP_PHDSCSI            AC           20
    STOASP_PHDSSCHR           CC      4
    STOASP_PHDSSCHW           D0      4
    STOASP_PHDTYPEF           AC      1
    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 V7R2.0.

    Last updated on 08 August 2020 at 21:30:54.

    Copyright IBM Corporation, 1990, 2020