Record Type 82 (52) — CUSP Record

Record type 82 is used to record information about the events and operations of the Cryptographic Unit Support Program (CUSP).

Record type 82 is written to the SMF data set at the completion of each of the following cryptography functions:

Initialization:
The record is written when the Cryptographic Unit Support Program is initialized, either when cryptography is started or as a part of the key generator utility program.
Start:
The record is written when a START command is issued for cryptography.
Stop:
The record is written when a STOP command is issued for cryptography.
Modify:
The record is written when a MODIFY command is issued for cryptography.
Unit check:
The record is written when the cryptographic unit is switched offline and then brought online again.
Generation of an operational key:
If specified in the installation options for cryptography, a record is written after processing each GENKEY macro instruction.
Transformation of an operational key:
If specified in the installation options for cryptography, a record is written after processing each RETKEY macro instruction.
Execution of the key generator utility:
The record is written after the execution of the key generator utility program, thus providing a record of changes to the cryptographic key data set (CKDS).

Record type 82 consists of a header section and six possible relocate sections. The header section identifies the RACF® user ID and group name or the job and step name of the non-RACF cryptography user, the cryptography function when the record describes, and the return code issued by the function. The header section is 45 bytes long.

The six possible variable relocate sections are:

Key generator utility, which indicates changes made by the utility to the host system master key, the local keys the cross keys, and the remote keys.
GENKEY function, which indicates the action taken in response to a GENKEY macro instruction.
RETKEY function, which indicates the action taken in response to a RETKEY macro instruction.
Cryptography initialization, which describes the SMF recording options in effect at initialization and the cryptography function and key manager user SVC numbers.
Installation data, which contains any information supplied by an installation exit routine.
Cryptographic unit data, which indicates the status of the cryptographic unit.

Note: The number of relocate sections depends on the type of action taken. For instance, the record written when the Cryptographic Unit Support Program stops consists only of the header section. The number of relocate sections is indicated in CRY82CVT (offset 41).

Macros to Symbolically Address Record Type 82: The SMF record mapping macros to symbolically address record type 82 are ICUSMF82 and ICUCRY82. ICUSMF82 maps the fields in record type 82 whose name starts with SMF. ICUCRY82 maps the fields in record type 82 whose name starts with CRY. The macros are supplied on SYS1.MACLIB.