IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Secure_Messaging_for_PINs
clear_text_length
The clear_text_length parameter is a pointer to an integer containing the length
of text 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 with a PIN
block 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 text). This can be a null pointer when ECB mode is
specified.
PIN_offset
The PIN_offset parameter is a pointer to an integer containing the offset to the
location for the PIN block. Specify the start of the text as offset zero. The
offset plus PIN_offset_field_length must be less than or equal to the
clear_text_length.
PIN_offset_field_length
The PIN_offset_field_length parameter is a pointer to an integer valued to eight.
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 enciphered text and can 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_PINs verb requires the Secure Messaging for PINs
command (offset X'0274') to be enabled in the hardware.
Chapter 8. Financial Services Support Verbs 8-65