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. |
MRMTRHPP
PrologControl Block Contents
Cross Reference
MRMTRHPP Prolog
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 V7R2.0.
Last updated on 09 August 2020 at 15:17:09.
Copyright IBM Corporation, 1990, 2020