Filter
Top Products
Cryptographic_Resource_Allocate CCA Release 2.54
Cryptographic_Resource_Allocate (CSUACRA)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Cryptographic_Resource_Allocate verb is used to allocate a specific CCA
Coprocessor for use by the thread or process, depending on the scope of the verb.
For the OS/400, this verb is scoped to a process; for the other implementations,
this verb is scoped to a thread. When a thread (or process, depending on the
scope) allocates a cryptographic resource, requests will be routed to that resource.
When a cryptographic resource is not allocated, requests will be routed to the
default cryptographic resource.
You can set the default cryptographic resource. If you take no action, the default
assignment is CRP01.
You cannot allocate a cryptographic resource while one is already allocated. Use
the Cryptographic_Resource_Deallocate verb to deallocate a currently allocated
cryptographic resource.
Be sure to review “Multi-Coprocessor Capability” on page 2-10 and “Master-Key
Considerations with Multiple CCA Coprocessors” on page 2-17.
Restrictions
None
Format
CSUACRA
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
rule_array Input String
array
rule_array_count * 8 bytes
resource_name_length Input Integer
resource_name Input String resource_name_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. The value must be one for
this verb.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters. The rule_array keywords are
shown below:
2-44 IBM 4758 CCA Basic Services, Release 2.54, February 2005