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

Last updated on 11 Sept 2018 at 15:47:40.
Copyright IBM Corporation, 1990, 2018