Filter
Top Products
Secure_Messaging_for_Keys CCA Release 2.54
Returns the enciphered text.
Restrictions
This verb is supported beginning with Release 2.50.
Format
CSNBSKY
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer zero or one
rule_array Input String
array
rule_array_count * 8 bytes
input_key_identifier Input String 64 bytes
key_encrypting_key_identifier Input String 64 bytes
secmsg_key_identifier Input String 64 bytes
clear_text_length Input Integer Multiple of 8, ≤ 4096
clear_text Input String clear_text_length bytes
initialization_vector Input String 8 bytes
key_offset Input Integer (0 is at the start of the
clear_text)
key_field_length Input Integer key length, e.g. 8 or 16
enciphered_text Output String clear_text_length bytes
output_chaining_vector Output String 8 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.
rule_array_count
The rule_array_count parameter points to an integer variable containing the
number of elements in the rule_array variable. The value must be zero or one.
rule_array
The rule_array parameter points to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters.
input_key_identifier
The input_key_identifier parameter is a pointer to a string variable containing
the encrypted-key key-token or the label of a key record in key storage. You
may identify any type of key, provided the control-vector export-allowed
permission bit is on (bit 17). You also may specify an external DATA key with
an all-zero control vector.
key_encrypting_key_identifier
The key_encrypting_key_identifier parameter is a pointer to a string variable
containing the IMPORTER or EXPORTER key to decipher an external
Keyword Meaning
Enciphering mode (one, optional)
TDES-CBC Use CBC mode to encipher the clear_text. This is the default.
TDES-ECB Use ECB mode to encipher the clear_text.
8-60 IBM 4758 CCA Basic Services, Release 2.54, February 2005