|
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 V6R4.0.
Last updated on 4 Oct 2016 at 15:14:09.
Copyright IBM Corporation, 1990, 2016