- 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 that indicate 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'7FFFFFFFFF' (2
gigabytes). The data is defined in the exit_data parameter.
- exit_data
-
| Direction: Input/Output | Type: String |
The data that is passed to the installation exit.
- PIN_encrypting_key_identifier
-
| Direction: Input/Output | Type: String |
The 64-byte string containing an internal key token or
a key label of an internal key token. The internal key token contains
the key that encrypts the PIN block. The control vector in the internal
key token must specify an OPINENC key type and have the CPINENC usage
bit set to 1.
- rule_array_count
-
| Direction: Input | Type: Integer |
The number of keywords you are supplying in the rule_array parameter.
Valid values are 0 and 1.
- rule_array
-
| Direction: Input | Type: Character string |
Keywords that provide control information to the callable
service. The keyword is left-justified in an 8-byte field, and padded
on the right with blanks. All keywords must be in contiguous storage.
The rule array keywords are shown as follows:
Table 169. Process Rules for the Clear PIN Encryption Callable Service| Process Rule | Description |
|---|
| ENCRYPT | This is the default. Use of this
keyword is optional. |
| RANDOM | Causes the service to generate a
random PIN value. The length of the PIN is based on the value in the clear_PIN variable.
Set the value of the clear PIN to zero and use as many digits as the
desired random PIN; pad the remainder of the clear PIN variable with
space characters. |
- clear_PIN
-
| Direction: Input | Type: String |
A 16-character string with the clear PIN. The value in
this variable must be left-justified and padded on the right with
space characters.
- PIN_profile
-
| Direction: Input | Type: String |
A 24-byte string containing three 8-byte elements with
a PIN block format keyword, the format control keyword, NONE, and
a pad digit as required by certain formats.See The PIN Profile for
additional information.
- PAN_data
-
| Direction: Input | Type: String |
A 12-byte PAN in character format. The service uses this
parameter if the PIN profile specifies the ISO-0 or VISA-4 keyword
for the PIN block format. Otherwise, ensure that this parameter is
a 12-byte variable in application storage. The information in this
variable will be ignored, but the variable must be specified.
Note:
When using the ISO-0 keyword, use the 12 rightmost digits
of the PAN data, excluding the check digit. When using the VISA-4
keyword, use the 12 leftmost digits of the PAN data, excluding the
check digit.
- sequence_number
-
| Direction: Input | Type: Integer |
The 4-byte character integer. The service currently ignores
the value in this variable. For future compatibility, the suggested
value is 99999.
- encrypted_PIN_block
-
| Direction: Output | Type: String |
The field that receives the 8-byte encrypted PIN block.
z/OS Cryptographic Services ICSF Application Programmer's Guide
Copyright IBM Corporation 1990, 2014