IWMCONN – Connecting to Workload Management

The purpose of this service is to connect a calling address space to WLM. This service returns a token which is needed to invoke other services. This service can be used to:

• Request that WLM Work Management services be available to the connecting address space and optionally to pass topology information to WLM.
• Request that WLM Work Queuing services be available to the connecting address space.
• Request that WLM Work Execution services be available to the connecting address space.
• Request that WLM Work Balancing services be available to the connecting address space.
• Request that WLM export and import services be available to the connecting address space.

Note that:

• The space which is connected is the current home address space.
• Only a single connection is allowed to be active for a given address space at any given time.
• For each connected task/space, WLM will establish a dynamic resource manager (RESMGR) to be associated with the current task/space. When it receives control, it will free any accumulated resources and delete any enclaves associated with the connect token. This implies that the resource manager will logically perform the disconnect function and the connect token can no longer be passed to WLM services.