IBM 2 Computer Hardware User Manual


 
Control_Vector_Translate CCA Release 2.54
Control_Vector_Translate (CSNBCVT)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Control_Vector_Translate verb changes the control vector used to encipher an
external key. See “Changing Control Vectors with the Control_Vector_Translate
Verb” on page C-20 for additional information about this verb.
Restrictions
None
Format
CSNBCVT
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
KEK_key_identifier Input String 64 bytes
source_key_token Input String 64 bytes
array_key_left Input String 64 bytes
mask_array_left Input String 56 bytes
array_key_right Input String 64 bytes
mask_array_right Input String 56 bytes
rule_array_count Input Integer zero, one, or two
rule_array Input String
array
rule_array_count * 8 bytes
target_key_token In/Output String 64 bytes
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.
KEK_key_identifier
The KEK_key_identifier parameter is a pointer to a string variable containing an
internal key-token or the key label of an internal key-token record containing
the key-encrypting key. The control vector in the internal key-token must
specify the key type IMPORTER, EXPORTER, IKEYXLAT, or OKEYXLAT.
source_key_token
The source_key_token parameter is a pointer to a string variable containing the
external key-token with the key and control vector to be processed.
array_key_left
The array_key_left parameter is a pointer to a string variable containing an
internal key-token or a key label of an internal key-token record that deciphers
the left mask-array. The internal key-token must contain a control vector
specifying a CVARXCVL key-type.
5-26 IBM 4758 CCA Basic Services, Release 2.54, February 2005