|
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 *
32 20 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 and 7 APs. These are PCICC PCIXCC and CEX2C
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 and 7
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 APs. (CEX2A) This type of AP has 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
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 V5R2.0.
Last updated on 12 Dec 2005 at 09:55:03.
Copyright IBM Corporation, 1990, 2005