Filter
Top Products
Key_Token_Parse CCA Release 2.54
Key_Token_Parse (CSNBKTP)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Key_Token_Parse verb disassembles a key token into separate pieces of
information. The verb can disassemble an external key-token or an internal
key-token in application storage.
Use the key_token parameter to specify the key token to disassemble.
The verb returns some of the key-token information in a set of variables identified
by individual parameters and the remaining key-token information as keywords in
the rule array.
Control vector information is returned in keywords found in the rule array when the
verb can fully parse the control vector. Supported keywords are shown in
Figure 5-4 on page 5-9. Otherwise, the verb returns return code 4, reason code
2039.
The Key_Token_Parse verb performs no cryptographic services.
Restrictions
None.
Format
CSNBKTP
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
key_token Input String 64 bytes
key_type Output String 8 bytes
rule_array_count In/Output Integer
rule_array Output String
array
rule_array_count * 8 bytes
key_value Output String 16 bytes
MKVP Output Integer (only for a version X'03'
internal-token)
reserved_2 Output Integer
reserved_3 Output String 8 bytes
control_vector Output String 16 bytes
reserved_4 Output String 8 bytes
reserved_5 Output Integer
reserved_6 Output String 8 bytes
master_key_verification_pattern Output String 8 bytes (Only for a version
X'00' internal token)
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_token
The key_token parameter is a pointer to a string variable in application storage
containing an external or internal key-token to be disassembled.
5-66 IBM 4758 CCA Basic Services, Release 2.54, February 2005