Filter
Top Products
CCA Release 2.54 Secure_Messaging_for_Keys
input_key. You may also specify a key label of a key storage record for such a
key. For an internal-form input_key, you may specify a null key-token.
secmsg_key_identifier
The secmsg_key_identifier parameter is a pointer to a string variable containing
an internal key-token or the key label of an internal key-token in key storage.
The control vector must specify a SECMSG type key with the SMKEY
control-vector bit (bit 18) on.
clear_text_length
The clear_text_length parameter is a pointer to an integer containing the length
of text in bytes to be encrypted. This must be a multiple of eight and less than
or equal to 4096.
clear_text
The clear_text parameter is a pointer to the text string to be updated and
encrypted.
initialization_vector
The initialization_vector parameter is a pointer to an eight-byte string containing
the CBC-encryption initialization vector (the data to be exclusive-ORed with the
first eight bytes of the message). This can be a null pointer when ECB mode is
specified.
key_offset
The key_offset parameter is a pointer to an integer containing the offset of the
location for the decrypted input-key. The start of the text is an offset of zero.
The offset plus the key-offset-field-length must be less than or equal to the
clear-text-length.
key_field_length
The key_field_length parameter is a pointer to an integer containing the length
of key information to be inserted into the text message. Use a length of 8 for a
single-length key and a length of 16 for a double-length key.
enciphered_text
The enciphered_text parameter is a pointer to a string variable to receive the
enciphered text message.
output_chaining_vector
The output_chaining_vector parameter is a pointer to an eight-byte string to
receive the CBC chaining value. This is the same as the last eight bytes of
returned text and would be used as an initialization_vector when encrypting
subsequent data for a message. This can be a null pointer when ECB mode is
specified.
Required Commands
The Secure_Messaging_for_Keys verb requires the Secure Messaging for Keys
command (offset X'0273') to be enabled in the hardware.
Chapter 8. Financial Services Support Verbs 8-61