Filter
Top Products
CCA Release 2.54 Retained_Key_Delete
Retained_Key_Delete (CSNDRKD)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Retained_Key_Delete verb deletes a PKA key that has been retained within
the Coprocessor.
You can retain both public and private keys within the Coprocessor through the use
of verbs such as PKA_Key_Generate and PKA_Public_Key_Register. A list of
retained keys can be obtained with the use of the Retained_Key_List verb.
Restrictions
None
Format
CSNDRKD
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 zero
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 zero for
this verb.
rule_array
The rule_array parameter should be a null address pointer.
key_label
The key_label parameter points to a string variable containing the key label of a
key that has been retained within the Coprocessor.
Required Commands
The Retained_Key_Delete verb requires the Delete Retained Key command (offset
X'0203') to be enabled in the hardware.
Chapter 7. Key-Storage Verbs 7-21