Filter
Top Products
PKA_Key_Token_Change CCA Release 2.54
PKA_Key_Token_Change (CSNDKTC)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The PKA_Key_Token_Change verb changes RSA private keys from encipherment
with the old asymmetric master-key to encipherment with the current asymmetric
master-key. You identify the task with the rule-array keyword, and the internal
key-token to change with the key_identifier parameter.
Note: This verb is similar in function to the CSNBKTC Key_Token_Change verb
used with DES key tokens.
Restrictions
Certain implementations of CCA may not support this verb.
Format
CSNDKTC
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_identifier_length In/Output Integer
key_identifier In/Output String key_identifier_length 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 3-4. PKA_Key_Token_Change Rule_Array Keywords
Keyword Meaning
Encipherment type (required)
RTCMK Changes an RSA private key from encipherment with the old
asymmetric master-key to encipherment with the current
asymmetric master-key.
3-22 IBM 4758 CCA Basic Services, Release 2.54, February 2005