Filter
Top Products
Cryptographic_Facility_Query CCA Release 2.54
Cryptographic_Facility_Query (CSUACFQ)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Cryptographic_Facility_Query verb is used to retrieve information about the
Cryptographic Coprocessor and the CCA application program in that Coprocessor.
This information includes the following:
General information about the Coprocessor
General information about the CCA application program in the Coprocessor
Status of master-key shares distribution
Environment identifier, EID
Diagnostic information from the Coprocessor
Export-control information from the Coprocessor
Time and date information.
On input, you specify:
A rule-array count of one or two
Optionally a rule-array keyword of ADAPTER1
The class of information queried with a rule-array keyword.
The verb returns information elements in the rule array and sets the
rule-array-count variable to the number of returned elements.
Restrictions
You cannot limit the number of returned rule-array elements. Figure 2-3 on
page 2-35 describes the number and meaning of the information in output
rule-array elements. You are advised to allocate a minimum of 30 rule-array
elements to allow for extensions of the returned information.
Format
CSUACFQ
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length
rule_array_count In/Output Integer one or two on input
rule_array In/Output String
array
rule_array_count * 8 bytes
verb_data_length In/Output Integer
verb_data In/Output String verb_data_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. On input, the value must be
one or two for this verb.
2-34 IBM 4758 CCA Basic Services, Release 2.54, February 2005