IWMSTBGN – Beginning a Request from a Caller's Work Manager Queue

IWMSTBGN establishes the environment to process a work request that was previously selected using IWMSSEL. The caller must invoke IWMSTBGN from the task in the server address space that will process the request. IWMSTBGN establishes a business unit-of-work relationship by joining the caller's task to the enclave associated with the request. IWMSTBGN creates a security environment if there is a user ID associated with the request previously selected.

Use IWMSTBGN together with IWMSTEND to begin and end the processing of a work request. A task can process only one work request at a time.

Note that a task may only join an enclave if it is not already part of an enclave. In particular, a subtask which inherited the enclave attribute from its mother task (which may happen either as a result of the mother task issuing IWMEJOIN or IWMSTBGN) is not allowed to use IWMEJOIN to explicitly join an enclave. This restriction is independent of whether the specified enclave is the same enclave as it is in, or a different enclave from the one it is in. Such a subtask which inherited the enclave attribute is also not allowed to use IWMELEAV to explicitly leave the enclave. The subtask would only leave the enclave upon its own (task) termination or when the enclave is deleted (IWMEDELE). Also, a task which successfully establishes a Begin environment (IWMSTBGN) may not invoke Enclave Join, nor is the task allowed to use Enclave Leave while this Begin environment exists.