About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
|
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 V7R3.0.
Last updated on 09 September 2022 at 14:51:05.
Copyright IBM Corporation, 1990, 2022