IWMELEAV macro — WLM Enclave Leave Service

The purpose of this service is to allow the task (TCB) invoking this service to leave an enclave. In addition, if the join of this task to the enclave specified SUBTASKS=YES, and the primary address space matches the home address space (PASN=HASN) on this leave request, then any subtasks that are implicitly joined to the enclave (by that join, or by ATTACH processing) leave the enclave. For the purpose of performance management, the task will become associated with its home address space. The scope of this service affects the current TCB at the time the service is invoked.

Note that a task may only leave an enclave if it explicitly joined the enclave. A subtask which inherited the enclave attribute from its mother task is not allowed to use IWMELEAV to explicitly leave the enclave. The subtask would leave the enclave upon its own (task) termination, when the enclave is deleted (IWM4EDEL) or when leave processing for SUBTASKS=YES is being performed. Also, a task which successfully establishes a Begin environment (IWM4STBG) may not invoke enclave Join, nor is the task allowed to use enclave Leave while this Begin environment exists.

Upon successful completion of this service, the CPU time for the TCB (and any subsequently attached subtasks) will be attributed to the home address space for the purpose of service unit calculations and performance period switches, rather than being attributed to the enclave.