Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODHPP
PrologControl 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 V6R4.0.
Last updated on 5 Dec 2016 at 13:14:40.
Copyright IBM Corporation, 1990, 2016