IBM 2 Computer Hardware User Manual


 
Clear_PIN_Generate_Alternate 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 number of digits of PIN information that the verb
should check. The verb uses the PIN_check_length parameter 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.
The length of the PIN offset in the returned result will be determined by the
value that the PIN_check_length parameter identifies. The security server
shortens the PIN offset.
data_array
The data_array parameter points 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 PIN-calculation method. Each element is not
always used, but you must always declare a complete 48-byte data array.
When using the IBM-PINO keyword, identify the following elements in the data
array:
Figure 8-7. Clear_PIN_Generate_Alternate Rule_Array Keywords (Second
Element)
PIN-Block
Format
Keyword
PIN-Extraction
Method
Keyword
Meaning
3624 PADDIGIT
HEXDIGIT
PINLEN04
PINLEN05
.
.
.
PINLEN16
PADEXIST
The PIN-extraction method keywords
specify a PIN-extraction method for an IBM
3624 PIN-block format. The first keyword,
PADDIGIT, is the default PIN-extraction
method for the PIN-block format.
ISO-0 PINBLOCK This keyword specifies the default
PIN-extraction method for an ISO-0
PIN-block format.
ISO-1 PINBLOCK This keyword specifies the default
PIN-extraction method for an ISO-1
PIN-block format.
8-24 IBM 4758 CCA Basic Services, Release 2.54, February 2005