wlm statement

Use the wlm statement to specify the default Workload Manager (WLM) recommendation method that is used for each member, unless overridden on a per-port basis by the port_list statement. For more details about WLM recommendation types, see Customizing optional statements in z/OS Communications Server: IP Configuration Guide.

This statement is optional, and the default is basewlm.

Parameters

basewlm

Specifies that WLM system weight recommendations should be used to determine the best candidates for workload balancing.

proctype

For workloads that use server-specific WLM weights, WLM typically returns a composite raw weight that takes into consideration how well the server is meeting its WLM goals with respect to the various types of processors the server is using.

For workloads that use WLM system weight recommendations, WLM is unaware of how a resource is using the various processors. Instead, WLM returns a weight for each processor type that is based on the amount of displaceable capacity for this processor in this system as compared to the available capacity for this processor on the other target systems.

For applications that use specialty processors and receive WLM system weight recommendations, specify the proctype parameter to indicate the expected proportion of each type of processor that the target application's workloads should use. A composite recommendation is determined from these proportions. Express® each of the proportions as a number in the range 0 - 99. Each proportion value is divided by the total to determine the processor usage pattern; see the example that follows. To determine the processor proportions to configure, study your workload usage of assist processors by analyzing SMF records, using performance monitors reports, such as RMF™, and so on.

For example, the proctype value CP 5 zAAP 0 zIIP 3 specifies a processor usage pattern such that 5/8 of the application's processor uses conventional processors (CP), and 3/8 of the application's processor uses zIIP processors.

zAAPs and zIIPs are specialty processors designed to offload specific application workloads. Some target applications can take advantage of these specialty processors. For workloads that use server-specific WLM weights, WLM typically returns a composite raw weight that takes into consideration how well the server is meeting its WLM goals with respect to the various types of processors the server is using. For workloads that use the system-wide WLM recommendation, WLM is unaware of how a resource is using the various processors. Instead, WLM returns a weight for each processor type that is based on the amount of displaceable capacity for this processor in the system as compared to the available capacity for this processor on the other target systems.

Possible values are:

CP x

The proportion of the workload that uses conventional processors.

zAAP y

The proportion of the workload that uses zAAP processors.

zIIP z

The proportion of the workload that uses zIIP processors.

Requirement: If you specify a proctype value, it must be followed by braces (each brace on a separate line and each processor type and its value on a separate line). Each processor type parameter is optional; however, at least one processor type and its value must be coded. Each processor type can be specified in any order. When specified, each processor type must be specified with a value. Each processor type parameter and its value must be specified on separate lines.

Restrictions: When processor types are specified, at least one type must be specified with a nonzero value.

When you specify a proctype value on this statement, all proctype values on WLM statements are overridden. If you do not specify a processor type, the value 0 is assumed for that processor type.

serverwlm

Specifies that server-specific WLM recommendations should be used to determine the best candidates for workload balancing. The actual WLM recommendation method used can be different than the configured method, depending whether each system that reports on members of the group supports server-specific WLM recommendations.

Result: zAAP and zIIP processor capacity is automatically included when the SERVERWLM parameter is specified and all systems in the sysplex are V1R9 or later.