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

#### MRIODHPP

Prolog
Control Block Contents
Cross Reference

#### MRIODHPP Prolog

     DSECT NAME - IODHPP
     FUNCTION - This record indicates the alias use statistics of a
                HyperPAV pool
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODHPP
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 6 - I/O Domain
                        Record 28 - HyperPAV Pool activity
     DESCRIPTION - Indicates the alias use statistics 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 unique value in the system.  This value
         can be obtained from a Q PAV command executed against one
         of the devices in the pool.

#### MRIODHPP Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    72  IODHPP                 Start of monitor record
       0   0  Character     0  IODHPP_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  IODHPP_HPPOOLNM        HyperPAV Pool Number
      22  16  Unsigned      2  IODHPP_HPPTOKEN        HyperPAV Pool Token = SSID
      24  18  Unsigned      4  IODHPP_HPPNBASE        Number of base devices in
                                                      the HyperPAV pool.
      28  1C  Unsigned      4  IODHPP_HPPNALIS        Number of alias devices in
                                                      the HyperPAV pool.
      32  20  Unsigned      4  IODHPP_HPPTRIES        Number of times CP went to
                                                      the HyperPAV pool's free
                                                      queue to find an alias device
      36  24  Unsigned      4  IODHPP_HPPFAILS        Number of times CP went to
                                                      the HyperPAV pool's free
                                                      queue to find an alias device
                                                      but couldn't find one to use
      40  28  Unsigned      4  IODHPP_HPPMINCT        Lowest number of alias
                                                      devices in the HyperPAV
                                                      pool's free queue since the
                                                      last MRIODHPP record 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  IODHPP_HPPMAXCT        Highest number of alias
                                                      devices in the HyperPAV
                                                      pool's free queue since the
                                                      last MRIODHPP record was cut.
                                                      Note: a value of X'FFFFFFFF'
                                                      means CP has not tried to get
                                                      an alias from this pool since
                                                      the last MRIODHPP record was
                                                      cut.
      48  30  Unsigned      1  IODHPP_CALFLAG         Flag byte
              1... ....        IODHPP_CALPARTIAL       This is a partial record,
                                                      more MRIODHPP records follow.
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      49  31  Character     3  *                      Reserved for IBM use.
      52  34  Unsigned      4  IODHPP_CUISYSAL        The total number of
                                                      SYSTEM-attached aliases
                                                      defined in the HyperPAV pool.
      56  38  Unsigned      4  IODHPP_CALALL          The number of times
                                                      alias-usage and queue- depth
                                                      state of the logical control
                                                      unit was sampled.
      60  3C  Unsigned      4  IODHPP_CALUSECNT       Number of HyperPAV
                                                      alias-usage IODHPP_CALUSE
                                                      entries.
      64  40  Unsigned      2  IODHPP_CALUSESZ        The size (in bytes) of an
                                                      IODHPP_CALUSE entry.
      66  42  Unsigned      2  IODHPP_CALUSEDSP       The displacement (in bytes)
                                                      from the start of this record
                                                      to the first IODHPP_CALUSE
                                                      entry. The entries begin at
                                                      this offset and are
                                                      contiguous.
      68  44  Unsigned      4  *                      Reserved for IBM use.
      72  48  Character     0  IODHPP_CALUSES         Start of an array of
                                                      IODHPP_CALUSE entries. Each
                                                      entry describes the
                                                      alias-usage and queue-depth
                                                      statistics for a type of I/O
                                                      using aliases within this
                                                      HyperPAV pool.
    IODHPP_CALUSE entry for each type of I/O using aliases within this HyperPAV pool.

       0   0  Structure    56  IODHPP_CALUSE          Alias-usage and queue-depth
                                                      data.
       0   0  Character     8  IODHPP_CALUID          A character string
                                                      identifying the type of I/O.
       8   8  Unsigned      2  IODHPP_CALUSHR         The alias-share for this
                                                      type of I/O.
      10   A  Unsigned      2  *                      Reserved for IBM use.
      12   C  Unsigned      4  IODHPP_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  IODHPP_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  IODHPP_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  IODHPP_CALUQBC         Cumulative sum of the
                                                      samples of the number of I/Os
                                                      queued of this type of I/O.
      32  20  Character     8  IODHPP_CALUALC         Cumulative sum of the
                                                      samples of the number of
                                                      aliases in use for this type
                                                      of I/O.
      40  28  Character     8  IODHPP_CALUQB2         IODHPP_CALUQBC but sum of
                                                      squares instead
      48  30  Character     8  IODHPP_CALUAL2         IODHPP_CALUALC but sum of
                                                      squares instead

#### MRIODHPP Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODHPP                     0     72
    IODHPP_CALALL             38      4
    IODHPP_CALFLAG            30      1
    IODHPP_CALPARTIAL         30           80
    IODHPP_CALUALC            20      8
    IODHPP_CALUAL2            30      8
    IODHPP_CALUFND            14      4
    IODHPP_CALUID              0      8
    IODHPP_CALUQBC            18      8
    IODHPP_CALUQB2            28      8
    IODHPP_CALUSE              0     56
    IODHPP_CALUSECNT          3C      4
    IODHPP_CALUSEDSP          42      2
    IODHPP_CALUSES            48      0
    IODHPP_CALUSESZ           40      2
    IODHPP_CALUSHR             8      2
    IODHPP_CALUSRCH           10      4
    IODHPP_CALUSVD             C      4
    IODHPP_CUISYSAL           34      4
    IODHPP_HPPFAILS           24      4
    IODHPP_HPPMAXCT           2C      4
    IODHPP_HPPMINCT           28      4
    IODHPP_HPPNALIS           1C      4
    IODHPP_HPPNBASE           18      4
    IODHPP_HPPOOLNM           14      2
    IODHPP_HPPTOKEN           16      2
    IODHPP_HPPTRIES           20      4
    IODHPP_MRHDR               0      0
    MRHDR                      0     20
    MRHDR_END                 14      0
    MRHDRDM                    4      1
    MRHDRLEN                   0      2
    MRHDRRC                    6      2
    MRHDRTOD                   8      8
    MRHDRZER                   2      2

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

    Last updated on 09 August 2020 at 16:03:40.

    Copyright IBM Corporation, 1990, 2020