Clear_PIN_Encrypt CCA Release 2.54
Format
CSNBCPE
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
PIN_encrypting_key_identifier Input String 64 bytes
rule_array_count Input Integer zero or one
rule_array Input String
array
rule_array_count * 8 bytes
clear_PIN Input String 16 bytes
PIN_profile Input String
array
3 * 8 bytes
PAN_data Input String 12 bytes
sequence_number Input Integer
encrypted_PIN_block 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.
PIN_encrypting_key_identifier
The PIN_encrypting_key_identifier parameter points to a string containing an
internal key-token or a key label of an internal key-token. The internal
key-token contains the key that encrypts the PIN block. The control vector in
the internal key-token must specify an OPINENC key type and have the
CPINENC bit set to one.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be zero or
one for this verb.
rule_array
The rule_array parameter is a pointer 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. The rule_array keywords are
shown below:
clear_PIN
The clear_PIN parameter points to a string variable containing the clear PIN.
The values in this variable must be left-justified and padded on the right with
space characters.
Keyword Meaning
PIN source (one, optional)
ENCRYPT Causes the verb to use the PIN value contained in the
clear_PIN variable. This is the default operation of the verb,
RANDOM Causes the verb to use a randomly generated PIN value. The
length of the PIN is based on the value in the clear_PIN
variable. Value the clear PIN to zero and use as many digits
as the desired random PIN. Pad the remainder of the
clear-PIN variable with space characters.
8-16 IBM 4758 CCA Basic Services, Release 2.54, February 2005