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. |
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
