IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Key_Storage_Initialization
key_storage_file_name_length
The key_storage_file_name_length parameter is a pointer to an integer variable
containing the number of bytes of data in the key_storage_file_name variable.
The length must be within the range of 1 to 64.
key_storage_file_name
The key_storage_file_name parameter is a pointer to a string variable
containing the fully qualified file name of the key-storage file to be initialized. If
the file does not exist, it is created. If the file does exist, it is overwritten and
all existing keys are lost.
key_storage_description_length
The key_storage_description_length parameter is a pointer to an integer
variable containing the number of bytes of data in the key_storage_description
variable.
key_storage_description
The key_storage_description parameter is a pointer to a string variable
containing the description string that is stored in the key-storage file when it is
initialized.
clear_master_key
The clear_master_key parameter is unused, but it must be declared and point
to 24 data bytes in application storage.
Keyword Meaning
Key-storage selection (one required)
DES Initialize DES key-storage.
PKA Initialize PKA key-storage.
Required Commands
Except in the OS/400 environment, the Key_Storage_Initialization verb requires the
Compute Verification Pattern command (offset X'001D') to be enabled in the
hardware. In the OS/400 environment, no commands are issued to the
Coprocessor and therefore command authorization does not apply.
Chapter 2. CCA Node-Management and Access-Control 2-51