Generate PIN (GENPIN)
The Generate Personal Identification Number (GENPIN) command generates a personal identification number that is algorithmically related to your validation data. The generated number contains 16 decimal digits of which all or part may be assigned to a customer or used as an intermediate identification number if you have a preselected personal identification number value.
| Keyword |
Description |
Choices |
Notes |
| PINVLDK |
PIN validation key name |
Name |
Required, Positional 1 |
| DECTBL |
Decimalization table |
Character value |
Required, Positional 2 |
| VLDDTA |
PIN validation data |
Character value |
Required, Positional 3 |
| PINRTNVAR |
Return variable |
Character value |
Required, Positional 4 |
PIN validation key name (PINVLDK)
Specifies the name, or a variable containing the name, of a PIN validation key which is to be used to encrypt the validation data for the personal identification number. This validation key must exist in the cross-domain key table and be defined with a key use of personal identification number (*PIN specified on the Key use prompt (KUSE parameter) on the Generate Cross-Domain Key (GENCRSDMNK) or the Add Cross-Domain Key (ADDCRSDMNK command). This is a required parameter.
Decimalization table (DECTBL)
Specifies 16 numeric digits (0-9), or a character variable containing 16 numeric digits, to be used as the table for conversion to decimal when generating the personal identification number. This is a required parameter.
PIN validation data (VLDDTA)
Specifies 16 hexadecimal characters, or a character variable containing 16 hexadecimal characters, representing the 8 bytes of validation data to be used for generating the personal identification number (for example, hex C1 represents the character A). This is a required parameter.
Return variable (PINRTNVAR)
Specifies a variable to receive the 16-digit generated personal identification number. This is a required parameter.