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.

rule_array

Direction:	Input
Type:	String array

A pointer to a string variable containing an array of keywords. This verb currently does not use keywords.

key_label

Direction:	Input
Type:	String

A pointer to a string variable containing the key label of a key-token record in key storage. In a key label, you can use a wild card (*) to identify multiple records in key storage.

dataset_name_length

Direction:	Output
Type:	Integer

A pointer to an integer variable containing the number of bytes of data returned by the verb in the dataset_name variable. The maximum returned length is 64 bytes.

dataset_name

Direction:	Output
Type:	String

A pointer to a string variable containing the name of the file returned by the verb. The file contains the AES key-record information. When the verb stores a key-record-list file, it overlays any older file with the same name.

The path of the fully qualified file name returned by this verb is defined by the CSUAESLD environment variable.

This verb returns the file name as a fully qualified file specification (for example, /opt/IBM/CCA/keys/aeslist/KYRLT<nnn>.LST), where nnn is the numeric portion of the name. This value increases by one every time that you use this verb. When this value reaches 999, it resets to 001.

security_server_name

Direction:	Output
Type:	String

A pointer to a string variable. The information in this variable is not currently used, but the variable must be declared.