IBM 2 Computer Hardware User Manual


 
PKA_Key_Record_List CCA Release 2.54
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. Currently this verb does not
use keywords and this field is ignored.
key_label
The key_label parameter is a pointer to a string variable containing a key
record in PKA key-storage. You can use a wild card (*) to identify multiple
records in key storage.
data_set_name_length
The data_set_name_length parameter is a pointer to an integer variable
containing the number of bytes of data returned in the data_set_name variable.
The maximum returned value is 64 bytes.
data_set_name
The data_set_name parameter is a pointer to a 64-byte string variable
containing the name of the data set returned by the verb. The data set
contains the key-record information.
The verb returns the data_set_name as a fully qualified file specification (for
example, C:\PKADIR\KYRLTnnn.LST in the OS/2 environment), where nnn is
the numeric portion of the name. This value increases by one every time you
use this verb. When it reaches 999, the value is reset to 001.
Note: When the verb stores a key-record-list data set, it overlays any older
data set with the same name.
security_server_name
The security_server_name parameter is a pointer to a string variable. The
information in this variable is not currently used, but the variable must be
declared.
Required Commands
The PKA_Key_Record_List verb requires the Compute Verification Pattern
command (offset X'001D') to be enabled in the access-control system.
7-16 IBM 4758 CCA Basic Services, Release 2.54, February 2005