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

#### MRMTRHPP

Prolog
Control Block Contents
Cross Reference

#### MRMTRHPP Prolog

     DSECT NAME - MTRHPP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     Referenced Control Blocks -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRHPP
     DESCRIPTIVE NAME - Monitor Sample Configuration Record
                        Domain 1  - Monitor Domain
                        Record 20 - HyperPAV Pool definition
     DESCRIPTION - Indicates the number and associated SSID of a HyperPAV
                   Pool.
     NOTES:
         The HyperPAV Pool Token is the Subsystem ID (SSID) of the
         logical control unit that all of the devices in the pool are
         associated.  The SSID is a unique value that distinguishes
         it from all other control units in a configuration.
         This value can be obtained from a Q DASD DETAILS command
         executed against one of the device's on the control unit.
         The HyperPAV Pool number is a value that indicates which
         devices (bases/aliases) can be used together in a HyperPAV
         environment.  This value is generated by CP using the SSID
         to ensure that it is a unique value in the system.  This value
         can be obtained from a Q PAV command executed against one
         of the devices in the pool.

         A MTRHPP_CALUSE entry is completed for each type of I/O for which
         HyperPAV aliases are used. The MTRHPP_CALUID defines the I/O type
         and may contain the following:

           - 'MDISK   '
           - 'PAGING  '

#### MRMTRHPP Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    72+ MTRHPP                 Start of monitor record
       0   0  Character     0  MTRHPP_MRHDR           Record header. See MRRECHDR
                                                      for details.
       0   0  Character    20  MRHDR
       0   0  Unsigned      2  MRHDRLEN
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      20  14  Unsigned      2  MTRHPP_HPPOOLNM        HyperPAV Pool Number
      22  16  Unsigned      2  MTRHPP_HPPTOKEN        HyperPAV Pool Token = SSID
      24  18  Unsigned      4  MTRHPP_HPPNBASE        Cardinal count of base
                                                      devices in the HyperPAV
                                                      pool.
      28  1C  Unsigned      4  MTRHPP_HPPNALIS        Cardinal count of alias
                                                      devices in the HyperPAV
                                                      pool.
      32  20  Unsigned      4  MTRHPP_HPPTRIES        Cumulative count of times
                                                      CP went to the HyperPAV
                                                      pool's free queue to
                                                      find an alias.
      36  24  Unsigned      4  MTRHPP_HPPFAILS        Cumulative count of times
                                                      CP went to the HyperPAV
                                                      pool's free queue to
                                                      find an alias but couldn't
                                                      find one to use.
      40  28  Unsigned      4  MTRHPP_HPPMINCT        Lowest number of alias
                                                      devices in the HyperPAV
                                                      pool's free queue since
                                                      the last time monitor
                                                      sample record MRIODHPP
                                                      was cut.
                                                      NOTE: A value of X'7FFFFFFF'
                                                      means CP has not tried
                                                      to get an alias from this
                                                      pool since the last
                                                      MRIODHPP record was cut.
      44  2C  Unsigned      4  MTRHPP_HPPMAXCT        Highest number of alias
                                                      devices in the HyperPAV
                                                      pool's free queue since
                                                      the last time monitor
                                                      sample record MRIODHPP
                                                      was cut.
                                                      NOTE: A value of X'7FFFFFFF'
                                                      means CP has not tried
                                                      to get an alias from this
                                                      pool since the last
                                                      MRIODHPP record was cut.
      48  30  Bitstring     1  MTRHPP_CALFLAG         Flag byte
              1... ....        MTRHPP_CALPARTIAL      This is a partial
                                                      record, more MRMTRHPP
                                                      records follow.
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      49  31  Character     3  *                      Reserved for IBM use.
      52  34  Unsigned      4  MTRHPP_CUISYSAL        The total number of
                                                      SYSTEM-attached aliases
                                                      defined in the HyperPAV
                                                      pool.
      56  38  Unsigned      4  MTRHPP_CALALL          The number of times
                                                      alias-usage and
                                                      queue-depth state of the
                                                      logical control unit
                                                      was sampled.
      60  3C  Unsigned      4  MTRHPP_CALUSECNT       Number of HyperPAV
                                                      alias-usage MTRHPP_CALUSE
                                                      entries.
      64  40  Unsigned      2  MTRHPP_CALUSESZ        The size (in bytes) of
                                                      an MTRHPP_CALUSE entry.
      66  42  Unsigned      2  MTRHPP_CALUSEDSP       This is the displacement
                                                      (in bytes) from the start
                                                      of this record to the
                                                      first MTRHPP_CALUSE entry.
                                                      The entries begin at this
                                                      offset and are contiguous.
      68  44  Unsigned      4  *                      Reserved for IBM use.
      72  48  Character     0  MTRHPP_CALUSES         Start of an array of
                                                      MTRHPP_CALUSE entries.
                                                      Each entry describes the
                                                      alias-usage and
                                                      queue-depth statistics
                                                      for a type of I/O using
                                                      aliases within this
                                                      HyperPAV pool.

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Character    56  MTRHPP_CALUSE          Alias-usage and
                                                      queue-depth data
       0   0  Character     8  MTRHPP_CALUID          A character string
                                                      identifying the type of
                                                      I/O.
       8   8  Unsigned      2  MTRHPP_CALUSHR         The alias-share for this
                                                      type of I/O.
      10   A  Unsigned      2  *                      Reserved for IBM use.
      12   C  Unsigned      4  MTRHPP_CALUSVD         Cumulative count of the
                                                      number of times this type
                                                      of I/O was using fewer
                                                      aliases than its
                                                      entitlement and this type
                                                      of I/O had at least one
                                                      I/O queued.
      16  10  Unsigned      4  MTRHPP_CALUSRCH        Cumulative count of the
                                                      number of times the free
                                                      alias pool was empty, an
                                                      alias became available, and
                                                      CP wanted to give the alias
                                                      to an I/O of this type so as
                                                      to fulfill entitlement.
      20  14  Unsigned      4  MTRHPP_CALUFND         Cumulative count of the
                                                      number of times the free
                                                      alias pool was empty, an
                                                      alias became available, and
                                                      CP was able to give the alias
                                                      to an I/O of this type so as
                                                      to fulfill entitlement.
      24  18  Character     8  MTRHPP_CALUQBC         Cumulative sum of the
                                                      samples of the number of
                                                      I/Os queued of this type
                                                      of I/O.
      32  20  Character     8  MTRHPP_CALUALC         Cumulative sum of the
                                                      samples of the number of
                                                      aliases in use for this
                                                      type of I/O.
      40  28  Character     8  MTRHPP_CALUQB2         MTRHPP_CALUQBC but
                                                      sum of squares instead
      48  30  Character     8  MTRHPP_CALUAL2         MTRHPP_CALUALC but
                                                      sum of squares instead

