Filter
Top Products
Clear_PIN_Generate CCA Release 2.54
Clear_PIN_Generate (CSNBPGN)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Clear_PIN_Generate verb generates an A-PIN or an O-PIN by using one of the
following calculation methods that you specify with a rule-array keyword (see
“PIN-Calculation Methods” on page E-2):
IBM 3624 PIN (IBM-PIN)
IBM 3624 PIN Offset (IBM-PINO).
You can use this verb to do the following:
Generate a clear PIN for immediate use; for example, generate a clear A-PIN
as part of PIN mailer processing
Generate an offset (O-PIN) for use on a customer account magnetic-stripe
card.
Notes:
1. A clear PIN is a sensitive piece of information. Ensure that your application
program and system design provide adequate protection for the clear PIN.
2. To format and encrypt a PIN, use the Clear_PIN_Encrypt verb.
To use this verb, specify:
A PIN-generating key
The number of rule-array elements
The PIN-calculation method
The length of the PIN
For certain PIN-calculation methods, an additional PIN-length value with the
PIN_check_length variable to determine the length of the O-PIN value
A decimalization table, validation data (for example, account-number
information) and, based on the PIN-calculation method, the C-PIN value, in a
character array
A 16-byte variable to receive the clear PIN.
The verb does the following:
Verifies that the CPINGEN bit is set to one in the control vector for the PINGEN
key.
Calculates the A-PIN, and optionally uses the C-PIN and the A-PIN to compute
the O-PIN value. See “PIN-Calculation Methods” on page E-2.
Uses the specified PIN length to determine the length of the PIN.
Returns the clear A-PIN or O-PIN in the variable identified by the
returned_result parameter.
8-18 IBM 4758 CCA Basic Services, Release 2.54, February 2005