Verify PIN (VFYPIN)
The Verify Personal Identification Number (VFYPIN) command
determines if the customer's personal identification number is
algorithmically related to the customer's validation data. The
result of the test is returned in a 1-byte variable.
| Keyword |
Description |
Choices |
Notes |
| INPINPTCK |
Input protection key name |
Name |
Required, Positional 1 |
| ENCPIN |
Enciphered PIN |
Character value |
Required, Positional 2 |
| PINVLDK |
PIN validation key name |
Name |
Required, Positional 3 |
| DECTBL |
Decimalization table |
Character value |
Required, Positional 4 |
| VLDDTA |
PIN validation data |
Character value |
Required, Positional 5 |
| PINCHKLEN |
PIN check length |
1-16 |
Required, Positional 6 |
| RTNVAR |
Return variable |
Character value |
Required, Positional 7 |
| PINPADCHAR |
PIN pad character |
Character value, *NONE |
Optional, Positional 8 |
| OFFSET |
PIN offset data |
Character value, *NONE |
Optional, Positional 9 |
Input protection key name (INPINPTCK)
Specifies the name, or a variable containing the name, of the
input PIN protection key that the personal identification number is
enciphered under. This 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 Add Cross-Domain Key
(ADDCRSDMNK) command). This is a required parameter.
Enciphered PIN (ENCPIN)
Specifies 16 hexadecimal characters, or a character variable
containing 16 hexadecimal characters, representing a personal
identification number in 3624 format enciphered under the input PIN
protection key. This is a required parameter.
PIN validation key name (PINVLDK)
Specifies the name, or a variable containing the name, of a
validation key that is to be used to encrypt the validation data.
This 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 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 verifying 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 verifying the personal
identification number. This is a required parameter.
PIN check length (PINCHKLEN)
Specifies the number, or a variable containing the number, of
digits of the personal identification number to be verified.
Return variable (RTNVAR)
Specifies a variable to receive the 1-byte verification status.
If the personal identification number is valid, the status is set
to 0. If the personal identification number is not valid, the
status is set to 1.
PIN pad character (PINPADCHAR)
Specifies the hexadecimal character that was used to pad the
personal identification number before being encrypted. It is
removed from the end of the personal identification number before
verification.
The possible values are:
- *NONE
- The personal identification number was not padded before being
encrypted.
- PIN-pad-character
- Specify 1 hexadecimal character, or a variable containing 1
hexadecimal character, representing the value that was used to pad
the personal identification number before it was encrypted
PIN offset data (OFFSET)
Specifies a numeric value to be added to the intermediate
personal identification number obtained from the validation data
before comparing it with the supplied personal identification
number.
The possible values are:
- *NONE
- No offset value should be added to the intermediate personal
identification number before the comparison. Specifying *NONE for
this parameter is equivalent to entering a value of zero for the
parameter.
- offset-data
- Specify 16 numeric digits (0-9), or a character variable
containing 16 numeric digits, representing the value to be added to
the intermediate personal identification number before the
comparison.