IBM 2 Computer Hardware User Manual


 
CVV_Generate CCA Release 2.54
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:
PAN_data
The PAN_data parameter points to a string variable containing personal
account number (PAN) data in character format. The PAN is the account
number as defined for the track-2 magnetic-stripe standards. If the PAN-13
keyword is specified in the rule array, 13 characters are processed; if the
PAN-16 keyword is specified in the rule array, 16 characters are processed.
Even if you specify the PAN-13 keyword, the server copies 16 bytes to a work
area. Therefore, ensure that the variable addresses 16 bytes of application
storage.
expiration_date
The expiration_date parameter points to a string variable containing the card
expiration date. The date is in numeric character format. The application
programmer must determine whether the CVV will be calculated as YYMM or
MMYY.
service_code
The service_code parameter points to a string variable containing the service
code in character format. The service code is the number that the track-2
magnetic-stripe standards define.
CVV_key-A_identifier
The CVV_key-A_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 key-A key that encrypts information in the
CVV process.
Keyword Meaning
PAN-data length (one, optional)
PAN-13 This keyword specifies that the length of the PAN data is 13
bytes. PAN-13 is the default value.
PAN-16 This keyword specifies that the length of the PAN data is 16
bytes.
CVV length (one, optional)
CVV-1 This keyword specifies the length of the CVV to be returned is
1 character. This is the default value.
CVV-2 This keyword specifies the length of the CVV to be returned is
2 characters.
CVV-3 This keyword specifies the length of the CVV to be returned is
3 characters.
CVV-4 This keyword specifies the length of the CVV to be returned is
4 characters.
CVV-5 This keyword specifies the length of the CVV to be returned is
5 characters.
8-28 IBM 4758 CCA Basic Services, Release 2.54, February 2005