IWMPACT – Activating Service Policy

The Activate Service Policy routine is given control from the IWMPACT macro. The Activate Service Policy macro will complete the parameter list with caller–provided data and generate a stacking, program call to the activate policy service.

The purpose of this routine is to activate a service policy in the sysplex. The name of the service policy to be activated must be provided as input. The specified policy must exist in the current WLM service definition installed on the WLM couple data set.

The Activate Service Policy service causes a service policy to be activated synchronously. In other words, control will not be returned to the caller until the policy has been activated on all systems in the sysplex or for some reason the policy activation could not be completed.

Note that only a single policy activation request can be processed at any one time. Therefore, if a previous policy activation request is being processed and a new activation request is issued, the new request will be rejected with an appropriate return and reason code. This will occur regardless of whether the two requests were issued on the same system or different systems in the sysplex. The user can optionally request that the name of the system where another policy activation is taking place be returned in the variable specified in keyword SYSTEM_NAME.

The Activate Service Policy macro is provided in list, execute, and standard form. The list form accepts no variable parameters and is used only to reserve space for the activate policy parameter list. The standard form is provided for use with routines which do not require reentrant code. The execute form is provided for use with the list format for reentrant routines.