IWMSRFSV macro — Sysplex Routing Find Server Routine

IWMSRFSV will find a server associated with the specified application environment and return the associated server data which was passed at the time the server connected to WLM (via IWM4CON). The only eligible servers are those that have connected to WLM with a specification of IWM4CON SERVER_MANAGER=YES,SERVER_TYPE=ROUTING, and whose application environment matches the input value passed to IWMSRFSV, which implies that the server belongs to the same subsystem type as the caller. The server chosen is considered a best choice to run work in terms of a variety of system conditions which are monitored.

When no eligible servers are already started, and the service policy allows MVS to start a server, and certain other conditions apply, MVS will start a new server on behalf of the request. Circumstances such as this imply that the program calling this service may be suspended until the request can be resolved. When no eligible servers exist and none can be started the caller will receive a return code to reflect this.