IBM 2 Computer Hardware User Manual


 
Clear_PIN_Generate_Alternate CCA Release 2.54
Calculates the A-PIN. The verb uses the specified calculation method, the
data_array variable, and the PIN_check_length variable to calculate the PIN.
Calculates the O-PIN
Returns the clear O-PIN in the variable identified by the returned_result
parameter.
Restrictions
None
Format
CSNBCPA
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output Integer exit_data_length bytes
inbound_PIN_encrypting_key_identifier Input String 64 bytes
PIN_generating_key_identifier Input String 64 bytes
input_PIN_profile Input String
array
3 * 8 bytes
PAN_data Input String 12 bytes
encrypted_PIN_block Input String 8 bytes
rule_array_count Input Integer one or two
rule_array Input String
array
rule_array_count * 8 bytes
PIN_check_length Input Integer
data_array Input String
array
3 * 16 bytes
returned_result Output String 16 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.
inbound_PIN_encrypting_key_identifier
The inbound_PIN_encrypting_key_identifier parameter points to a string
variable containing an internal key-token or a key label of an internal key-token
record in key storage. The internal key-token contains the key that decrypts
the PIN-block C-PIN. The control vector in the key token must specify the
IPINENC key type and have the CPINGENA bit set to one.
PIN_generating_key_identifier
The PIN_generating_key_identifier parameter points to a string variable
containing an internal key-token or a key label of an internal key-token record
in key storage. The internal key-token contains the PIN-generation key and
must contain a control vector that specifies the PINGEN key type and has the
CPINGENA bit set to one.
input_PIN_profile
The input_PIN_profile parameter points to a string variable containing a
character array with three 8-byte elements: the PIN-block format keyword, the
format control (NONE), a pad digit (if needed); see “PIN Profile” on page 8-10.
PAN_data
The PAN_data parameter points to a string variable containing personal
account number (PAN) data. If the PIN profile specifies the ISO-0 keyword, the
verb uses the PAN data to recover the C-PIN from the PIN block.
8-22 IBM 4758 CCA Basic Services, Release 2.54, February 2005