Filter
Top Products
Cryptographic_Resource_Deallocate CCA Release 2.54
Cryptographic_Resource_Deallocate (CSUACRD)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Cryptographic_Resource_Deallocate verb is used to deallocate a specific CCA
Coprocessor that is currently allocated 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) deallocates a cryptographic resource, 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.
Be sure to review “Multi-Coprocessor Capability” on page 2-10 and “Master-Key
Considerations with Multiple CCA Coprocessors” on page 2-17.
If a thread with an allocated Coprocessor terminates without first deallocating the
Coprocessor, excess memory consumption will result. It is not necessary to
deallocate a cryptographic resource if the process itself is terminating; it is only
suggested if individual threads terminate while the process continues to run.
Restrictions
None
Format
CSUACRD
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-46 IBM 4758 CCA Basic Services, Release 2.54, February 2005