Parameters

For the definitions of the return_code, reason_code, exit_data_length, and exit_data parameters, see Parameters common to all verbs.

rule_array_count

Direction:	Input
Type:	Integer

A pointer to an integer variable containing the number of elements in the rule_array variable. This value must be 0 or 1.

rule_array

Direction:	Input
Type:	String array

Keywords that provide control information to the verb. Each keyword is left-aligned in 8-byte fields and padded on the right with blanks. All keywords must be in contiguous storage. The rule_array keywords are described in Table 1.

Table 1. Keywords for PKA Key Record Write control information

Keywords for PKA Key Record Write control information

Keyword	Description
Write mode (One, optional). Specifies the circumstances under which the record is to be written.
CHECK	Specifies the record will be written only if a record of type NULL with the same label exists in the PKA key storage file. If such a record exists, it is overwritten. This is the default condition.
OVERLAY	Specifies the record will be overwritten regardless of the current content of the record. If a record with the same label exists in the PKA key storage file, is overwritten.

key_label

Direction:	Input
Type:	String

The label of the record to be overwritten, a 64-byte character string.

key_token_length

Direction:	Input
Type:	Integer

The length of the field containing the token to be written to the PKA key storage file.

key_token

Direction:	Input
Type:	String

A string variable containing an RSA or ECC private token in either external or internal format, or an RSA or ECC public token that is to be written to the PKA key storage file.