Netstat VDPT/-O report

This report displays the dynamic VIPA destination port table information. The command first displays information about distribution to TCP/IP stacks; this section of the report applies to Base targets, tier 1 targets that are not configured to use GRE routing, and tier 2 targets. The command then displays information about distribution to non-z/OS targets; this section of the report applies to tier 1 targets that are configured to use Generic Routing Encapsulation (GRE) routing. The destination port tables exist only on distributing stacks, which are stacks on which a VIPADISTRIBUTE DEFINE keyword was specified.

TSO syntax


>>---NETSTAT VDPT--| Modifier |--| Target |--| Output |--| (Filter |---><

Modifier


>>-DETAIL------------------------------------------------------><

DETAIL

Displays the general dynamic VIPA destination port table information plus the Workload Manager weight value and QoS policy action name information as follows:

The component values of the target server responsiveness (TSR) value
The count of currently active connections
The Workload Manager weight value and QoS policy action name information

Target

Provide the report for a specific TCP/IP address space by using TCp tcpname. See The Netstat command target for more information about the TCp parameter.

Output

The default output option displays the output on the user's terminal. For other options, see The TSO NETSTAT command syntax or Netstat command output.

Filter


             .-----------------------.     
             V                       |     
>>-+-IPAddr----+-ipaddr------------+-+-+-----------------------><
   |           +-ipaddr/prefixLen--+   |   
   |           '-ipaddr/subnetmask-'   |   
   |         .----------------.        |   
   |         V                |        |   
   +-IPPort----ipaddr+portnum-+--------+   
   |       .-------------.             |   
   |       V             |             |   
   '-POrt------portnum---+-------------'

z/OS UNIX syntax


>>---netstat -O--| Modifier |--| Target |--| Output |--| Filter |---><

Modifier


>>-DETAIL------------------------------------------------------><

DETAIL

Displays the general dynamic VIPA destination port table information plus the Workload Manager weight value and QoS policy action name information as follows:

The component values of the target server responsiveness (TSR) value
The count of currently active connections
The Workload Manager weight value and QoS policy action name information

Target

Provide the report for a specific TCP/IP address space by using -p tcpname. See The Netstat command target for more information about the TCp parameter.

Output

The default output option displays the output to z/OS UNIX shell stdout. For other options, see The z/OS UNIX netstat command syntax or Netstat command output.

Filter


          .----------------.            
          V                |            
>>-+- -B----ipaddr+portnum-+--------+--------------------------><
   |      .-----------------------. |   
   |      V                       | |   
   +- -I----+-ipaddr------------+-+-+   
   |        +-ipaddr/prefixLen--+   |   
   |        '-ipaddr/subnetmask-'   |   
   |      .-------------.           |   
   |      V             |           |   
   '- -P------portnum---+-----------'

Filter description

IPAddr/-I ipaddrIPAddr/-I ipaddr/prefixlengthIPAddr/-I ipaddr/subnetmask: Filter the report output using the specified IP address ipaddr, ipaddr/prefixlength, or ipaddr/subnetmask. You can enter up to six filter values. Each specified IPv4 ipaddr value can be up to 15 characters in length and each selected IPv6 ipaddr value can be up to 45 characters in length.

ipaddr: Filter the output of the VDPT/-O report using the specified IP address ipaddr. For IPv4 addresses, the default subnet mask of 255.255.255.255 is used. For IPv6 addresses, the default prefixlength of 128 is used.

ipaddr/prefixlength: Filter the output of the VDPT/-O report using the specified IP address and prefix length ipaddr/prefixlength. For an IPv4 address, the prefix length range is 1 – 32. For an IPv6 address, the prefix length range is 1 – 128.

ipaddr/subnetmask

Filter the output of the VDPT/-O report using the specified IP address and subnet mask ipaddr/subnetmask. The IP address ipaddr in this format must be an IPv4 IP address.

Guidelines:

The filter value ipaddr can be a destination IP address, or a destination XCF IP address.
For an IPv6-enabled stack:
- Both IPv4 and IPv6 ipaddr values are accepted and can be mixed on the IPAddr/-I option.
- An IPv4-mapped IPv6 address is accepted as a valid ipaddr value and will usually provide the same result as its IPv4 address.

Restrictions:

The IPAddr/-I option for VDPT/-O report does not support wildcard characters.
For an IPv4-only stack, only IPv4 ipaddr values are accepted.
For a UDP endpoint socket, the filter value applies only to the local or source IP address.

IPPort/-B ipaddr+portnum

Filter the report output of the VDPT/-O report using the specified IP address and port number. You can enter up to six filter values. Each specified IPv4 ipaddr value can be up to 15 characters in length, denoting a single IPv4 IP address; each specified IPv6 ipaddr value can be up to 45 characters in length, denoting a single IPv6 IP address. Valid portnum values are in the range 0 – 65 535. The filter values ipaddr and portnum will match any combination of the local and remote IP address and local and remote port.

Guidelines:

The filter value ipaddr can be a destination IP address, or a destination XCF IP address.
For an IPv6-enabled stack, the following apply:
- Both IPv4 and IPv6 ipaddr values are accepted and can be mixed on the IPPort/-B option.
- An IPv4-mapped IPv6 address is accepted as a valid ipaddr value and usually provides the same result as the IPv4 address.
- For a UDP endpoint socket, the filter value applies only to the local or source IP address and port.

Restrictions:

The ipaddr value in the IPPort/-B filter does not support wildcard characters.
For an IPv4-only stack, only IPv4 ipaddr values are accepted.
An entry is returned only when both the ipaddr and portnum values match.

POrt/-P portnum: Filter the output of the VDPT/-O report using the specified port number portnum. You can enter up to six filter values.
Guideline: The port number can be either a local or remote port.

Restriction: For a UDP endpoint socket, the filter value applies only to the local or source port.

Command syntax examples

From TSO environment

NETSTAT VDPT
Displays the dynamic VIPA Destination Port Table information in the default TCP/IP 
stack. 
NETSTAT VDPT TCP TCPCS6    
Displays the dynamic VIPA Destination Port Table information in the TCPCS6 stack.

From UNIX shell environment

   netstat -O
   netstat -O -p tcpcs6

Report examples

The following examples are generated using the TSO NETSTAT command. Using the z/OS UNIX netstat command displays the data in the same format as the TSO NETSTAT command.

Not IPv6 enabled (SHORT format)

NETSTAT VDPT

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           15:35:26
Dynamic VIPA Destination Port Table for TCP/IP Stacks:                            
Dest IPaddr     DPort DestXCF Addr    Rdy TotalConn  WLM TSR  Flg    
-----------     ----- ------------    --- ---------  --- ---  ---    
201.2.10.11     00021 201.1.10.15     001 0000310485 01  075  DI    
201.2.10.13     00243 201.3.10.16     001 0000256794 03  085        
201.2.10.14     00244 201.3.10.16     000 0000000000 15  100  1
201.2.10.15     05000 201.3.10.15     001 0000034011 10  100  
201.2.10.18     04040 201.3.10.16     001 0000063421 30  100  2
201.2.10.18     04040 201.3.10.15     001 0000019011 07  100  2
201.4.10.15     07000 201.3.10.16     001 0000094011 10  100  V
201.4.10.15     07000 201.3.10.17     001 0000000000 10  100  K

Dynamic VIPA Destination Port Table for non-z/OS targets: 
Dest IPaddr     DPort Target Addr    Rdy TotalConn  Wt  CWt  Flg   
-----------     ----- ------------   --- ---------  --- ---  ---    
201.2.10.21     03000 205.1.10.15    001 0000310485 01  100  I   
201.2.10.22     04011 205.2.10.10    001 0000103162 01  075        
201.2.10.22     04011 205.2.10.12    001 0000102658 01  075       
201.2.10.25     05000 204.3.10.15    001 0000034011 10  100

NETSTAT VDPT DETAIL

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           15:35:26           
Dynamic VIPA Distribution Port Table for TCP/IP Stacks:                                           
Dest IPaddr     DPort DestXCF Addr    Rdy TotalConn  WLM TSR  Flg               
-----------     ----- ------------    --- ---------  --- ---  ---               
201.2.10.11     00021 201.1.10.15     001 0000310485 01  075  DI               
  DistMethod: Roundrobin
  TCSR: 100  CER: 075 SEF: 075                                                   
  ActConn:    0000000042                                                          
201.2.10.13     00243 201.3.10.16     001 0000256794 03  090                   
  DistMethod: BaseWLM
  TCSR: 100  CER: 095 SEF: 090                                                   
  Weight: 12                                                        
    Raw          CP: 13 zAAP: 00 zIIP: 10
    Proportional CP: 08 zAAP: 00 zIIP: 04
  ActConn:    0000000091
  QosPlcAct:  *DEFAULT*                                       W/Q: 01          
201.2.10.14     00244 201.3.10.16     000 0000000000 15  090  1
  DistMethod: ServerWLM
  TCSR: 100  CER: 095  SEF: 090
  Weight: 60                                                        
    Raw          CP: 60 zAAP: 00 zIIP: 60
    Proportional CP: 06 zAAP: 00 zIIP: 54
  Abnorm: 0000         Health: 100
  ActConn:    0000000000
  QosPlcAct:  *DEFAULT*                                       W/Q: 01
201.2.10.15     05000 201.3.10.15     001 0000034011 10  100  A
  DistMethod: WeightedActive
  TCSR: 100  CER: 100  SEF: 100
  Abnorm: 0000         Health: 100
  ActConn:    0000003011
201.2.10.18     04040 201.3.10.16     001 0000063421 30  100  2
  DistMethod: ServerWLM
  TCSR: 100 CER: 100 SEF: 100
  Abnorm: 0000       Health: 100
  ActConn:    0000006006
201.2.10.18     04040 201.3.10.15     001 0000019011 07  100  2
  DistMethod: ServerWLM
  TCSR: 100 CER: 100 SEF: 100
  Abnorm: 0000       Health: 100
  ActConn:    0000003006
201.4.10.15     07000 201.3.10.16     001 0000094011 10  100  V 
  DistMethod: HotStandby              SrvType: Preferred 
  TCSR: 100  CER: 100  SEF: 100
  Abnorm: 0000         Health: 100
  ActConn:    0000001011
201.4.10.15     07000 201.3.10.17     001 0000000000 10  100  K
  DistMethod: HotStandby              SrvType: Backup  
  TCSR: 100  CER: 100  SEF: 100
  Abnorm: 0000         Health: 100
  ActConn:    0000000000

Dynamic VIPA Destination Port Table for non-z/OS targets:
Dest IPaddr     DPort Target Addr    Rdy TotalConn  Wt  CWt  Flg              
-----------     ----- ------------   --- ---------  --- ---  ---               
201.2.10.21     03000 205.1.10.15    001 0000310485 01  100  I              
  DistMethod: Roundrobin
  T1Wt: 33                                           
  ActConn:    0000000042        
201.2.10.22     04011 205.2.10.10    001 0000103162 01  075        
  DistMethod: TargCtrl
  T1Wt: 54                                                     
  ActConn:    0000000834
201.2.10.22     04011 205.2.10.12    001 0000102658 01  075      
  DistMethod: TargCtrl
  T1Wt: 25                                                        
  ActConn:    0000000091
201.2.10.25     05000 204.3.10.15    001 0000034011 10  100  
  DistMethod: WeightedActive
  T1Wt: 62                                                        
  ActConn:    0000001021

IPv6 enabled or request for LONG format

NETSTAT VDPT

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           15:37:51
Dynamic VIPA Destination Port Table for TCP/IP Stacks:                                 
Dest:        201.2.10.11..21                                         
  DestXCF:   201.1.10.15                                      
  TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 075 
  DistMethod: Roundrobin
  Flg: Dynamic, Inactive
Dest:        201.2.10.13..243                                
  DestXCF:   201.3.10.16                                      
  TotalConn: 0000000000  Rdy: 001  WLM: 08 TSR: 085  
  DistMethod: BaseWLM
  Flg:    
Dest:        201.2.10.14..244 
  DestXCF:   201.3.10.16 
  TotalConn: 0000000000  Rdy: 001  WLM: 15 TSR: 090 
  DistMethod: ServerWLM
  Flg: Tier1 
Dest:        201.2.10.15..5000                         
  DestXCF:   201.3.10.15                                                 
  TotalConn: 0000034011  Rdy: 001  WLM: 10 TSR: 100                      
  DistMethod: WeightedActive
  Flg:  
Dest:        201.2.10.18..4040
  DestXCF:   201.3.10.16
  TotalConn: 0000063421  Rdy: 001  WLM: 30 TSR: 100
  DistMethod: ServerWLM
  Flg: Tier2
Dest:        201.2.10.18..4040
  DestXCF:   201.3.10.15
  TotalConn: 0000019011  Rdy: 001  WLM: 07 TSR: 100
  DistMethod: ServerWLM
  Flg: Tier2
Dest:        201.4.10.15..7000
  DestXCF:   201.3.10.16
  TotalConn: 0000094011  Rdy: 001  WLM: 10 TSR: 100
  DistMethod: HotStandby           SrvType: Preferred
  Flg: Active
Dest:        201.4.10.15..7000
  DestXCF:   201.3.10.17
  TotalConn: 0000000000  Rdy: 001  WLM: 10 TSR: 100
  DistMethod: HotStandby           SrvType: Backup
  Flg: Backup
DestIntf:                                   
  Dest:        2001:0db8::522:f103..20           
    DestXCF:   2001:0db8::943:f003               
    TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 094
    DistMethod: BaseWLM
    Flg:                             
DestIntf:                                   
  Dest:        2001:0db8::522:f103..21           
    DestXCF:   2001:0db8::943:f003               
    TotalConn: 0000000000  Rdy: 001  WLM: 15 TSR: 100
    DistMethod: ServerWLM
    Flg:

Dynamic VIPA Destination Port Table for non-z/OS targets:
Dest:        201.2.10.21..3000                                         
  Target Addr: 205.1.10.15                                     
  TotalConn: 0000310485  Rdy: 001  Wt: 01 CWt: 100 
  DistMethod: Roundrobin
  Flg: Inactive                                                                     
Dest:        201.2.10.22..4011                                
  Target Addr: 205.2.10.10                                      
  TotalConn: 0000103162  Rdy: 001  Wt: 01 CWt: 075  
  DistMethod: TargCtrl
  Flg:               
Dest:        201.2.10.22..4011                                
  Target Addr: 205.2.10.12                                      
  TotalConn: 0000102658  Rdy: 001  Wt: 01 CWt: 075  
  DistMethod: TargCtrl
  Flg:      
Dest:        201.2.10.25..5000                          
  Target Addr: 204.3.10.15                                                
  TotalConn: 0000034011  Rdy: 001  Wt: 10 CWt: 100                      
  DistMethod: WeightedActive
  Flg:  
DestIntf: INTFNAMB
  Dest: 2001:0db8::522:f222..8000
    Target Addr: 2001:0db8::540:f301
    TotalConn: 0000000000  Rdy: 001  Wt: 14 CWt: 100
    DistMethod: TargCtrl
    Flg: 
DestIntf: INTFNAMB
  Dest: 2001:0db8::522:f222..8000
    Target Addr: 2001:0db8::540:f302
    TotalConn: 0000000000  Rdy: 001  Wt: 14 CWt: 075
    DistMethod: TargCtrl
    Flg:

NETSTAT VDPT DETAIL

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           15:37:51
Dynamic VIPA Destination Port Table for TCP/IP Stacks:                                 
Dest:        201.2.10.11..21                                         
  DestXCF:   201.1.10.15                                      
  TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 075  
  DistMethod: Roundrobin
  Flg: Dynamic, Inactive
  TCSR: 100  CER: 075 SEF: 100
  ActConn:   0000000000 
Dest:        201.2.10.13..243                                
  DestXCF:   201.3.10.16                                      
  TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 090  
  DistMethod: BaseWLM
  Flg:    
  TCSR: 100  CER: 095 SEF: 090
  Weight: 12                           
    Raw          CP: 13 zAAP: 00 zIIP: 10
    Proportional CP: 08 zAAP: 00 zIIP: 04
  ActConn:   0000000000
  QosPlcAct: *DEFAULT*                                     
    W/Q: 01                                                
Dest: 201.2.10.14..244
  DestXCF: 201.3.10.16 
  TotalConn: 0000000000 Rdy: 001 WLM: 15 TSR: 090 
  DistMethod: ServerWLM
  Flg: Tier1  
  TCSR: 100  CER: 095 SEF: 090 
  Weight: 60            
    Raw          CP: 50 zAAP: 00 zIIP: 61
    Proportional CP: 05 zAAP: 00 zIIP: 55
  Abnorm: 0000        Health: 100
  ActConn:   00000000
  QosPlcAct: *DEFAULT* 
    W/Q: 15 
Dest: 201.2.10.15..5000 
  DestXCF: 201.3.10.15    
  TotalConn: 0000034011 Rdy: 001 WLM: 10 TSR: 100
  DistMethod: WeightedActive
  Flg:  
  TCSR: 100 CER: 100 SEF: 100
  Abnorm: 0000       Health: 100
  ActConn:      00003011
Dest:        201.2.10.18..4040
  DestXCF:   201.3.10.16
  TotalConn: 0000063421  Rdy: 001  WLM: 15 TSR: 100
  DistMethod: ServerWLM
  Flg: Tier2
  TCSR: 100 CER: 100 SEF: 100
  Weight: 60
    Raw          CP: 60 zAAP: 00 zIIP: 00
    Proportional CP: 60 zAAP: 00 zIIP: 00
  Abnorm: 0000       Health: 100
  ActConn:   00006006
  QosPlcAct: *DEFAULT* 
    W/Q: 15

Dest:        201.2.10.18..4040
  DestXCF:   201.3.10.15
  TotalConn: 0000055421  Rdy: 001  WLM: 07 TSR: 100
  DistMethod: ServerWLM
  Flg: Tier2
  TCSR: 100 CER: 100 SEF: 100
  Weight: 60            
    Raw          CP: 60 zAAP: 00 zIIP: 00
    Proportional CP: 60 zAAP: 00 zIIP: 00
  Abnorm: 0000       Health: 100
  ActConn:   0000003006
  QosPlcAct: *DEFAULT*  
    W/Q: 07    
Dest:        201.4.10.15..7000
  DestXCF:   201.3.10.16
  TotalConn: 0000094011  Rdy: 001  WLM: 10 TSR: 100
  DistMethod: HotStandby           SrvType: Preferred
  Flg: Active
  TCSR: 100  CER: 100  SEF: 100
  Abnorm: 0000         Health: 100
  ActConn:    0000001011 
Dest:        201.4.10.15..7000
  DestXCF:   201.3.10.17
  TotalConn: 0000000000  Rdy: 001  WLM: 10 TSR: 100
  DistMethod: HotStandby           SrvType: Backup 
  Flg: Backup
  TCSR: 100  CER: 100  SEF: 100
  Abnorm: 0000         Health: 100
  ActConn:    0000000000
DestIntf:                                   
  Dest:        2001:0db8::522:f103..20           
    DestXCF:   2001:0db8::943:f003               
    TotalConn: 0000000000  Rdy: 001  WLM: 01 TSR: 100
    DistMethod: BaseWLM
    Flg:                             
    TCSR: 100  CER: 100 SEF: 100
    Weight: 16              
      Raw          CP: 24 zAAP: 00 zIIP: 08
      Proportional CP: 12 zAAP: 00 zIIP: 04
    ActConn:   0000000000
    QosPlcAct: *DEFAULT*                                     
      W/Q: 00    
DestIntf:                                   
  Dest:        2001:0db8::522:f103..21           
    DestXCF:   2001:0db8::943:f003               
    TotalConn: 0000000000  Rdy: 001  WLM: 15 TSR: 100
    DistMethod: ServerWLM
    Flg:                             
    TCSR: 100  CER: 100 SEF: 100
    Weight: 50          
      Raw          CP: 60 zAAP: 00 zIIP: 49
      Proportional CP: 06 zAAP: 00 zIIP: 44
    Abnorm:0000         Health: 100
    ActConn:   0000000000
    QosPlcAct: *DEFAULT*                                
      W/Q: 15

Dynamic VIPA Destination Port Table for non-z/OS targets:
Dest:        201.2.10.21..3000
  Target Addr: 205.1.10.15
  TotalConn: 0000310485  Rdy: 001  Wt: 01 CWt: 100
  DistMethod: Roundrobin
  Flg: Inactive
  T1Wt: 33
  ActConn:      00000042                                      
Dest:        201.2.10.22..4011                                    
  Target Addr: 205.2.10.10                                   
  TotalConn: 0000103162  Rdy: 001  Wt: 01 CWt: 075  
  DistMethod: TargCtrl
  Flg:     
  T1Wt: 54                                                     
  ActConn:      00000834          
Dest:        201.2.10.22..4011                                  
  Target Addr: 205.2.10.12                                    
  TotalConn: 0000102658  Rdy: 001  Wt: 01 CWt: 075  
  DistMethod: TargCtrl
  Flg:       
  T1Wt: 25                                                         
  ActConn:      00000091
Dest:        201.2.10.25..5000                         
  Target Addr: 204.3.10.15                                                 
  TotalConn: 0000034011  Rdy: 001  Wt: 10 CWt: 100                      
  DistMethod: WeightedActive
  Flg:  
  T1Wt: 62                                                         
  ActConn:      00001021
DestIntf:      INTFNAMB
  Dest:        2001:0db8::522:f222..8000
    Target Addr: 2001:0db8::540:f301
    TotalConn: 0000000000  Rdy: 001  Wt: 05 CWt: 100
    DistMethod: TargCtrl
    Flg: 
    T1Wt: 500                                                        
    ActConn:      00000000
DestIntf:      INTFNAMB
  Dest:        2001:0db8::522:f222..8000
    Target Addr: 2001:0db8::540:f302
    TotalConn: 0000000000  Rdy: 001  Wt: 14 CWt: 200
    DistMethod: TargCtrl
    Flg:
    T1Wt: 700                                                        
    ActConn:      00000000

Report field descriptions for the Dynamic VIPA Destination Port Table for TCP/IP Stacks

Displays information about distribution to TCP/IP stacks, including base targets and z/OS® tier 1 and tier 2 targets.

For a SHORT format report

Dest IPaddr: The DVIPA address for which workload is being distributed.

DPort: Connections for this port are to be distributed.

DestXCF Addr: The dynamic XCF address of target stack to receive connections.

Flg

Flags; depending on the VIPADISTRIBUTE configuration parameters, the state of the target, and the path to the target, flags can have the following values:

1: Indicates that this is a tier 1 DVIPA address.
2: Indicates that this is a tier 2 DVIPA address.
D: Indicates a dynamically assigned destination/port entry.
I: Indicates that the data path to the target stack is inactive.
K: Indicates that this is currently a backup (hot standby) server.
L: Indicates that the target stack specified by the DestXCF Addr value is currently processing outbound connections that originated on the target stack for this destination and port pair locally.
V: Indicates that this is currently the active server.

For a LONG format report

DestIntf: The name of this IPv6 interface.

Dest: The DVIPA address and port for which workload is being distributed.

DestXCF: The dynamic XCF address of target stack to receive connections.

Flg

Flags; depending on the VIPADISTRIBUTE configuration parameters, the state of the target, and the path to the target, flags can have the following values:

Active: Indicates that this is currently the active server.
Backup: Indicates that this is currently a backup (hot standby) server.
Dynamic: Indicates a dynamically assigned destination/port entry.
Inactive: Indicates that the datapath to the XCF target is inactive.
Local: Indicates that the target stack specified by the DestXCF Addr value is currently processing outbound connections for this destination and port pair locally.
Tier1: Indicates that this is a tier 1 DVIPA address.
Tier2: Indicates that this is a tier 2 DVIPA address.

For a SHORT or LONG format report

DistMethod

The distribution method in use.

BaseWLM: Indicates that WLM system weights and policy information are used to distribute incoming connection requests.
HotStandby: Indicates that HotStandby distribution is in use.
Roundrobin: Indicates that incoming connection requests are distributed using the round-robin method.
ServerWLM: Indicates that WLM server weights and policy information are used to distribute incoming connection requests.
WLM server weights are used if SERVERWLM was specified on the VIPADISTRIBUTE statement for this DVIPA and port, and all target servers are able to provide WLM server-specific weights. Otherwise, BaseWLM is used.
WeightedActive: Indicates that incoming connection requests are distributed using the weighted active connections method.

Rule: For a short format report, you need to use the DETAIL modifier to display this field.

Rdy

The number of applications ready to receive connections. A count of 0 indicates that there are no applications on this target stack ready to receive new connections. Either the application has not been started on this target, or if it was started, it might have been terminated or quieseced with the Vary TCPIP,,SYSPLEX,QUIesce command.

SrvType

Indicates the server type when the HotStandby distribution method is configured.

Backup: Indicates that this is a backup target. A backup target is initially a hot standby target. Connections are not distributed to hot standby targets. If the active target becomes unavailable, the distributor switches targets and one of the hot standby targets becomes the active target.
Preferred: Indicates that this is the preferred target. If AUTOSWITCHBACK is configured, then the preferred target is the active target if it is available and has not had any health problems. If the active target becomes unavailable, the distributor switches to use a hot standby target; the active target becomes a hot standby target and the selected hot standby target becomes the active target.

Rule: For a short format report, you need to use the DETAIL modifier to display this field.

TotalConn: The total number of connections that have been forwarded to the stack identified by DestXCF Addr. This field will wrap.

WLM

When the distribution method is BASEWLM or SERVERWLM this is the Workload Manager weight value for the target listener. The weight value is either an indication of the target system's capacity for additional work or the more granular indication of the specific server's capacity for additional work, based on how well it is meeting its WLM policy goals (where higher numbers indicate a server with greater capacity). WLM system weights are indicated by the BaseWLM flag. WLM server-specific weights are indicated by the ServerWLM flag.

When this is a tier 1 target, the original system weight or server-specific weight might be modified by adding the weight of a tier 2 target server for the same group name that is also on this TCP/IP stack, therefore, the displayed value indicates the comparative fitness of a tier 1 target in terms of both the tier 1 and the corresponding tier 2 server capacity for additional work. The weights represent normalized weights; the original weights of the tier 1 and tier 2 server (if any) are added together and proportionally reduced for use by the distribution algorithm. Connections are distributed to these servers in a weighted distribution using the normalized weights.

The weights represent normalized weights; the original raw weights received from WLM are modified by multiplying them by the target server responsiveness (TSR) value and are proportionally reduced for use by the distribution algorithm. Thus, the displayed value indicates the comparative fitness of a server both in terms of system or server capacity and in terms of TCP connection setup responsiveness. Connections are distributed to these servers in a weighted round-robin manner using the normalized weights.

For more information about WLM, see Sysplex distributor details in the z/OS Communications Server: IP Configuration Guide.

When the distribution method is WEIGHTEDACTIVE, this value is the configured weight for the target listener. This weight is used by the distributor to determine the proportion of incoming requests to route to this target such that the number of active connections on each target is proportionally equivalent to the configured weight for each target.

TSR

The target server responsiveness value for the target server.

The sysplex distributor monitors the ability of a target server to process new connections. At each interval of approximately one minute, it generates a target server responsiveness fraction percentage to indicate how well the server is accepting new TCP connection setup requests. It is not a measure of how well the server is servicing the connections.

The value 100 indicates that the target server is successfully accepting all new TCP connection setup requests. A value of 100 is also displayed for target stacks at a pre-V1R7 z/OS level. If there is at least one target stack for this DVIPA and a port that is at a pre-V1R7 z/OS level, then no target server responsiveness calculations are applied to the WLM values.
A value that is greater than 0 but less than 100 indicates that the server is having problems accepting some new connection requests. These problems can be due to network connectivity, server application problems, or target stack problems.
The value 0 indicates that the target server is unable to process new connection requests. This can be due to network connectivity, server application problems, or target stack problems. No new TCP connection setup requests are distributed to a target server with a TSR value of 0.

The sysplex distributor modifies the WLM weight for each target server by the calculated target server responsiveness percentage, and, after normalizing the weights, uses these new values to weight its distribution of new connection requests to the target servers. For example, if there are three target servers for a particular DVIPA with calculated TSRs of 75, 50, and 100 percent respectively, and, after applying the TSRs to the WLM weights, the normalized weights are 7, 2, and 3, the sysplex distributor would be expected to distribute three and a half times as many new connection requests to the first target server as to the second server and one and half times as many new connection requests to the third server as to the second server.

The TSR percentage is calculated from two component values, the target connectivity success rate (TCSR) and the server accept efficiency fraction (SEF)

The TCSR measures the percentage of connection setup requests routed from the distributor that are successfully received by the target for this server.
The SEF measures the effectiveness of the server application in accepting new connection requests and managing its backlog queue.

The values of each of the components are displayed when DETAIL is specified on the command.

DETAIL

Invoking VDPT/-O DETAIL displays the VDPT information stated above and includes the following additional information:

TCSR: The target connectivity success rate (TCSR) is a measure of the percentage of connection setup requests routed from the distributor that are successfully received by the target for this server. It is displayed as a percentage. A value of 100 indicates that all connection setup requests routed to the target stack destined for this server are being successfully received by the target. A value of 0 indicates that no connection setup requests for this server are successfully reaching the target. This value is one component part of the target server responsiveness (TSR) value.

CER: The connection establishment rate (CER) is a measure of the percentage of the connection setup requests received at the target that achieve completion with the client (that is, arrive at connection established state). It is displayed as a percentage. The value 100 indicates that all new connection setup requests are resulting in established connections. The value 0 indicates that no new connection setup requests have become successfully established. This value is used for diagnosis only and is not integrated into the TSR calculation. For information about diagnosing sysplex problems, see the steps for diagnosing sysplex problems in the z/OS Communications Server: IP Diagnosis Guide.
SEF: The server accept efficiency fraction (SEF) is a measure, calculated at intervals of approximately one minute, of the efficiency of the server application in accepting new connection requests and managing its backlog queue. It is displayed as a percentage. A value of 100 indicates that the server application is successfully accepting all its new connection setup requests. A value of 0 indicates the server application is not responding to new connection setup requests. This value is one component part of the target server responsiveness (TSR) value.

Weight

The composite weight. This is the sum of the displayed modified CP, zAAP, and zIIP weights that follow.

CP

When the distribution method is BASEWLM the following apply:

The Raw value is the WLM system general CP weight recommendation. It is based on the amount of displaceable general CPU capacity on this system as compared to the other target systems.
The Proportional value is the Raw value modified by the expected general CP utilization proportion configured on the VIPADISTRIBUTE PROCTYPE statement for this application.

When the distribution method is SERVERWLM the following apply:

The Raw value is the WLM server-specific general CP recommendation. This is the amount of displaceable general CPU capacity based on the application workload's importance (as defined by the WLM policy) as compared to the other target systems.
The Proportional value is the Raw value modified by the proportion of general CP capacity that is currently being consumed by the application's workload as compared to the other processors (zAAP and zIIP)

zAAP

When the distribution method is BASEWLM the following apply:

The Raw value is the WLM system zAAP weight recommendation. It is based on the amount of displaceable zAAP capacity on this system as compared to the other target systems.
The Proportional value is the Raw value modified by the expected zAAP utilization proportion configured on the VIPADISTRIBUTE PROCTYPE statement for this application.

When the distribution method is SERVERWLM the following apply:

The Raw value is the WLM server-specific zAAP recommendation, which is the amount of displaceable zAAP capacity based on the application workload's importance (as defined by the WLM policy) as compared to the other target systems.
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 (general CPU and zIIP)

zIIP

When the distribution method is BASEWLM the following apply:

The Raw value is the WLM system zIIP weight recommendation. It is based on the amount of displaceable zIIP capacity on this system as compared to the other target systems.
The Proportional value is the Raw value modified by the expected zIIP utilization proportion configured on the VIPADISTRIBUTE PROCTYPE statement for this application.

When the distribution method is SERVERWLM the following apply:

The Raw value is the WLM server-specific zIIP recommendation. This is the amount of displaceable zIIP capacity based on the application workload's importance (as defined by the WLM policy) as compared to the other target systems.
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 (general CPU and zAAP)

ActConn

Indicates the current number of active connections for a target TCP/IP. This count is incremented by the distributing TCP/IP when one of the following occurs:

A connection request is forwarded by the distributing TCP/IP to that target.
The distributing TCP/IP is informed that the target has initiated a TCP connection using this DVIPA as a source IP address.

Abnorm: Indicates whether the server application is experiencing conditions under which transactions are completing abnormally. It represents a rate of abnormal transaction completions per 1000 total transaction completions. It is applicable only for TCP applications that act as Subsystem Work Managers and report transaction status using Workload Management Services, such as IWMRPT. For example, a value of 100 indicates that 10% of all transactions processed by the server application are completing abnormally. Under normal conditions, this value is 0. A nonzero value indicates that the server application has reported some abnormal transactions completions to WLM and that WLM has reduced the recommendation provided to sysplex distributor for this server instance. This reduction in the WLM recommendation enables fewer new TCP connections to be directed to servers that are not experiencing problem conditions that result in abnormal transaction completions. The greater the value in the Abnorm field, the greater the reduction WLM applies to the recommendation for this target instance. For more information about the conditions that cause abnormal transaction completions for a given server application, see the documentation that was provided by the server application.
If the distribution method is not SERVERWLM, then this field is 0. For more information about workload management interfaces, see z/OS MVS Programming: Workload Management Services.

Health: The health indicator of the server application. This health indicator is available only for applications that provide this information to WLM using the IWM4HLTH or IWMSRSRG services. It provides a general health indication for an application or subsystem. Under normal circumstances, the value of this field is 100, which indicates that the server is 100% healthy. Any value less than 100 indicates that the server is experiencing problem conditions that are not enabling it to process new work requests successfully. A value of less than 100 also causes the WLM to reduce the recommendation provided to sysplex distributor for this server instance. This reduction in the WLM recommendation enables fewer new TCP connections to be directed to servers that are not experiencing problem conditions. The reduction in the WLM recommendation is proportional to the Health indicator value. For example, given a health value of only 20%, WLM reduces the recommendation for this server by 80%. For more information regarding the conditions that lead to a health indicator of less than 100, see the documentation for the server application.
If applications do not provide this health indicator to WLM, then this field has a value of 100. If the distribution method is not SERVERWLM, then this field has a value of 100. For more information about workload management interfaces, see z/OS MVS Programming: Workload Management Services.

W/Q

The Workload Manager weight value for the target server after modification using QoS information provided by the Policy Agent. QoS information is an indication of the following information:

Network performance (TCP retransmissions and timeouts)
Maximum connections allowed versus actual connections
Expected overall throughput versus the actual throughput achieved

This value is used by a distributing stack to determine the quantity of connections to be forwarded to this target stack, relative to other target stacks. Note that if, for a particular incoming connection, a target server's W/Q value for the destination address, port, and QoS policy action is 0, while the W/Q value for the destination address, port, and QoS policy action on other target servers is nonzero, no connections are forwarded to the target server with a 0 W/Q value.

Note: If all target servers for the destination address, port, and QoS policy action have 0 W/Q values, connection forwarding is done in a round-robin fashion, rather than based on WLM or QoS information.

QosPlcAct: The QoS policy action name configured to the Policy Agent. If multiple QoS policy actions are configured for a single destination address and port, each policy action name is displayed along with its associated WLM and W/Q values. A QosPolicyAction of *Default* indicates the WLM and W/Q values used when there is no QosPolicyAction that applies to an incoming connection.

Report field descriptions for the Dynamic VIPA Destination Port Table for non-z/OS targets

Displays information about distribution to non-z/OS targets. This includes tier 1 targets.

For a SHORT format report

Dest IPaddr

The DVIPA address for which workload is being distributed.

DPort

Connections for this port that are to be distributed.

Target Addr

The IP Address of a non-z/OS target that is to receive connections. This is a tier 1 target (for example, a DataPower® appliance).

Flg

Flags; can have one of the following values:

A: Indicates that incoming connection requests are distributed by the weighted active connections method.
I: Indicates that the data path to the target is inactive.
R: Indicates that incoming connection requests are distributed by the round-robin method.
T: Indicates that incoming connection requests are distributed using weights that are provided by the tier 1 targets.

For a LONG format report

DestIntf

The name of this IPv6 interface.

Dest

The DVIPA address and port for which workload is being distributed.

Target Addr

The IP address of a non-z/OS target that is to receive connections. This is a tier 1 target (for example, a DataPower appliance).

Flg

Flags; can have one of the following values:

Inactive: Indicates that the datapath to the target is inactive.
Roundrobin: Indicates that incoming connection requests are distributed by the round-robin method.
TargetCtrl: Indicates that incoming connection requests are distributed using weights provided by the tier 1 targets.
WeightedActive: Indicates that incoming connection requests are distributed by the weighted active connections method.

For a SHORT or LONG format report

Rdy

This field indicates whether there are applications ready to receive connections. The value 0 indicates that there are no application on this target that is ready to receive new connections. The value 1 indicates that there is an application on this target that is ready to receive new connections.

TotalConn

The total number of connections that have been forwarded to the target identified by Target Addr. This field will wrap.

Wt

The composite weight of the target. The following distribution methods are supported:

TARGCONTROLLED

The weights represent normalized weights; the original weights received from the tier 1 targets (if any) might be modified by multiplying them by the central processor complex (CPC) weight (CWt) value and are proportionally reduced for use by the distribution algorithm. The displayed value indicates the comparative fitness of a target both in terms of target capacity and in terms of the CPC availability of the associated tier 2 target servers. Connections are distributed to these servers in a weighted distribution using the normalized weights.

WEIGHTEDACTIVE

The CPC weight 0 affects weighted active distribution. If at least one nonzero CPC weight has been received for a group of associated tier 2 target servers, then the following occurs:

If the associated CPC weight is 0, then the normalized weight is set to 0 for this target.
If the CPC weight is not 0, then normalization uses the weight that is configured.

ROUNDROBIN

The CPC weight 0 affects round-robin distribution. If at least one nonzero CPC weight has been received for a group of associated tier 2 target servers, then the following occurs:

If the associated CPC weight is 0, then the normalized weight is set to 0 for this target.
If the CPC weight is not 0, the normalized weight for this target is set to 1.

CWt

A value that represents the combined weights of the tier 2 target servers on the stacks that are on the same central processor complex (CPC ) as the tier 1 target. These applications are the tier 2 targets of connection requests from the tier 1 target. This value can be used to modify the weight value that is provided by the tier 1 target. See z/OS Communications Server: IP Configuration Guide for more details.

DETAIL

Details include the following fields:

T1Wt: The weight that is received from the tier 1 target.
ActConn: Indicates the current number of active connections for this target. This count is incremented by the distributing TCP/IP when a connection request is forwarded by the distributing TCP/IP to that target.