Filter
Top Products
Clear_PIN_Generate CCA Release 2.54
PIN_check_length
The PIN_check_length parameter points to an integer variable in the range
from 4 to 16 containing the length of the PIN offset. The verb uses the PIN
check length if you specify the IBM-PINO keyword for the calculation method.
Otherwise, ensure that this parameter points to a four-byte variable in
application storage. The information in this variable will be ignored, but this
variable must be declared.
Note: The PIN check length must be less than or equal to the PIN length.
data_array
The data_array parameter points to a string variable containing three 16-byte
numeric 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.
The numeric characters in each 16-byte string must be from 1 to 16 bytes in
length, left-justified, and padded on the right with space characters. The verb
converts the space characters to zeros.
When using the IBM-PIN or the IBM-PINO keyword, identify the following
elements in the data array.
returned_result
The returned_result parameter points to a string variable containing the result
returned by the verb. The result will be left-justified and padded on the right
with space characters.
Element Description
decimalization_table This element contains the decimalization table of 16
characters (0 to 9) that are used to convert the
hexadecimal digits (X'0' to X'F') of the encrypted
validation data to decimal digits (X'0' to X'9').
validation_data This 16-byte element contains 1 to 16 characters of
account data. The data must be left-justified and
padded on the right with spaces.
clear_PIN When using the IBM-PINO keyword, this 16-byte
element contains the clear customer-selected PIN. This
value must be left-justified and padded on the right with
spaces.
When using the IBM-PIN keyword, this element is
ignored but must be declared.
Required Commands
The Clear_PIN_Generate verb requires the following command to be enabled in the
hardware based on the keyword specified for the PIN-calculation method.
PIN-Calculation
Method
Command
Offset
Command
IBM-PIN,
IBM-PINO
X'00A0' Generate Clear 3624 PIN
8-20 IBM 4758 CCA Basic Services, Release 2.54, February 2005