Event code 19 — enclave termination event

Purpose

Perform language-specific enclave termination. This call allows the HLL to semantically terminate the application by enforcing the language semantics of a terminating enclave. Enclave-related resources should be released. This event is the counterpart of Event 18.

In the preinitialization interface, this event is driven for applications that run as main routines for the CALL request.

Syntax

Call CEEEVnnn (19, inpl)
POINTER   *inpl;
inpl (input)
The initialization parameter list for the enclave. Because the member ERTLI run unit termination call is no longer being made, the member languages should terminate for the run unit during this call. This event is used to terminate HLL portions at the enclave level. The order in which the member event handlers are called is in the reverse order of initialization. The dependencies are determined from the signature CSECTs. For more information, see Signature CSECT. Upon entry into the member event handler, the following is available:
  • R1 contains the address of a standard O/S style PLIST (all of the parameters are passed by reference) with the PLIST consisting of the following:
    • An event code indicating enclave termination 19
    • The initialization parameter list that was passed to CEEINT during Language Environment initialization. The initialization parameter list is described here. It is assumed to be a read-only parameter list. Also, the member-defined field which directly follows the owning member ID, must be used only by the owning member.
  • R12 addresses the CAA
  • R13 addresses a DSA
  • R14, R15 are linkage registers

Usage notes

  • This event is called in both CICS® and non-CICS environments.
  • CICS SPF: Language Environment calls languages in key 8 for this event. Storage for parameters can be in key 8.