IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 DES_Key_Record_Delete
DES_Key_Record_Delete (CSNBKRD)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The DES_Key_Record_Delete verb does either of the following tasks:
Replaces the token in a key record with a null key-token
Deletes an entire key record, including the key label, from key storage.
Identify the task with the rule_array keyword, and the key record with the key_label
parameter. To identify multiple records, use a wild card (*) in the key label.
Restrictions
None
Format
CSNBKRD
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer one
rule_array Input String
array
rule_array_count * 8 bytes
key_label Input String 64 bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be one for
this verb.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters. The rule_array keywords are
shown below:
Figure 7-2. DES_Key_Record_Delete Rule_Array Keywords
Keyword Meaning
Task (one required)
TOKEN-DL Deletes a key token from a key record in DES key-storage.
LABEL-DL Deletes an entire key record, including the key label, from
DES key-storage.
Chapter 7. Key-Storage Verbs 7-5