Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
DSECT NAME - MTRHPP FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area Referenced Control Blocks - MRRECHDR Monitor Record Header NAME - MRMTRHPP DESCRIPTIVE NAME - Monitor Sample Configuration Record Domain 1 - Monitor Domain Record 20 - HyperPAV Pool definition DESCRIPTION - Indicates the number and associated SSID 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 a unique value in the system. This value can be obtained from a Q PAV command executed against one of the devices in the pool. A MTRHPP_CALUSE entry is completed for each type of I/O for which HyperPAV aliases are used. The MTRHPP_CALUID defines the I/O type and may contain the following: - 'MDISK ' - 'PAGING '
MRMTRHPP Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 72+ MTRHPP Start of monitor record 0 0 Character 0 MTRHPP_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 MTRHPP_HPPOOLNM HyperPAV Pool Number 22 16 Unsigned 2 MTRHPP_HPPTOKEN HyperPAV Pool Token = SSID 24 18 Unsigned 4 MTRHPP_HPPNBASE Cardinal count of base devices in the HyperPAV pool. 28 1C Unsigned 4 MTRHPP_HPPNALIS Cardinal count of alias devices in the HyperPAV pool. 32 20 Unsigned 4 MTRHPP_HPPTRIES Cumulative count of times CP went to the HyperPAV pool's free queue to find an alias. 36 24 Unsigned 4 MTRHPP_HPPFAILS Cumulative count of times CP went to the HyperPAV pool's free queue to find an alias but couldn't find one to use. 40 28 Unsigned 4 MTRHPP_HPPMINCT Lowest number of alias devices in the HyperPAV pool's free queue since the last time monitor sample record MRIODHPP 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 MTRHPP_HPPMAXCT Highest number of alias devices in the HyperPAV pool's free queue since the last time monitor sample record MRIODHPP 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. 48 30 Bitstring 1 MTRHPP_CALFLAG Flag byte 1... .... MTRHPP_CALPARTIAL This is a partial record, more MRMTRHPP records follow. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 49 31 Character 3 * Reserved for IBM use. 52 34 Unsigned 4 MTRHPP_CUISYSAL The total number of SYSTEM-attached aliases defined in the HyperPAV pool. 56 38 Unsigned 4 MTRHPP_CALALL The number of times alias-usage and queue-depth state of the logical control unit was sampled. 60 3C Unsigned 4 MTRHPP_CALUSECNT Number of HyperPAV alias-usage MTRHPP_CALUSE entries. 64 40 Unsigned 2 MTRHPP_CALUSESZ The size (in bytes) of an MTRHPP_CALUSE entry. 66 42 Unsigned 2 MTRHPP_CALUSEDSP This is the displacement (in bytes) from the start of this record to the first MTRHPP_CALUSE entry. The entries begin at this offset and are contiguous. 68 44 Unsigned 4 * Reserved for IBM use. 72 48 Character 0 MTRHPP_CALUSES Start of an array of MTRHPP_CALUSE entries. Each entry describes the alias-usage and queue-depth statistics for a type of I/O using aliases within this HyperPAV pool.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Character 56 MTRHPP_CALUSE Alias-usage and queue-depth data 0 0 Character 8 MTRHPP_CALUID A character string identifying the type of I/O. 8 8 Unsigned 2 MTRHPP_CALUSHR The alias-share for this type of I/O. 10 A Unsigned 2 * Reserved for IBM use. 12 C Unsigned 4 MTRHPP_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 MTRHPP_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 MTRHPP_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 MTRHPP_CALUQBC Cumulative sum of the samples of the number of I/Os queued of this type of I/O. 32 20 Character 8 MTRHPP_CALUALC Cumulative sum of the samples of the number of aliases in use for this type of I/O. 40 28 Character 8 MTRHPP_CALUQB2 MTRHPP_CALUQBC but sum of squares instead 48 30 Character 8 MTRHPP_CALUAL2 MTRHPP_CALUALC but sum of squares instead
MRMTRHPP Cross Reference
Hex Hex Name Offset Length Value MRHDR 0 20 MRHDR_END 14 0 MRHDRDM 4 1 MRHDRLEN 0 2 MRHDRRC 6 2 MRHDRTOD 8 8 MRHDRZER 2 2 MTRHPP 0 72+ MTRHPP_CALALL 38 4 MTRHPP_CALFLAG 30 1 MTRHPP_CALPARTIAL 30 80 MTRHPP_CALUALC 20 8 MTRHPP_CALUAL2 30 8 MTRHPP_CALUFND 14 4 MTRHPP_CALUID 0 8 MTRHPP_CALUQBC 18 8 MTRHPP_CALUQB2 28 8 MTRHPP_CALUSE 0 56 MTRHPP_CALUSECNT 3C 4 MTRHPP_CALUSEDSP 42 2 MTRHPP_CALUSES 48 0 MTRHPP_CALUSESZ 40 2 MTRHPP_CALUSHR 8 2 MTRHPP_CALUSRCH 10 4 MTRHPP_CALUSVD C 4 MTRHPP_CUISYSAL 34 4 MTRHPP_HPPFAILS 24 4 MTRHPP_HPPMAXCT 2C 4 MTRHPP_HPPMINCT 28 4 MTRHPP_HPPNALIS 1C 4 MTRHPP_HPPNBASE 18 4 MTRHPP_HPPOOLNM 14 2 MTRHPP_HPPTOKEN 16 2 MTRHPP_HPPTRIES 20 4 MTRHPP_MRHDR 0 0
This information is based on z/VM V6R4.0.
Last updated on 4 Oct 2016 at 15:14:09.
Copyright IBM Corporation, 1990, 2016