- 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 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'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 supplied in the rule_array parameter.
The value can be 2, 3 or 4.
- rule_array
-
| Direction: Input | Type: String |
Two or three keywords that provide control information
to the callable service. Table 56 lists the keywords.
The keywords must be in 16 or 24 bytes of contiguous storage with
each of the keywords left-justified in its own 8-byte location and
padded on the right with blanks.
Table 56. Keywords for Key Test Extended Control Information| Keyword | Meaning |
|---|
| Key Rule (required) |
| KEY-ENC | Specifies the key supplied in key_identifier is
a single-length encrypted DES key. |
| KEY-ENCD | Specifies the key supplied in key_identifier is
a double-length encrypted DES key. |
| Process Rule (required) |
| GENERATE | Generate a verification pattern for
the key supplied in key_identifier. |
| VERIFY | Verify a verification pattern for
the key supplied in key_identifier. |
| Parity Adjustment (optional) |
| ADJUST | Adjust the parity of test key to
odd prior to generating or verifying the verification pattern. The key_identifier field
itself is not adjusted. |
| NOADJUST | Do not adjust the parity of test
key to odd prior to generating or verifying the verification pattern.
This is the default. |
| Verification Process Rule (optional) |
| ENC-ZERO | Specifies use of the "encrypted zeros"
method. |
- key_identifier
-
| Direction: Input/Output | Type: String |
The key for which to generate or verify the verification
pattern. The parameter is a 64-byte string of an internal token or
key label that is left-justified.
Note:
If you supply
a key label for this parameter, it must be unique on the CKDS.
- random_number
-
| Direction: Input/Output | Type: String |
This is an 8-byte field that contains a random number supplied
as input for the test pattern verification process and returned as
output with the test pattern generation process.
- verification_pattern
-
| Direction: Input/Output | Type: String |
This is an 8-byte field that contains a verification pattern
supplied as input for the test pattern verification process and returned
as output with the test pattern generation process.
- KEK_key_identifier
-
| Direction: Input/Output | Type: String |
If key_identifier is an external token, then
this is a 64-byte string of an internal token or a key label of an
IMPORTER or EXPORTER used to encrypt the test key. If key_identifier is
an internal token, then the parameter is ignored.
Note:
If you supply a key label for this parameter, it must be
unique on the CKDS.
z/OS Cryptographic Services ICSF Application Programmer's Guide
Copyright IBM Corporation 1990, 2014