Cryptographic Resource Allocate (CSUACRA)

The Cryptographic Resource Allocate verb is used to allocate a specific CCA coprocessor or domain of a CCA coprocessor, or both, for use by the thread or process, depending on the scope of the verb. This service is also used to enable CPACF usage.

Coprocessor allocation is scoped to a thread, and domain allocation is scoped to a process. When a thread or process, depending on the scope, allocates a cryptographic resource, requests are routed to that resource. When a cryptographic resource is not allocated, requests are 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 (see Cryptographic Resource Deallocate (CSUACRD)) to deallocate an allocated cryptographic resource.

Be sure to review Multi-coprocessor selection capabilities.

This verb does not need to document any Required commands.