IBM 2 Computer Hardware User Manual


 
Cryptographic_Facility_Control CCA Release 2.54
Cryptographic_Facility_Control (CSUACFC)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
Use the Cryptographic_Facility_Control verb to perform the following services:
Reinitialize the CCA application in the Coprocessor.
Set the date and time in the Coprocessor clock.
Reset the Coprocessor Intrusion Latch (see page 2-10)
Reset the Coprocessor Battery-Low Indicator (see page 2-10)
Load or clear the Function Control Vector, which defines limitations on the
cryptographic functions available in the Coprocessor.
Establish the environment identifier (EID), which is a user-defined identifier.
Once set, the EID can only be set again following a CCA reinitialization.
Establish the minimum and maximum number of “cloning information” shares
that are required and that can be used to pass sensitive information from one
Coprocessor to another Coprocessor.
Select which service to perform by specifying the corresponding keyword in the
input rule-array. You can only perform one of these services per verb call.
Restrictions
Use only these characters in an environment identifier (EID): A...Z, a...z, 0...9, and
these additional characters relating to different character symbols in the various
national language character sets as listed below:
The alphabetic and numeric characters should be encoded in the normal character
set for the computing platform that is in use, either ASCII or EBCDIC.
ASCII
Systems
EBCDIC
Systems
USA Graphic
(for reference)
X'20' X'40' space character
X'26' X'50' &
X'3D' X'7E' =
X'40' X'7C' @
Format
CSUACFC
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer one or two
rule_array Input String
array
rule_array_count * 8 bytes
verb_data_length In/Output Integer
verb_data In/Output String verb_data_length bytes
2-30 IBM 4758 CCA Basic Services, Release 2.54, February 2005