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

A pointer to a string variable containing an array of keywords. The keywords are eight bytes in length and must be left-aligned and padded on the right with space characters.

The rule_array keywords are described in Table 1.

Table 1. Keywords for AES Key Record Write control information

Keywords for AES Key Record Write control information

Keyword	Description
Processing option (One, optional)
CHECK	Specifies that the record is written only if a record of the same label in AES key-storage contains a null key-token. This is the default.
OVERLAY	Specifies that the record is overwritten regardless of the current content of the record in AES key-storage.

key_label

Direction:	Input
Type:	String

A pointer to a string variable containing the key label that identifies the record in AES key-storage where the key token is to be written.

key_token_length

Direction:	Input
Type:	Integer

A pointer to an integer variable containing the number of bytes of data in the key_token variable. This value must be 64.

key_token

Direction:	Input
Type:	String

A pointer to a string variable containing the AES key-token to be written into AES key-storage.