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

This parameter is ignored.

key_label

Direction:	Output
Type:	String

The key_label parameter is a pointer to a string variable containing a key record in PKA key-storage. You can use a wild card (*) to identify multiple records in key storage.

dataset_name_length

Direction:	Input
Type:	Integer

The dataset_name_length parameter is a pointer to an integer variable containing the number of bytes of data returned in the dataset_name variable. The maximum returned length is 64 bytes.

dataset_name

Direction:	Output
Type:	String

A pointer to a 64-byte string variable containing the name of the file returned by the verb. The file contains the PKA key-record information.

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

This verb returns the file name as a fully qualified file specification (for example, /opt/IBM/CCA/keys/pkalist/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.

Note: When the verb stores a key-record-list file, it overlays any older file with the same name.

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.