IBM 2 Computer Hardware User Manual


 
DES_Key_Record_Create CCA Release 2.54
DES_Key_Record_Create (CSNBKRC)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The DES_Key_Record_Create verb adds a key record with a null key-token to DES
key-storage. It is identified by the key label specified using the key_label
parameter.
After creating a DES key-record, you can use any of the following verbs to add or
update a key token in the key record:
Clear_Key_Import
DES_Key_Record_Write
Data_Key_Import
Key_Generate
Key_Import
Key_Part_Import
Multiple_Clear_Key_Import
PKA_Symmetric_Key_Import.
To delete a DES key-record, use the DES_Key_Record_Delete verb.
Restrictions
None
Format
CSNBKRC
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length 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.
key_label
The key_label parameter is a pointer to a string variable containing the key
label of the DES key-record to be created.
Required Commands
The DES_Key_Record_Create verb requires the Compute Verification Pattern
command (offset X'001D') to be enabled in the access-control system.
7-4 IBM 4758 CCA Basic Services, Release 2.54, February 2005