z/OS Cryptographic Services ICSF Application Programmer's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Parameters

z/OS Cryptographic Services ICSF Application Programmer's Guide
SA22-7522-16

return_code
Direction: OutputType: Integer

The return code specifies the general result of the callable service. Appendix A. ICSF and TSS Return and Reason Codes lists the return codes.

reason_code
Direction: OutputType: Integer

The reason code specifies the result of the callable service that is returned to the application program. Each return code has different reason codes assigned to it that indicates specific processing problems. Appendix A. ICSF and TSS Return and Reason Codes lists the reason codes.

exit_data_length
Direction: Input/OutputType: Integer

The length of the data that is passed to the installation exit. The length can be from X'00000000' to X'7FFFFFFF' (2 gigabytes). The data is identified in the exit_data parameter.

exit_data
Direction: Input/OutputType: String

The data that is passed to the installation exit.

rule_array_count
Direction: InputType: Integer

The number of keywords you are supplying in the rule_array parameter. The parameter rule_array_count must be 0, 1, or 2.

rule_array
Direction: InputType: String

Keywords that provide control information to the callable service. Each keyword is left-justified in 8-byte fields, and padded on the right with blanks. All keywords must be in contiguous storage.

Table 219. CVV Generate Rule Array Keywords
KeywordMeaning
PAN data length (optional)
PAN-13Specifies that the length of the PAN data is 13 bytes. PAN-13 is the default value.
PAN-14Specifies that the length of the PAN data is 14 bytes.
PAN-15Specifies that the length of the PAN data is 15 bytes.
PAN-16Specifies that the length of the PAN data is 16 bytes.
PAN-17Specifies that the length of the PAN data is 17 bytes.
PAN-18Specifies that the length of the PAN data is 18 bytes.
PAN-19Specifies that the length of the PAN data is 19 bytes. Requires z990, z890, z9 EC or z9 BC with Jan. 2005 or higher version of Licensed Internal Code (LIC).
CVV length (optional)
CVV-1Specifies that the CVV is to be computed as one byte, followed by 4 blanks. CVV-1 is the default value.
CVV-2Specifies that the CVV is to be computed as 2 bytes, followed by 3 blanks.
CVV-3Specifies that the CVV is to be computed as 3 bytes, followed by 2 blanks.
CVV-4Specifies that the CVV is to be computed as 4 bytes, followed by 1 blank.
CVV-5Specifies that the CVV is to be computed as 5 bytes.
PAN_data
Direction: InputType: String

The PAN_data parameter specifies an address that points to the place in application data storage that contains personal account number (PAN) information in character form. 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-14 keyword is specified in the rule array, 14 characters are processed.
  • If the PAN-15 keyword is specified in the rule array, 15 characters are processed.
  • If the PAN-16 keyword is specified in the rule array, 16 characters are processed.
  • If the PAN-17 keyword is specified in the rule array, 17 characters are processed.
  • If the PAN-18 keyword is specified in the rule array, 18 characters are processed.
  • If the PAN-19 keyword is specified in the rule array, 19 characters are processed.

Even if you specify the PAN-13, PAN-14 or PAN-15 keywords, the server might copy 16 bytes to a work area. Therefore ensure that the callable service can address 16 bytes of storage.

expiration_date
Direction: InputType: String

The expiration_date parameter specifies an address that points to the place in application data storage that contains the card expiration date in numeric character form in a 4-byte field. The application programmer must determine whether the CVV will be calculated with the date form of YYMM or MMYY.

service_code
Direction: InputType: String

The service_code parameter specifies an address that points to the place in application data storage that contains the service code in numeric character form in a 3-byte field. The service code is the number that the track-2 magnetic-stripe standards define. The service code of '000' is supported.

CVV_key_A_Identifier
Direction: Input/OutputType: String

A 64-byte string that is the internal key token containing a single- or double-length DATA or MAC key or the label of a CKDS record containing a single- or double-length DATA or MAC key.

When this key is a double-length key, CVV_key_B_identifier must be 64 byte of binary zero. When a double-length MAC key is used, the CV bits 0-3 must indicate a CVVKEY-A key (0010).

A single-length key contains the key-A key that encrypts information in the CVV process. The left half of a double-length key contains the key-A key that encrypts information in the CVV process and the right half contains the key-B key that decrypts information.

CVV_key_B_Identifier
Direction: Input/OutputType: String

A 64-byte string that is the internal key token containing a single-length DATA or MAC key or the label of a CKDS record containing a single-length DATA or MAC key. When CVV_key_A_identifier a double-length key, this parameter must be 64 byte of binary zero. The key contains the key-B key that decrypts information in the CVV process.

CVV_value
Direction: OutputType: String

The CVV_value parameter specifies an address that points to the place in application data storage that will be used to store the computed 5-byte character output value.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014