Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCAPM
PrologControl Block Contents
Cross Reference
MRPRCAPM Prolog
DSECT NAME - PRCAPM FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRPRCAPM DESCRIPTIVE NAME - Monitor Sample Record Domain 5 - Processor Domain Record 10 - Crypto performance measurement data DESCRIPTION - Provides counters and timers for transactions on the PCI crypto cards. One record is generated to include all of the information for the processor configuration. Each record contains a list of Crypto Measurement Blocks (CMBs) for each AP in the processor configuration. NOTES: - This record is generated only if PCI crypto cards are installed on the system.
MRPRCAPM Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 40 PRCAPM Start of monitor record 0 0 Character 0 PRCAPM_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 Character 4 * Reserved for IBM use
The store-crypto-measurement-data command-response block follows. The fixed-length data starts here.
Offsets Dec Hex Type Len Name (Dim) Description 24 18 Unsigned 2 PRCAPM_L2 Unsigned integer specifying the length in bytes of the command response block 26 1A Unsigned 2 PRCAPM_RC Unsigned integer specifying the response code from the store crypto-measurement-data command 28 1C Character 4 * Reserved/zeroes 32 20 Unsigned 4 * 1... .... PRCAPM_P P bit: when P=0, the entire response is returned, when P=1, a partial response is returned .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 33 21 Character 3 * Reserved/zeroes 36 24 Character 4 * Reserved/zeroes
The variable data contains a crypto-measurement-block (CMB) list which contains one or more CMBs. The length of the command response block including both the fixed-length data and the variable length data is specified by the PRCAPM_L2 field. The length of the variable data depends on the type of AP (determined by the PRCAPM_CT field in the CMB header) and the number of APs installed.
Offsets Dec Hex Type Len Name (Dim) Description 40 28 Character 0 PRCAPM_VAR_DATA Start of variable length data
CMB entry for types 3 5 7 and 9 APs. These are PCICC, PCIXCC, CEX2C, and CEX3C, respectively. These AP cryptos have just one crypto engine.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 64 PRCAPM_CMB1 0 0 Character 16 PRCAPM_CMB1HDR 0 0 Bitstring 1 * Reserved/zeroes 1 1 Bitstring 1 PRCAPM_CT Crypto type Valid values include: 3, 5, 7, and 9 2 2 Bitstring 1 * Reserved/zeroes 3 3 Bitstring 1 * 1... .... * .1.. .... * ..xx xxxx PRCAPM_AX AP index 4 4 Unsigned 4 PRCAPM_S 32-bit binary floating point value indicating the stepping interval, in seconds, of the timers 8 8 Unsigned 4 PRCAPM_V 32-bit mask indicating the validity of each timer-counter pair 12 C Unsigned 4 * Reserved/zeroes 16 10 Character 8 PRCAPM_CMB1_T0 64-bit unsigned integer timer value that measures the execution time of all operations on the AP 24 18 Character 8 PRCAPM_CMB1_C0 64-bit unsigned integer counter of the number of all operations on the AP 32 20 Character 8 PRCAPM_CMB1_T1 64-bit unsigned integer timer value that measures the execution time of RSA-key- generation operations on the AP 40 28 Character 8 PRCAPM_CMB1_C1 64-bit unsigned integer counter of the number of RSA- key-generation operations on the AP 48 30 Character 16 * Reserved/zeroes
CMB entry for type 4 APs. (PCICA) This type of AP has five crypto engines and data is reported separately for each engine.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 336 PRCAPM_CMB2 0 0 Character 16 PRCAPM_CMB2HDR 0 0 Bitstring 1 * Reserved/zeroes 1 1 Bitstring 1 PRCAPM_CT Crypto type Valid values include: 4 2 2 Bitstring 1 * Reserved/zeroes 3 3 Bitstring 1 * 1... .... * .1.. .... * ..xx xxxx PRCAPM_AX AP index 4 4 Unsigned 4 PRCAPM_S 32-bit binary floating point value indicating the stepping interval, in seconds, of the timers 8 8 Unsigned 4 PRCAPM_V 32-bit mask indicating the validity of each timer-counter pair 12 C Unsigned 4 * Reserved/zeroes
Timer-counter pairs for AP engine-0
Offsets Dec Hex Type Len Name (Dim) Description 16 10 Character 8 PRCAPM_CMB2_T0 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 1024-bit ME-format RSA operations 24 18 Character 8 PRCAPM_CMB2_C0 64-bit unsigned integer counter of the number of operations on AP engine-0 for 1024-bit ME-format RSA operations 32 20 Character 8 PRCAPM_CMB2_T1 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 2048-bit ME-format RSA operations 40 28 Character 8 PRCAPM_CMB2_C1 64-bit unsigned integer counter of the number of operations on AP engine-0 for 2048-bit ME-format RSA operations 48 30 Character 8 PRCAPM_CMB2_T2 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 1024-bit CRT-format RSA operations 56 38 Character 8 PRCAPM_CMB2_C2 64-bit unsigned integer counter of the number of operations on AP engine-0 for 1024-bit CRT-format RSA operations 64 40 Character 8 PRCAPM_CMB2_T3 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 2048-bit CRT-format RSA operations 72 48 Character 8 PRCAPM_CMB2_C3 64-bit unsigned integer counter of the number of operations on AP engine-0 for 2048-bit CRT-format RSA operations
Timer-counter pairs for AP engine-1
Offsets Dec Hex Type Len Name (Dim) Description 80 50 Character 8 PRCAPM_CMB2_T4 64-bit unsigned integer timer value that measures the execution time on AP engine-1 for 1024-bit ME-format RSA operations 88 58 Character 8 PRCAPM_CMB2_C4 64-bit unsigned integer counter of the number of operations on AP engine-1 for 1024-bit ME-format RSA operations 96 60 Character 8 PRCAPM_CMB2_T5 64-bit unsigned integer timer value that measures the execution time on AP engine-1 for 2048-bit ME-format RSA operations 104 68 Character 8 PRCAPM_CMB2_C5 64-bit unsigned integer counter of the number of operations on AP engine-1 for 2048-bit ME-format RSA operations 112 70 Character 8 PRCAPM_CMB2_T6 64-bit unsigned integer timer value that measures the execution time on AP engine-1 for 1024-bit CRT-format RSA operations 120 78 Character 8 PRCAPM_CMB2_C6 64-bit unsigned integer counter of the number of operations on AP engine-1 for 1024-bit CRT-format RSA operations 128 80 Character 8 PRCAPM_CMB2_T7 64-bit unsigned integer timer value that measures the execution time on AP engine-1 for 2048-bit CRT-format RSA operations 136 88 Character 8 PRCAPM_CMB2_C7 64-bit unsigned integer counter of the number of operations on AP engine-1 for 2048-bit CRT-format RSA operations
Timer-counter pairs for AP engine-2
Offsets Dec Hex Type Len Name (Dim) Description 144 90 Character 8 PRCAPM_CMB2_T8 64-bit unsigned integer timer value that measures the execution time on AP engine-2 for 1024-bit ME-format RSA operations 152 98 Character 8 PRCAPM_CMB2_C8 64-bit unsigned integer counter of the number of operations on AP engine-2 for 1024-bit ME-format RSA operations 160 A0 Character 8 PRCAPM_CMB2_T9 64-bit unsigned integer timer value that measures the execution time on AP engine-2 for 2048-bit ME-format RSA operations 168 A8 Character 8 PRCAPM_CMB2_C9 64-bit unsigned integer counter of the number of operations on AP engine-2 for 2048-bit ME-format RSA operations 176 B0 Character 8 PRCAPM_CMB2_T10 64-bit unsigned integer timer value that measures the execution time on AP engine-2 for 1024-bit CRT-format RSA operations 184 B8 Character 8 PRCAPM_CMB2_C10 64-bit unsigned integer counter of the number of operations on AP engine-2 for 1024-bit CRT-format RSA operations 192 C0 Character 8 PRCAPM_CMB2_T11 64-bit unsigned integer timer value that measures the execution time on AP engine-2 for 2048-bit CRT-format RSA operations 200 C8 Character 8 PRCAPM_CMB2_C11 64-bit unsigned integer counter of the number of operations on AP engine-2 for 2048-bit CRT-format RSA operations
Timer-counter pairs for AP engine-3
Offsets Dec Hex Type Len Name (Dim) Description 208 D0 Character 8 PRCAPM_CMB2_T12 64-bit unsigned integer timer value that measures the execution time on AP engine-3 for 1024-bit ME-format RSA operations 216 D8 Character 8 PRCAPM_CMB2_C12 64-bit unsigned integer counter of the number of operations on AP engine-3 for 1024-bit ME-format RSA operations 224 E0 Character 8 PRCAPM_CMB2_T13 64-bit unsigned integer timer value that measures the execution time on AP engine-3 for 2048-bit ME-format RSA operations 232 E8 Character 8 PRCAPM_CMB2_C13 64-bit unsigned integer counter of the number of operations on AP engine-3 for 2048-bit ME-format RSA operations 240 F0 Character 8 PRCAPM_CMB2_T14 64-bit unsigned integer timer value that measures the execution time on AP engine-3 for 1024-bit CRT-format RSA operations 248 F8 Character 8 PRCAPM_CMB2_C14 64-bit unsigned integer counter of the number of operations on AP engine-3 for 1024-bit CRT-format RSA operations 256 100 Character 8 PRCAPM_CMB2_T15 64-bit unsigned integer timer value that measures the execution time on AP engine-3 for 2048-bit CRT-format RSA operations 264 108 Character 8 PRCAPM_CMB2_C15 64-bit unsigned integer counter of the number of operations on AP engine-3 for 2048-bit CRT-format RSA operations
Timer-counter pairs for AP engine-4
Offsets Dec Hex Type Len Name (Dim) Description 272 110 Character 8 PRCAPM_CMB2_T16 64-bit unsigned integer timer value that measures the execution time on AP engine-4 for 1024-bit ME-format RSA operations 280 118 Character 8 PRCAPM_CMB2_C16 64-bit unsigned integer counter of the number of operations on AP engine-4 for 1024-bit ME-format RSA operations 288 120 Character 8 PRCAPM_CMB2_T17 64-bit unsigned integer timer value that measures the execution time on AP engine-4 for 2048-bit ME-format RSA operations 296 128 Character 8 PRCAPM_CMB2_C17 64-bit unsigned integer counter of the number of operations on AP engine-4 for 2048-bit ME-format RSA operations 304 130 Character 8 PRCAPM_CMB2_T18 64-bit unsigned integer timer value that measures the execution time on AP engine-4 for 1024-bit CRT-format RSA operations 312 138 Character 8 PRCAPM_CMB2_C18 64-bit unsigned integer counter of the number of operations on AP engine-4 for 1024-bit CRT-format RSA operations 320 140 Character 8 PRCAPM_CMB2_T19 64-bit unsigned integer timer value that measures the execution time on AP engine-4 for 2048-bit CRT-format RSA operations 328 148 Character 8 PRCAPM_CMB2_C19 64-bit unsigned integer counter of the number of operations on AP engine-4 for 2048-bit CRT-format RSA operations
CMB entry for type 6 and 8 APs. These are CEX2A and CEX3A, respectively. These AP cryptos have just one crypto engine, but the data reported is the same as for type 4 engine 0.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 80 PRCAPM_CMB3 0 0 Character 16 PRCAPM_CMB3HDR 0 0 Bitstring 1 * Reserved/zeroes 1 1 Bitstring 1 PRCAPM_CT Crypto type Valid values include: 6 and 8 2 2 Bitstring 1 * Reserved/zeroes 3 3 Bitstring 1 * 1... .... * .1.. .... * ..xx xxxx PRCAPM_AX AP index 4 4 Unsigned 4 PRCAPM_S 32-bit binary floating point value indicating the stepping interval, in seconds, of the timers 8 8 Unsigned 4 PRCAPM_V 32-bit mask indicating the validity of each timer-counter pair 12 C Unsigned 4 * Reserved/zeroes
Timer-counter pairs for crypto engine-0
Offsets Dec Hex Type Len Name (Dim) Description 16 10 Character 8 PRCAPM_CMB3_T0 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 1024-bit ME-format RSA operations 24 18 Character 8 PRCAPM_CMB3_C0 64-bit unsigned integer counter of the number of operations on AP engine-0 for 1024-bit ME-format RSA operations 32 20 Character 8 PRCAPM_CMB3_T1 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 2048-bit ME-format RSA operations 40 28 Character 8 PRCAPM_CMB3_C1 64-bit unsigned integer counter of the number of operations on AP engine-0 for 2048-bit ME-format RSA operations 48 30 Character 8 PRCAPM_CMB3_T2 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 1024-bit CRT-format RSA operations 56 38 Character 8 PRCAPM_CMB3_C2 64-bit unsigned integer counter of the number of operations on AP engine-0 for 1024-bit CRT-format RSA operations 64 40 Character 8 PRCAPM_CMB3_T3 64-bit unsigned integer timer value that measures the execution time on AP engine-0 for 2048-bit CRT-format RSA operations 72 48 Character 8 PRCAPM_CMB3_C3 64-bit unsigned integer counter of the number of operations on AP engine-0 for 2048-bit CRT-format RSA operations
MRPRCAPM 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 PRCAPM 0 40 PRCAPM_AX 1 1 PRCAPM_CMBHDR 0 16 PRCAPM_CMB1 0 64 PRCAPM_CMB1_C0 18 8 PRCAPM_CMB1_C1 28 8 PRCAPM_CMB1_T0 10 8 PRCAPM_CMB1_T1 20 8 PRCAPM_CMB1HDR 0 16 PRCAPM_CMB2 0 336 PRCAPM_CMB2_C0 18 8 PRCAPM_CMB2_C1 28 8 PRCAPM_CMB2_C10 B8 8 PRCAPM_CMB2_C11 C8 8 PRCAPM_CMB2_C12 D8 8 PRCAPM_CMB2_C13 E8 8 PRCAPM_CMB2_C14 F8 8 PRCAPM_CMB2_C15 108 8 PRCAPM_CMB2_C16 118 8 PRCAPM_CMB2_C17 128 8 PRCAPM_CMB2_C18 138 8 PRCAPM_CMB2_C19 148 8 PRCAPM_CMB2_C2 38 8 PRCAPM_CMB2_C3 48 8 PRCAPM_CMB2_C4 58 8 PRCAPM_CMB2_C5 68 8 PRCAPM_CMB2_C6 78 8 PRCAPM_CMB2_C7 88 8 PRCAPM_CMB2_C8 98 8 PRCAPM_CMB2_C9 A8 8 PRCAPM_CMB2_T0 10 8 PRCAPM_CMB2_T1 20 8 PRCAPM_CMB2_T10 B0 8 PRCAPM_CMB2_T11 C0 8 PRCAPM_CMB2_T12 D0 8 PRCAPM_CMB2_T13 E0 8 PRCAPM_CMB2_T14 F0 8 PRCAPM_CMB2_T15 100 8 PRCAPM_CMB2_T16 110 8 PRCAPM_CMB2_T17 120 8 PRCAPM_CMB2_T18 130 8 PRCAPM_CMB2_T19 140 8 PRCAPM_CMB2_T2 30 8 PRCAPM_CMB2_T3 40 8 PRCAPM_CMB2_T4 50 8 PRCAPM_CMB2_T5 60 8 PRCAPM_CMB2_T6 70 8 PRCAPM_CMB2_T7 80 8 PRCAPM_CMB2_T8 90 8 PRCAPM_CMB2_T9 A0 8 PRCAPM_CMB2HDR 0 16 PRCAPM_CMB3 0 80 PRCAPM_CMB3_C0 18 8 PRCAPM_CMB3_C1 28 8 PRCAPM_CMB3_C2 38 8 PRCAPM_CMB3_C3 48 8 PRCAPM_CMB3_T0 10 8 PRCAPM_CMB3_T1 20 8 PRCAPM_CMB3_T2 30 8 PRCAPM_CMB3_T3 40 8 PRCAPM_CMB3HDR 0 16 PRCAPM_CT 1 1 PRCAPM_L2 18 2 PRCAPM_MRHDR 0 0 PRCAPM_P 1A 80 PRCAPM_RC 1A 2 PRCAPM_S 4 4 PRCAPM_V 8 4 PRCAPM_VAR_DATA 28 0
This information is based on z/VM V5R3.0.
Last updated on 23 Nov 2009 at 15:19:23.
Copyright IBM Corporation, 1990, 2009