IBM 2 Cryptographic_Facility_Query , 2-42

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 Returnedin
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, 1≤i≤15, of master-key information.
1, 2 Master-Key Shares
Generation
The 15 individual bytes are set to one of these
character values:
0Cannot be generated
1Can be generated
2Has been generated but not
distributed
3Generated and distributed once
4Generated and distributed more
than once.
3, 4 Master-Key Shares
Reception
The 15 individual bytes are set to one of these
character values:
0Cannot be received
1Can be received
3Has been received
4Has 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.
3Day 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