Filter
Top Products
CCA Release 2.54 Key_Test
Restrictions
None
Format
CSNBKYT
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer two, three, or four
rule_array Input String
array
rule_array_count * 8 bytes
key_identifier Input String 64 bytes
random_number In/Output String 8 bytes
verification_pattern In/Output String 8 bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be two,
three, or four for this verb.
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:
Keyword Meaning
Process rule (one required)
GENERATE Generates a verification pattern.
VERIFY Verifies a verification pattern.
Key or key-part rule (one required)
KEY-CLR Requests processing for a single-length clear key or key part.
KEY-CLRD Requests processing for a double-length clear key or key part.
KEY-ENC Requests processing for a single-length enciphered key or key
part supplied in a key token.
KEY-ENCD Requests processing for a double-length enciphered key or
key part supplied in a key token.
KEY-KM Identifies the master-key register.
KEY-NKM Identifies the new master-key register.
KEY-OKM Identifies the old master-key register.
Master-key selector (one, optional)
SYM-MK Specifies use of the symmetric master-key registers.
ASYM-MK Specifies use of the asymmetric master-key registers.
Chapter 5. DES Key-Management 5-59