Activating a service policy

Use the VARY WLM command to activate a named service policy for a sysplex. The service policy must be defined in the workload management service definition and must have been previously installed on the WLM couple data set. In addition, each system in the sysplex must have connectivity to the WLM couple data set in order to participate in the service policy activation.

To activate a new policy, issue a VARY WLM command with the name of the policy you want to make active. This in effect makes the previous policy inactive.

You can also activate a workload management service policy by using the online ISPF administrative application. Refer to z/OS MVS Planning: Workload Management for more information or see your service administrator.

You can enter the VARY command on any system in the sysplex. This command activates the named service policy on all systems in the sysplex.

You can use the DISPLAY WLM command to check the service policy currently active for the sysplex. For example, before you activate a service policy, check which, if any, policy is active using the DISPLAY WLM command. After activating a service policy using the VARY command, you can confirm that the VARY command has taken effect by using the DISPLAY WLM command.

If you routinely activate service policies based on time-of-day or day-of-week, you can update automation packages with the commands.

Only one service policy can be in effect throughout all systems in a sysplex at any one time.

 
V WLM,POLICY=policyname[,REFRESH]

WLM,POLICY=policyname: Specifies the 1 to 8 character name of the service policy to be activated.
REFRESH: Specifies that WLM is to discard historical workload characterization data, reset to begin data collection anew, and activate the named policy.
Note: Use REFRESH only when directed to do so by IBM® Level 2 personnel.

The VARY WLM command is rejected if the named service policy does not exist. Contact your service administrator to determine the name of the desired service policy.

Example 1:

To activate a service policy named SHIFT1, enter:

V WLM,POLICY=shift1

The system responds with:

IWM001I WORKLOAD MANAGEMENT POLICY SHIFT1 NOW IN EFFECT

Example 2:

If you activate a service policy that does not exist, the command is rejected. If service policy WEEKEND does not exist and you enter:

V WLM,POLICY=weekend

The system responds with:

IWM003I VARY WLM FAILED, POLICY NAME WEEKEND NOT DEFINED