Parameters

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

key_label

Direction:	Input
Type:	String

The key_label parameter is 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

The dataset_name_length parameter is 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

The dataset_name parameter is a pointer to a 64-byte string variable containing the name of the file returned by the verb. The file contains the DES key-record information.

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

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

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