IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 DES_Key_Record_Read
DES_Key_Record_Read (CSNBKRR)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The DES_Key_Record_Read verb copies a key token from DES key-storage to
application storage. The returned key-token can be null.
Restrictions
None
Format
CSNBKRR
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
key_token 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.
key_label
The key_label parameter is a pointer to a string variable containing the key
label of the record to be read from DES key-storage.
key_token
The key_token parameter is a pointer to a string variable containing the key
token read from DES key-storage.
Required Commands
The DES_Key_Record_Read verb requires the Compute Verification Pattern
command (offset X'001D') to be enabled in the access-control system.
Chapter 7. Key-Storage Verbs 7-9