Filter
Top Products
Key_Storage_Initialization CCA Release 2.54
Key_Storage_Initialization (CSNBKSI)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Key_Storage_Initialization verb initializes a key-storage file using the current
symmetric or asymmetric master-key. The initialized key storage will not contain
any pre-existing key records. The name and path of the key storage data and
index file are established differently in each operating environment. See the IBM
4758 PCI Cryptographic Coprocessor CCA Support Program Installation Manual for
information on these files.
Restrictions
None
Format
CSNBKSI
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 two
rule_array Input String
array
rule_array_count * 8 bytes
key_storage_file_name_length Input Integer
key_storage_file_name Input String key_storage_file_name_length
bytes
key_storage_description_length Input Integer ≤64
key_storage_description Input String key_storage_description_length
bytes
clear_master_key Input String 24 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 two 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:
Keyword Meaning
Master-key source (required)
CURRENT Specifies that the current symmetric master-key of the default
cryptographic facility is to be used for the initialization.
2-50 IBM 4758 CCA Basic Services, Release 2.54, February 2005