Question & Answer
Question
How to configure TCP/IP shareportwlm for Server load balancing.
Answer
TCP/IP's shareport or shareportwlm is the recommended approach to load balance workload across multiple Servers in a single LPAR. With shareport(wlm) all the balancing is done at the TCP/IP layer and the Server is unaware that any balancing is taking place.
To implement TCP/IP shareport(wlm) support the TCP/IP profile PORT definitions need to be updated to indicate that the specified TCP/IP port may be shared, example:
PORT
1200 TCP AVZ1 SHAREPORTWLM ; Server subsystem AVZ1
1200 TCP AVZ2 ; Server subsystem AVZ2
1200 TCP AVZ3 ; Server subsystem AVZ3
Only one instance of the port definition needs to be updated. For more information on configuring TCP/IP shareport(wlm) support and how work is distributed based on shareport or shareportwlm, please reference the IBM z/OS Communications Server: IP Configuration Reference manual.
The Server will also report on it's health to WLM in order to allow WLM to better manage which Server to pass an inbound connection to when using shareportwlm. In order for the Server to report on its health to WLM, the Server parameter WLMHEALTHREPORT must be set to YES, which is the default. An informational message is available with the Server WLMHEALTHREPORT support to indicate when the health reporting of the Server is changed.
1200 TCP AVZ1 SHAREPORTWLM ; Server subsystem AVZ1
1200 TCP AVZ2 ; Server subsystem AVZ2
1200 TCP AVZ3 ; Server subsystem AVZ3
Only one instance of the port definition needs to be updated. For more information on configuring TCP/IP shareport(wlm) support and how work is distributed based on shareport or shareportwlm, please reference the IBM z/OS Communications Server: IP Configuration Reference manual.
The Server will also report on it's health to WLM in order to allow WLM to better manage which Server to pass an inbound connection to when using shareportwlm. In order for the Server to report on its health to WLM, the Server parameter WLMHEALTHREPORT must be set to YES, which is the default. An informational message is available with the Server WLMHEALTHREPORT support to indicate when the health reporting of the Server is changed.
Example:
AVZ1DB0724I Server AVZ1 WLM health changed from 100% to 90%
Depending on how severe the error or rate of errors, the health setting percentage may be reduced further and additional messages issued.
Once the health of the Server increases an additional message will be produced:
AVZ1DB0724I Server AVZ1 WLM health changed from 90% to 100%
AVZ1DB0724I Server AVZ1 WLM health changed from 100% to 90%
Depending on how severe the error or rate of errors, the health setting percentage may be reduced further and additional messages issued.
Once the health of the Server increases an additional message will be produced:
AVZ1DB0724I Server AVZ1 WLM health changed from 90% to 100%
Events that can affect the Server's health report include any transaction or server. Check the Server Trace Browse at the time of the message to find out the cause why the WLM health suddenly dropped.
NOTE:
Although shareport or shareportwlm may not be in use, the WLMHEALTHREPORT messages are still reported if WLMHEALTHREPORT is set to YES.
No change is required to be made to the Server xDByIN00 to support shareport(wlm).
NOTE:
Although shareport or shareportwlm may not be in use, the WLMHEALTHREPORT messages are still reported if WLMHEALTHREPORT is set to YES.
No change is required to be made to the Server xDByIN00 to support shareport(wlm).
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS4NKG","label":"IBM Data Virtualization Manager for z\/OS"},"Component":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}},{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSKRKK","label":"IBM Db2 Analytics Accelerator Loader for z\/OS"},"ARM Category":[{"code":"a8m0z0000001hBeAAI","label":"Db2 Analytics Accelerator Loader for z\/OS"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB10","label":"Data and AI"}},{"Business Unit":{"code":"BU016","label":"Multiple Vendor Support"},"Product":{"code":"SGMV22","label":"IBM Support for Apache Spark"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB61","label":"IBM Technology Lifecycle Services"}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCRPN9","label":"QMF Data Service"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"","label":""}}]
Was this topic helpful?
Document Information
Modified date:
02 October 2020
UID
ibm16220727