Filter
Top Products
Cryptographic_Facility_Control 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. On input, specify the
size of the variable. The verb updates the variable with the size of the returned
data.
verb_data
The verb_data parameter is a pointer to a string variable containing data used
by the verb on input, or generated by the verb on output.
This field is used differently depending on the value of the control function
selected by a rule-array keyword.
For RQ-TOKEN, verb_data is an output parameter. It receives an
eight-byte randomly generated value, which the application uses with the
RQ-REINT keyword on a subsequent call.
On input, the verb_data_length variable must contain the length of the
buffer addressed by the verb_data pointer. Allocate an eight-byte buffer
and specify this length in the verb_data_length variable.
For RQ-REINT, verb_data is an input parameter. You must set it to the
one's complement of the token you received as a result of the RQ-TOKEN
call. Allocate an eight-byte buffer and specify this length in the
verb_data_length variable.
For SETCLOCK, verb_data is an input variable. It must contain a
character string which contains the current GMT date and time. Allocate a
16-byte buffer and specify this length in the verb_data_length variable.
This string has the form YYYYMMDDHHmmSSWW, where these fields are
defined as follows.
YYYY The current year
MM The current month, from 01 to 12
DD The current day of the month, from 01 to 31
HH The current hour of the day, from 00 to 23
mm The current minutes past the hour, from 00 to 59
SS The current seconds past the minute, from 00 to 59
WW The current day of the week, where Sunday is represented as 01,
and Saturday by 07.
For LOAD-FCV, verb_data is an input variable. It must contain a character
string which contains the function control vector (FCV) as described in
“Function Control Vector” on page B-42. Allocate a 204-byte buffer and
specify this length in the verb_data_length variable.
For CLR-FCV, no data is provided and the verb_data_length variable
should be set to zero.
For SET-EID, verb_data is an input variable. The variable contains a
16-byte environment identifier, or EID, value. This identifier is used in
verbs such as PKA_Key_Generate and PKA_Symmetric_Key_Import. See
“Restrictions” on page 2-30 for a list of valid characters in an environment
identifier. Allocate a 16-byte buffer and specify this length in the
verb_data_length variable.
2-32 IBM 4758 CCA Basic Services, Release 2.54, February 2005