IBM 2 Computer Hardware User Manual


 
Cryptographic_Facility_Query CCA Release 2.54
verb_data_length
The verb_data_length parameter is a pointer to an integer variable containing
the number of bytes of data in the verb_data variable.
verb_data
The verb_data parameter is a pointer to a string variable containing data sent
to the Coprocessor for this verb, or received from the Coprocessor as a result
Figure 2-3 (Page 7 of 7). Cryptographic_Facility_Query Information Returned in
the Rule Array
Element
Number
Name Description
Output rule-array for option STATMOFN
Elements one and two, and elements three and four, are each treated as a 16-byte
string with the high-order 15 bytes having meaningful information and the 16th byte
containing a space character. Each byte provides status information about the 'i'th
share, 1i15, of master-key information.
1, 2 Master-Key Shares
Generation
The 15 individual bytes are set to one of these
character values:
0 Cannot be generated
1 Can be generated
2 Has been generated but not
distributed
3 Generated and distributed once
4 Generated and distributed more
than once.
3, 4 Master-Key Shares
Reception
The 15 individual bytes are set to one of these
character values:
0 Cannot be received
1 Can be received
3 Has been received
4 Has been received more than once.
5 'm' The minimum number of shares required to
instantiate a master key through the
master-key-shares process. The value is
returned in two characters, valued from 01 to
15, followed by six space characters.
6 'n' The maximum number of distinct shares
involved in the master-key shares process.
The value is returned in two characters, valued
from 01 to 15, followed by six space
characters.
Output rule-array for option TIMEDATE
1 Date The current date is returned as a character
string of the form YYYYMMDD, where YYYY
represents the year, MM represents the month
(01-12), and DD represents the day of the
month (01-31).
2 Time The current GMT time of day is returned as a
character string of the form HHMMSS.
3 Day of the Week The day of the week is returned as a number
between 1 (Sunday) and 7 (Saturday).
2-42 IBM 4758 CCA Basic Services, Release 2.54, February 2005