IBM Computer Hardware 2 User Manual Page 280

  • Download
  • Add to my manuals
  • Print
  • Page
    / 508
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 279
Retained_Key_List CCA Release 2.54
Retained_Key_List (CSNDRKL)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Retained_Key_List verb lists the key labels of those PKA keys that have been
retained within the Coprocessor. You filter the set of key labels returned to your
application through the use of the key label mask input variable.
Specify the keys to be listed using the key_label_mask variable. To identify
multiple keys, use the wild card (*) in a mask. Only labels with matching characters
to those in the mask up to the first “*” will be returned. To list all retained key
labels, specify a mask of an “*” followed by 63 space characters. For example, if
the Coprocessor has retained key-labels a.a, a.a1, a.b.c.d, and z.a, and you specify
the mask a.*, the verb will return a.a, a.a1 and a.b.c.d. If you had specified a mask
of a.a*, the verb will return a.a and a.a1.
You can retain both public and private keys within the Coprocessor through the use
of verbs such as PKA_Key_Generate and PKA_Public_Key_Register. You can
delete retained keys with the use of the Retained_Key_Delete verb.
Restrictions
None
Format
CSNDRKL
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
key_label_mask Input String 64 bytes or null pointer
retained_keys_count Output Integer
key_labels_count In/Output Integer
key_labels Output String key_labels_count * 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 zero for
this verb.
rule_array
The rule_array parameter should be a null address pointer.
7-22 IBM 4758 CCA Basic Services, Release 2.54, February 2005
Page view 279
1 2 ... 275 276 277 278 279 280 281 282 283 284 285 ... 507 508

Comments to this Manuals

No comments