Filter
Top Products
CCA Release 2.54 Encrypted_PIN_Generate
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_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-generating key and
must contain a control vector that specifies a PINGEN key type and has the
EPINGEN bit set to one.
outbound_PIN_encrypting_key_identifier
The outbound_PIN_encrypting_key_identifier parameter is a pointer 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 to be used to
encrypt the formatted PIN and must contain a control vector that specifies the
OPINENC key type and has the EPINGEN 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. This value must be 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:
PIN_length
The PIN_length parameter is a pointer to an integer variable containing the PIN
length for those PIN-calculation methods with variable-length PINs. Otherwise,
the variable should be valued to zero.
data_array
The data_array parameter is a pointer to a string variable containing three
16-byte character strings, which are equivalent to a single 48-byte string. The
values in the data array depend on the keyword for the PIN-calculation method.
Each element is not always used, but you must always declare a complete data
array, see “Data_Array” on page 8-8.
The numeric characters in each 16-byte string must be from 1 to 16 bytes in
length, uppercase, left-justified, and padded on the right with space characters.
The verb converts the space characters to zeros.
Figure 8-8. Encrypted_PIN_Generate Rule_Array Keywords
Keyword Meaning
Calculation method (one required)
IBM-PIN This keyword specifies the IBM 3624 PIN-calculation method
to be used to generate a PIN.
GBP-PIN This keyword specifies the IBM German Bank Pool Institution
PIN calculation method to be used to generate a PIN.
INBK-PIN This keyword specifies the Interbank PIN-calculation method
to be used to generate a PIN.
Chapter 8. Financial Services Support Verbs 8-35