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   48  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               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  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  Character    0  IODHPP_END

    MRIODHPP Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    IODHPP                     0     48
    IODHPP_END                30      0
    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 V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009