IWMSINF — WLM Server Manager Inform Service

The IWMSINF service should be used to obtain the number of server instances to be started from WLM. The caller must have previously connected to WLM using the IWM4CON service specifying SERVER_MANAGER=YES, SERVER_TYPE=QUEUE and MANAGE_TASKS=YES.

The caller can use the service in the following ways:

1. MODE=SUSPEND

   The calling task is suspended until WLM wants the caller to start additional server instances. The caller must re-invoke the service after it starts the server instances to wait for the next notification. The caller cannot rely upon asynchronous exits receiving control while the task is suspended.

2. MODE=POST

   The calling task is not suspended by WLM. WLM returns the number of additional server instances to start now. WLM will post the caller's ECB when the number of server instances should be increased. After the ECB is posted the caller must re-invoke IWMSINF to obtain the number of server instances to start.

3. MODE=INFORM

   The calling task is not suspended by WLM. WLM returns the number of additional server instances to start now. This form should only be used the first time the service is invoked immediately after connect because at this time the service will always return a value.

4. MODE=ECBCANCEL

   The calling task is not suspended by WLM. This invocation should only be used to inform WLM that it should not post a caller's ECB any more. The form can be used for error recovery purposes in conjunction with MODE=POST.

WLM stops server instances by returning reason code IwmRsnCodeStopTask from IWM4SSL.