Parameters

The parameters for CSNBCKRD.

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
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
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
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
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.