IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Secure_Messaging_for_PINs
The Secure_Messaging_for_PINs verb:
Deciphers the input PIN block
Reformats the PIN block when the input and output PIN-block formats differ
Self-encrypts the output PIN block as specified
Places the PIN block within the supplied text at the specified offset
Encrypts the updated text. In CBC mode, uses the supplied initialization_vector
and also returns the value to be supplied as the initialization vector when
enciphering subsequent data for the EMV card message (the
output_chaining_vector).
Returns the enciphered text.
Restrictions
This verb is supported beginning with Release 2.50.
Format
CSNBSPN
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, one, or two
rule_array Input String
array
rule_array_count * 8 bytes
input_PIN_block Input String 8 bytes
PIN_encrypting_key_identifier Input String 64 bytes
input_PIN_profile Input String 3 * 8 bytes
input_PAN_data Input String 12 bytes
secmsg_key_identifier Input String 64 bytes
output_PIN_profile Input String 3 * 8 bytes
output_PAN_data Input String 12 bytes
clear_text_length Input Integer multiple of 8, 4096
clear_text Input String clear_text_length bytes
initialization_vector Input String 8 bytes
PIN_offset Input Integer (zero is at the start of the
clear_text)
PIN_offset_field_length Input Integer 8 bytes
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, one, or
two.
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.
Chapter 8. Financial Services Support Verbs 8-63