IBM 2 Computer Hardware User Manual


 
PKA_Public_Key_Extract CCA Release 2.54
PKA_Public_Key_Extract (CSNDPKX)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The PKA_Public_Key_Extract verb is used to extract a public key from a
public-private key-pair. The public key is returned in a PKA public-key token.
Both the public key and the related private key must be present in the source key
token. The source private-key may be in the clear or may be enciphered.
Restrictions
None
Format
CSNDPKX
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 zero
rule_array Input String
array
rule_array_count * 8 bytes
source_key_identifier_length Input Integer
source_key_identifier Input String source_key_identifier_length
bytes
target_key_token_length In/Output Integer
target_key_token Output String target_key_token_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 zero 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 parameter is
not presently used by this verb, but must be specified.
source_key_identifier_length
The source_key_identifier_length parameter is a pointer to an integer variable
containing the number of bytes of data in the source_key_identifier variable.
The maximum size that should be specified is 2500 bytes.
source_key_identifier
The source_key_identifier parameter is a pointer to a string variable containing
either a key label identifying a PKA key-storage record or a PKA96 key-token.
3-24 IBM 4758 CCA Basic Services, Release 2.54, February 2005