IBM 2 Computer Hardware User Manual


 
Key_Translate CCA Release 2.54
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
input_key_token
The input_key_token parameter is a pointer to a string variable containing an
external key-token. The external key-token contains the key to be
reenciphered (translated).
input_KEK_key_identifier
The input_KEK_key_identifier parameter is a pointer to a string variable
containing the internal key-token or the key label of an internal key-token
record in key storage. The internal key-token contains the key-encrypting key
used to decipher the key. The internal key-token must contain a control vector
that specifies an IMPORTER or IKEYXLAT key type. The control vector for an
IMPORTER key must have the XLATE bit set to one.
output_KEK_key_identifier
The output_KEK_key_identifier parameter is a pointer to a string variable
containing the internal key-token or the key label of an internal key-token
record in key storage. The internal key-token contains the key-encrypting key
used to encipher the key. The internal key-token must contain a control vector
that specifies an EXPORTER or OKEYXLAT key type. The control vector for
an EXPORTER key must have the XLATE bit set to one.
output_key_token
The output_key_token parameter is a pointer to a string variable containing an
external key-token. The external key-token contains the reenciphered key.
Required Commands
The Key_Translate verb requires the Translate Key command (offset X'001F') to
be enabled in the hardware.
5-70 IBM 4758 CCA Basic Services, Release 2.54, February 2005