- return_code
-
| Direction: Output | Type: 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: Output | Type: 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/Output | Type: 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/Output | Type: String |
The data that is passed to the installation exit.
- rule_array_count
-
| Direction: Input | Type: Integer |
The number of keywords you are supplying in the rule_array parameter.
The valid values are 1 or 2.
- rule_array
-
| Direction: Input | Type: Character String |
Keywords that provides control information to the callable
service. The keywords are left-justified in an 8-byte field and padded
on the right with blanks. The keywords must be in contiguous storage.
Specify one or two of the values inTable 215.
Table 215. Rule Array Keywords for Transaction Validation| Keyword | Meaning |
|---|
| American Express card security codes (required) |
| CSC-3 | 3-digit card security code (CSC)
located on the signature panel. VERIFY implied.
This is the default. |
| CSC-4 | 4-digit card security code (CSC)
located on the signature panel. VERIFY implied. |
| CSC-5 | 5-digit card security code (CSC)
located on the signature panel. VERIFY implied. |
| CSC-345 | Generate 5-byte, 4-byte, 3-byte values
when given an account number an an expiration date, GENERATE implied. |
| Operation (optional) |
| VERIFY | Specifies verification of the value
presented in the validation values variable. |
| GENERATE | Specifies generation of the value
presented in the validation values variable. |
- transaction_key_identifier_length
-
| Direction: Input | Type: Integer |
The length of the transaction_key_identifier parameter.
- transaction_key_identifier
-
| Direction: Input | Type: String |
The labelname or internal token of a MAC or MACVER class
key. Key may be single or double length.
- transaction_info_length
-
| Direction: Input | Type: Integer |
The length of the transaction_info parameter.
For the American Express CSC codes, the length must be 19.
- transaction_info
-
| Direction: Input | Type: String |
For American Express, this is a 19-byte field containing
the concatenation of the 4-byte expiration data (in the format YYMM)
and the 15-byte American Express account number. Provide the information
in character format.
- validation_values_length
-
| Direction: Input/Output | Type: Integer |
The length of the validation_values parameter.
Maximum value for this field is 64.
- validation_values
-
| Direction: Input | Type: String |
This variable contains American Express CSC values. The
data is output for GENERATE and input for VERIFY.
Table 216. Output description for validation values| Operation | Element Description |
|---|
| GENERATE and CSC-345 | 5555544444333 where:
55555 = CSC 5 value
4444 = CSC 4 value
333 = CSC 3 value
|
| VERIFY and CSC-3 | 333 = CSC 3 value |
| VERIFY and CSC-4 | 4444 = CSC 4 value |
| VERIFY and CSC-5 | 55555 = CSC 5 value |
z/OS Cryptographic Services ICSF Application Programmer's Guide
Copyright IBM Corporation 1990, 2014