IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Clear_PIN_Generate
Restrictions
None
Format
CSNBPGN
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
PIN_generating_key_identifier Input String 64 bytes
rule_array_count Input Integer one
rule_array Input String
array
rule_array_count * 8 bytes
PIN_length Input Integer
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.
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
CPINGEN 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 points to an integer variable in the range from 4 to
16 containing the length of the PIN.
Keyword Meaning
PIN-calculation method (one required)
IBM-PIN This keyword specifies the IBM 3624 PIN-calculation method
to be used to generate a PIN.
IBM-PINO This keyword specifies the IBM 3624 PIN offset calculation
method to be used to generate a PIN offset.
Chapter 8. Financial Services Support Verbs 8-19