IBM Computer Hardware 2 User Manual download pdf (Page 214)

100

101

Key_Token_Change CCA Release 2.54

Key_Token_Change (CSNBKTC)

Platform/

Product

OS/2 AIX Win NT/

2000

OS/400

IBM 4758-2/23 X X X X

Use the Key_Token_Change verb to reencipher a DES key from encryption under

the old master-key to encryption under the current master-key and to update the

keys in internal DES key-tokens.

Note: An application system is responsible for keeping all of its keys in a useable

form. When the master key is changed, the IBM 4758 product family

implementations can use an internal key that is enciphered by either the current or

the old master-key. Before the master key is changed a second time, it is

important to have a key reenciphered under the current master-key for continued

use of the key. Use the Key_Token_Change verb to reencipher such a key(s).

Note: Previous implementations of IBM CCA products had additional capabilities

with this verb such as deleting key records and key tokens in key storage. Also,

use of a wild card (*) was supported in those implementations

Restrictions

None

Format

CSNBKTC

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 In/Output 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 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:

5-64 IBM 4758 CCA Basic Services, Release 2.54, February 2005

1 2 ... 209 210 211 212 213 214 215 216 217 218 219 ... 507 508

Comments to this Manuals

No comments

IBM Computer Hardware 2 User Manual Page 214

Comments to this Manuals

Related products and manuals for Software IBM Computer Hardware 2