#### MRMTRHPP 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
    MTRHPP                     0     72+
    MTRHPP_CALALL             38      4
    MTRHPP_CALFLAG            30      1
    MTRHPP_CALPARTIAL         30          80
    MTRHPP_CALUALC            20      8
    MTRHPP_CALUAL2            30      8
    MTRHPP_CALUFND            14      4
    MTRHPP_CALUID              0      8
    MTRHPP_CALUQBC            18      8
    MTRHPP_CALUQB2            28      8
    MTRHPP_CALUSE              0      56
    MTRHPP_CALUSECNT          3C      4
    MTRHPP_CALUSEDSP          42      2
    MTRHPP_CALUSES            48      0
    MTRHPP_CALUSESZ           40      2
    MTRHPP_CALUSHR             8      2
    MTRHPP_CALUSRCH           10      4
    MTRHPP_CALUSVD             C      4
    MTRHPP_CUISYSAL           34      4
    MTRHPP_HPPFAILS           24      4
    MTRHPP_HPPMAXCT           2C      4
    MTRHPP_HPPMINCT           28      4
    MTRHPP_HPPNALIS           1C      4
    MTRHPP_HPPNBASE           18      4
    MTRHPP_HPPOOLNM           14      2
    MTRHPP_HPPTOKEN           16      2
    MTRHPP_HPPTRIES           20      4
    MTRHPP_MRHDR               0      0

    This information is
    based on z/VM V7R2.0.

    Last updated on 09 August 2020 at 15:17:09.

    Copyright IBM Corporation, 1990, 2020