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 8-byte elements in the rule_array variable. The value must be 1 or 2.

rule_array

Direction:	Input
Type:	String

A pointer to a string variable containing an array of keywords that provide control information to the verb. Each element in the array must contain a valid keyword that 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 Combined Key Record Delete control information

Keywords for Combined Key Record Delete control information

Keyword	Description
Task (one optional).
TOKEN-DL	Deletes a key token from a key record in key storage, overwriting it with a null key token. This is the default.
LABEL-DL	Deletes an entire key record, including the key label, from key storage.
Key Block Algorithm (one required).
AES	Specifies to delete a key record for an AES key token denoted by the key_label parameter (external, internal, and null AES and HMAC key token).
DES	Specifies to delete a key record for a DES key token denoted by the key_label parameter (external, internal, and null DES key token).
PKA	Specifies to delete a key record for a PKA (ECC, QSA, or RSA) key token denoted by the key_label parameter. This record can be an external, internal, or null PKA key token.

key_label

Direction:	Input
Type:	String

A pointer to a string variable containing the key label of a key token record or records in key storage. Use a wildcard (*) in the key label variable to identify multiple records in key storage.