IWMSRDRS – Deregister a Server for Sysplex Routing

IWMSRDRS will deregister a server that had previously registered via IWMSRSRG, the Sysplex Router Registration macro, for sysplex workload balancing. Deregistration removes the specified server as a candidate from the Sysplex Routing Selection service, IWMSRSRS. Since the propagation of the deregistration to other systems is asynchronous, a newly deregistered triplet will continue to be eligible for selection by other systems for a period of time after return from the IWMSRDRS invocation. If the server was registered with a host name the caller must provide the host name in order to deregister the server.

Important Note

With APAR OW33878 installed, new security checks are added to the module this service invokes (as well as to the register module invoked by IWMSRSRG). With this APAR installed, the security checks are invoked when the caller is in Problem state, and does not own any privileged keys (i.e. has none of the authorization key mask bits 0-7 turned on). In this case, the caller must fullfil following three conditions to use this service:

The caller must not be in cross-memory mode
The caller must not have an EUT FRR established
The caller must be authorized in the BPX.WLMSERVER profile in the facility class