Verifying sysplex distributor workload

You can use the Netstat VDPT/-O and VCRT/-V report options to verify sysplex distributor workload. See z/OS Communications Server: IP System Administrator's Commands for more information on these commands.

Use the Netstat VDPT/-O report option with the DETAIL modifier on the distributing stack to confirm that there are target stacks available with server applications ready. This display will show only target stacks that are currently up and have joined the sysplex. The RDY field indicates how many, if any, applications the target TCP/IP, identified by its DestXCF Addr, has bound to DPort. If none, then this target TCP/IP will not receive any connection workload. The TotalConn field indicates how many connections this distributing TCP/IP has forwarded to the target TCP/IP. The ActiveConn field indicates how many connections the distributing TCP/IP has forwarded to the target TCP/IP that are currently active.

Tip: TotalConn is an historical count and will wrap.

The following Netstat display command on the distributing stack, TCPCS, shows which target stacks are available with the server applications ready.

NETSTAT VDPT DETAIL
                                                                                
MVS TCP/IP NETSTAT CS V1R8       TCPIP Name: TCPCS           15:37:51           
Dynamic VIPA Destination Port Table:                                            
Dest:        201.2.10.11..21                                                    
  DestXCF:   201.1.10.15                                                        
  TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 075                             
  Flg: Dynamic, Roundrobin, Inactive                                            
    TCSR: 100 CER: 075 SEF: 100    
    Abnorm: 00         Health: 100                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 01                                                                   
Dest:        201.2.10.12..4011                                                  
  DestXCF:   201.1.10.15                                                        
  TotalConn: 0000000000  Rdy: 001  WLM: 02 TSR: 100                             
  Flg: Roundrobin                                                               
    TCSR: 100 CER: 100 SEF: 100                                                 
    Abnorm: 00         Health: 100                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 00                                                                   
    QosPlcAct: paPRD-SD-7-INTR-DONTCARE                                         
      W/Q: 02                                                                   
Dest:        201.2.10.12..4011                                                  
  DestXCF:   201.2.10.10                                                        
  TotalConn: 0000000000  Rdy: 001  WLM: 02 TSR: 050                             
  Flg: Roundrobin, Inactive                                                     
    TCSR: 067 CER: 075 SEF: 100                                                 
    Abnorm: 00         Health: 100                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT* 
      W/Q: 01
    QosPlcAct: paPRD-SD-7-INTR-DONTCARE                                         
      W/Q: 02                                                                   
Dest:        201.2.10.13..243                                                   
  DestXCF:   201.3.10.16                                                        
  TotalConn: 0000000000  Rdy: 001  WLM: 02 TSR: 085                             
  Flg: BaseWLM                                                                  
    TCSR: 100 CER: 095 SEF: 090                                                 
    Abnorm: 00         Health: 100
    Weight 50     
      Raw           CP:  50 zAAP: 00 zIIP: 63
      Proportional  CP:  50 zAAP: 00 zIIP: 00                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 02
Dest:        201.2.10.23..4000                                                  
  DestXCF:   201.3.10.16                                                        
  TotalConn: 0000000000  Rdy: 001  WLM: 15 TSR: 100
  Flg: BaseWLM                                                                  
    TCSR: 100 CER: 100 SEF: 100
    Abnorm: 00         Health: 100                                    
    Weight 60     
      Raw           CP:  50 zAAP: 00 zIIP: 63
      Proportional  CP:  10 zAAP: 00 zIIP: 50                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 02                                                                   
DestIntf:                                                                       
  Dest:        2001:0db8::522:f103..20                                          
    DestXCF:   2001:0db8::943:f003                                              
    TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 094                           
    Flg: BaseWLM Local                                                 
    TCSR: 099 CER: 098 SEF: 097                                                 
    Abnorm: 00         Health: 100
    Weight 4     
      Raw           CP:  20 zAAP: 00 zIIP: 00
      Proportional  CP:  04 zAAP: 00 zIIP: 00                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 00                                                                   
DestIntf:                                                                       
  Dest:        2001:0db8::522:f103..21                                          
    DestXCF:   2001:0db8::943:f003                                              
    TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 100                           
    Flg: Roundrobin                                                     
    TCSR: 100 CER: 100 SEF: 100                                                 
    Abnorm: 00         Health: 100                                             
  ActiveConn: 0000000000                                                        
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 01

The target stack is identified by its dynamic XCF address (DESTXCF).
The RDY field indicates how many applications on that target stack have bound to the DEST port.
TOTALCONN is the number of all connections the distributing stack, TCPCS, has routed to the target stack.
The ACTIVECONN value is the number of currently active connections that the distributing stack, TCPCS, has routed to the target stack. The active connections include all TCP connections that the target TCP/IP stack is still aware of, even if the connections are in the process of terminating. For example, connections in FIN_WAIT2 or TIMEWAIT states are also included in this count.
The ABNORM value is the rate of abnormal terminations for this server. This field affects the WLM weight and the operation of the OPTLOCAL distributor setting.
The HEALTH value is the health indicator for this server. This field affects the WLM weight and the operation of the OPTLOCAL distributor setting.
WLM is the normalized workload manager weight value for the target TCP/IP stack.

