Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRPRCAPM

Prolog
Control 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