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