port_list statement

Use the port_list statement to specify a list of ports and the type of Workload Manager (WLM) recommendation that should be used for each.

Parameters

port_number

A numerical value that represents a valid port number. Keywords on the remainder of this statement are applied to all members that match this port number.

wlm

A keyword that is used to override the default WLM recommendation method that is specified or made the default by the wlm statement. See z/OS Communications Server: IP Configuration Guide for more information about WLM recommendation types.

basewlm

Specifies that WLM system weight recommendations are being used for determining the best candidates for workload balancing for all members with ports that match the port_number value.

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 CPU utilization uses zIIP processors.

For example, PROCTYPE CP 60 ZAAP 30 ZIIP 10, specifies a CPU usage pattern such that 60% uses conventional processors (CP), 30% uses zAAP processors, and 10% 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 are the WLM recommendation method to be used for determining the best candidates for workload balancing for all members with ports matching the port_number value. The actual WLM recommendation method used can be different than the configured method, depending on whether if each system reporting on members of the group supports server-specific WLM recommendations.