IWM4STBG macro — WLM Begin Server Transaction Service

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

Use IWM4STBG together with IWM4STEN 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 IWM4STBG) 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 (IWM4EDEL). 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.