Weight is the raw composite weight for the target TCP/IP stack. The composite weight is based on the application's general CPU usage, the System z® Application Assist Processor (zAAP) usage, and the System z Integrated Information Processor (zIIP) usage, as shown in Table 1.

Table 1. Weight determination
Processor	DISTMETHOD BASEWLM	DISTMETHOD SERVERWLM
CP	The `Raw` value is the raw WLM system general CP weight. The `Proportional` value is the `Raw` value modified by the expected CP usage proportion configured on the VIPADISTRIBUTE PROCTYPE statement for this application.	The `Raw` value is the raw WLM server-specific general CP weight. The `Proportional` value is the `Raw` value modified by the proportion of CP capacity that is currently being consumed by the application's workload, as compared to the other processors (zIIP and zAAP).
zAAP	The `Raw` value is the raw WLM system zAAP weight. The `Proportional` value is the `Raw` value modified by the expected zAAP usage proportion configured on the VIPADISTRIBUTE PROCTYPE statement for this application.	The `Raw` value is the raw WLM server-specific zAAP weight. The `Proportional` value is the `Raw` value modified by the proportion of zAAP capacity that is currently being consumed by the application's workload, as compared to the other processors (CP and zIIP).
zIIP	The `Raw` value is the raw WLM system zIIP weight. The `Proportional` value is the `Raw` value modified by the expected zIIP usage proportion configured on the VIPADISTRIBUTE PROCTYPE statement for this application.	The `Raw` value is the raw WLM server-specific zIIP weight. The `Proportional` value is the `Raw` value modified by the proportion of zIIP capacity that is currently being consumed by the application's workload, as compared to the other processors (CP and zAAP).

FLG is a flag field indicating how the connection was distributed. For example, the value DYNAMIC indicates this DVIPA is being distributed by the dynamic port assignment function.
The target server responsiveness (TSR) field indicates how well a target server is accepting TCP connection setup requests. A value of 100 indicates that the target server is accepting all TCP connection setup requests successfully. A value of 0 indicates that the target server is accepting no TCP connection setup requests successfully. A value between 100 and 0 indicates the relative success rate of TCP connection setup requests for this target server.

When weighted active distribution is being used, the configured active connection weight for each target is shown as the WLM value in the Netstat VDPT/-O display. By using the DETAIL modifier on the display, the active connection counts (ActiveConn) are shown. The distributor balances incoming connection requests across the targets with a goal of having the number of active connections on each target proportionally equivalent to the configured active connection weight of each target.

d tcpip,tcpcs,net,vdpt,detail
DEST:        201.2.10.15..5000
  DESTXCF:   193.9.200.2
  TOTALCONN: 0000021015  RDY: 001  WLM: 10   TSR: 100
  FLG: WeightedActive
    TCSR: 100 CER: 100 SEF: 100                                                 
    Abnorm: 00         Health: 100   
                                          
    ActiveConn: 0000001555   
                                                     
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 00                                                                   
      
DEST:        201.2.10.15..5000
  DESTXCF:   193.9.200.2
  TOTALCONN: 0000044015  RDY: 002  WLM: 20   TSR: 100
  FLG: WeightedActive
    TCSR: 100 CER: 100 SEF: 100                                                 
    Abnorm: 00         Health: 100    
                                         
    ActiveConn: 0000003100     
                                                   
    QosPlcAct: *DEFAULT*                                                        
      W/Q: 00

The following Netstat display command on the distributing stack displays all current connections being distributed by TCPCS.

d tcpip,tcpcs,net,vcrt   
EZD0101I NETSTAT CS V1R8 TCPCS 844    
DYNAMIC VIPA CONNECTION ROUTING TABLE:
DEST:      201.2.10.11..21            
  SOURCE:  193.9.200.5..1029          
  DESTXCF: 193.9.200.1
DEST:      201.2.10.11..21            
  SOURCE:  193.9.200.8..1050          
  DESTXCF: 193.9.200.2                
DEST:      201.2.10.11..21            
  SOURCE:  193.9.200.11..1079          
  DESTXCF: 193.9.200.3
DEST:      201.2.10.12..21            
  SOURCE:  193.9.200.9..1030          
  DESTXCF: 193.9.200.2
DEST:      2001:0DB8:1::1..21            
  SOURCE:  2001:0DB8::151:0006..1038          
  DESTXCF: 2001:0DB8::151:0003
END OF THE REPORT

For more details, see z/OS Communications Server: IP System Administrator's Commands.