The Policy Agent interacts with the sysplex distributor
to assist with workload balancing.
Procedure
Perform the following steps to enable Policy Agent load
distribution functions:
- Define the PolicyPerfMonitorForSDR statement in the PAGENT
configuration file to enable the policy performance monitor function. This function must be active on the target and distributing
stacks.
- z/OS® Communications
Server load
distribution needs to be specifically enabled for each service level;
a Policy Action with the same service level name needs to be defined
on each of the appropriate target stacks and also on the distributing
stack for these targets. Note that it is reasonable to
have a subset of key service level names defined to the distributing
stack. Traffic mapping to those service level names that are defined
to the distributing stack will receive z/OS Communications
Serverload
distribution by service level. All other traffic will receive Communications
Server V2R10 load distribution.
- A backup distributing stack must have the same Policy Action
configuration definitions as the active distributing stack for the
corresponding DVIPA targets that it is backing up, if you want the
Policy Action behavior to stay the same when the backup distributing
stack takes ownership of the DVIPA. It also must have the Policy Agent
performance monitor function active.
- Common PAGENT port numbers will be used by the listener
(pagentQosListener) and the collector (pagentQosCollector) They
are part of the /etc/services install file. If PAGENT is running
on an LPAR containing a target stack, it will open a listening connection
using the pagentQosListener port number. PAGENT running on an LPAR
containing a distributing stack will establish a TCP connection with
each PAGENT listener using the pagentQosCollector as the source port
and the pagentQosListener as the destination port. The listener will
fail a connect request if the source/destination port does not match
the defined collector/listener port. The /etc/services file on all
LPARs in the sysplex must be updated to contain these port numbers.
- Define these two port numbers as reserved ports for PAGENT
using the PORT statement in the PROFILE.TCPIP data set.
- Define the DYNAMICXCF parameter on the IPCONFIG or IPCONFIG6
statements in PROFILE.TCPIP. The PAGENT TCP connections
use the XCF IP addresses.