Netstat VIPADCFG/-F report
Displays the dynamic VIPA configuration for a local host.
TSO syntax
Modifier
- DETAIL
- Displays the general dynamic VIPA configuration information, along
with the following information:
- The OPTLOCAL value.
- If the distribution method is WeightedActive, displays the configured active connection weight.
- If the distribution method is BASEWLM, displays the PROCTYPE parameters.
- If the distribution method is SERVERWLM, diplays the PROCXCOST and ILWEIGHTING parameters.
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.
z/OS UNIX syntax
Modifier
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 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 VIPADCFG/-F 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 VIPADCFG/-F 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 VIPADCFG/-F 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 dynamic VIPA address, 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 IPAddr/-I option.
- An IPv4-mapped IPv6 address is accepted as a valid ipaddr value and usually provides the same result as its IPv4 address.
Restrictions:- The IPAddr/-I option for the VIPADCFG/-F report does not support wildcard characters.
- For an IPv4-only stack, only IPv4 ipaddr values are accepted.
Command syntax examples
From TSO environment
NETSTAT VIPADCFG
Display the dynamic VIPA configuration for the default TCP/IP stack.
NETSTAT VIPADCFG TCP TCPCS6
Display the dynamic VIPA configuration for the TCPCS6 stack.From UNIX shell environment
netstat -F
netstat -F -p tcpcs6 Report examples
The following examples are generated by using TSO NETSTAT command. Using the z/OS UNIX netstat command displays the data in the same format as the TSO NETSTAT command.
If the TCP/IP stack is not currently in the sysplex group, two messages will preceed the report, one indicating that the TCP/IP stack is not a member of the sysplex group and the other indicating that all dynamic VIPA configuration for the TCP/IP stack is currently inactive. See z/OS Communications Server: IP Messages Volume 4 (EZZ, SNM), messages EZZ2502I and EZZ2503I respectively, for detailed information about these messages.
If the stack is delaying sysplex profile processing because VTAM® or OMPROUTE is not initialized, VIPADYNAMIC configuration information is not available and message EZZ2505I precedes the report heading. See z/OS Communications Server: IP Messages Volume 4 (EZZ, SNM) for more information.
Not IPv6 enabled (SHORT format)
NETSTAT VIPADCFG
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 19:47:49
Dynamic VIPA Information:
VIPA Backup:
IP Address Rank Address Mask Moveable SrvMgr Flg
---------- ---- ------------ -------- ------ ---
201.2.10.29 025 255.255.255.192 WhenIdle Yes
201.2.10.30 100 255.255.255.192 Immediate No
201.2.10.32 040
201.2.10.40 010 255.255.255.192 Immediate No 1
201.2.10.45 020 255.255.255.192 Immediate No 2
201.2.10.54 010 255.255.255.192 Immediate No C
VIPA Define:
IP Address AddressMask Moveable SrvMgr Flg
---------- ----------- -------- ------ ---
201.2.10.11 255.255.255.192 WhenIdle No
201.2.10.12 255.255.255.192 Immediate Yes
201.2.10.13 255.255.255.192 Immediate No
201.2.10.14 255.255.255.192 Immediate No
201.2.10.17 255.255.255.192 Immediate No 1
201.2.10.18 255.255.255.192 Immediate No 2C
201.2.10.19 255.255.255.192 Immediate No C
201.2.10.31 255.255.255.192 Immediate No 1
VIPA Range:
AddressMask IP Address Moveable SAF Name
----------- ---------- -------- --------
255.255.255.192 201.2.10.192 NonDisr RANGE1
255.255.255.192 201.2.20.192 Disrupt
VIPA Distribute:
IP Address Port XCF Address SysPt TimAff Flg
---------- ---- ----------- ----- ------ ----
201.2.10.11 n/a ALL Yes 200
201.2.10.13 243 ALL No No O
201.2.10.14 244 ALL No No 1
201.2.10.15 5000 201.3.10.15 No No A
201.2.10.17 8080 200.1.10.10 No Yes 1
201.2.10.18 4040 201.3.10.16 No Yes 2
201.2.10.18 4040 201.3.10.15 No Yes 2
201.4.10.15 7000 201.3.10.16 No No
201.4.10.15 7000 201.3.10.17 No No
VIPA Service Manager:
McastGroup: 224.0.0.1 Port: 04444 Pwd: Yes
VIPA Route:
XCF Address TargetIp
----------- --------
201.10.10.1 201.20.20.1
201.10.10.2 201.20.20.2
201.10.10.3 201.20.20.3
Deactivated Dynamic VIPA Information:
VIPA Backup:
IP Address Rank Address Mask Moveable SrvMgr Flg
---------- ---- ------------ -------- ------ ---
201.2.10.40 100 255.255.255.192 Immediate No
VIPA Define:
IP Address AddressMask Moveable SrvMgr Flg
---------- ----------- -------- ------ ---
201.2.10.20 255.255.255.192 Immediate No
VIPA Distribute:
IP Address Port XCF Address SysPt TimAff Flg
---------- ---- ----------- ----- ------ ----
201.2.10.20 5000 ALL No No BNETSTAT VIPADCFG DETAIL
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 19:47:49
Dynamic VIPA Information:
VIPA Backup:
IP Address Rank Address Mask Moveable SrvMgr Flg
---------- ---- ------------ -------- ------ ---
201.2.10.29 025 255.255.255.192 WhenIdle Yes
201.2.10.30 100 255.255.255.192 Immediate No
201.2.10.32 040
201.2.10.40 010 255.255.255.192 Immediate No 1
201.2.10.45 020 255.255.255.192 Immediate No 2
201.2.10.54 010 255.255.255.192 Immediate No C
VIPA Define:
IP Address AddressMask Moveable SrvMgr Flg
---------- ----------- -------- ------ ---
201.2.10.11 255.255.255.192 WhenIdle No
201.2.10.12 255.255.255.192 Immediate Yes
201.2.10.13 255.255.255.192 Immediate No
201.2.10.17 255.255.255.192 Immediate No 1
201.2.10.18 255.255.255.192 Immediate No 2C
201.2.10.19 255.255.255.192 Immediate No C
201.2.10.31 255.255.255.192 Immediate No 1
VIPA Range:
AddressMask IP Address Moveable SAF Name
----------- ---------- -------- --------
255.255.255.192 201.2.10.192 NonDisr RANGE1
255.255.255.192 201.2.20.192 Disrupt
VIPA Distribute:
IP Address Port XCF Address SysPt TimAff Flg
---------- ---- ----------- ----- ------ ----
201.2.10.11 n/a ALL Yes 200 R
DistMethod: Roundrobin
OptLoc: No
201.2.10.13 243 ALL No No O
DistMethod: BaseWLM
OptLoc: 1
ProcType:
CP: 60 zAAP: 00 zIIP: 40
201.2.10.14 243 ALL No No 1
DistMethod: ServerWLM
OptLoc: No
ProcXCost:
zAAP: 003 zIIP: 001
ILWeighting: 1
201.2.10.17 8080 200.1.10.10 No Yes 1
DistMethod: TargCtrl
OptLoc: No
GrpName: CICSGROUP RtgType: GRE CtrlPort: 1010
201.2.10.18 4040 201.3.10.16 No Yes 2
DistMethod: ServerWLM
OptLoc: No
GrpName: CICSGROUP
ProcXCost:
zAAP: 003 zIIP: 001
ILWeighting: 1
201.2.10.18 4040 201.3.10.15 No Yes 2
DistMethod: ServerWLM
OptLoc: No
GrpName: FTPGROUP
201.4.10.15 7000 201.3.10.16 No No
DistMethod: HotStandby SrvType: Preferred
AutoSwitchBack: Yes HealthSwitch: Yes
OptLoc: No
201.4.10.15 7000 201.3.10.17 No No
DistMethod: HotStandby SrvType: Backup Rank: 001
AutoSwitchBack: Yes HealthSwitch: Yes
OptLoc: No VIPA Service Manager:
McastGroup: 224.0.0.1 Port: 04444 Pwd: Yes
VIPA Route:
XCF Address TargetIp
----------- --------
201.10.10.1 201.20.20.1
201.10.10.2 201.20.20.2
201.10.10.3 201.20.20.3
Deactivated Dynamic VIPA Information:
VIPA Backup:
IP Address Rank Address Mask Moveable SrvMgr Flg
---------- ---- ------------ -------- ------ ---
201.2.10.40 100 255.255.255.192 Immediate No
VIPA Define:
IP Address AddressMask Moveable SrvMgr Flg
---------- ----------- -------- ------ ---
201.2.10.20 255.255.255.192 Immediate No
VIPA Distribute:
IP Address Port XCF Address SysPt TimAff Flg
---------- ---- ----------- ----- ------ ----
201.2.10.20 5000 ALL No No B IPv6 enabled or request for LONG format
NETSTAT VIPADCFG
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 19:49:12
Dynamic VIPA Information:
VIPA Backup:
IpAddr/PrefixLen: 201.2.10.29/26
Rank: 025 Moveable: WhenIdle SrvMgr: Yes Flg:
IpAddr/PrefixLen: 201.2.10.30/26
Rank: 025 Moveable: Immediate SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.32
Rank: 040 Moveable: SrvMgr: Flg:
IpAddr/PrefixLen: 201.2.10.40
Rank: 010 Moveable: Immediate SrvMgr: No Flg: 1
IpAddr/PrefixLen: 201.2.10.45
Rank: 020 Moveable: Immediate SrvMgr: No Flg: 2
IpAddr/PrefixLen: 201.2.10.54
Rank: 010 Moveable: Immediate SrvMgr: No Flg: C
IntfName: INTFNAM5
IpAddr: 2001:db8::526:f604/64
Rank: 050 Moveable: Immediate SrvMgr: n/a Flg: 2C
IntfName: INTFNAM4
IpAddr: 2001:db8::526:f606/64
Rank: 025 Moveable: WhenIdle SrvMgr: n/a Flg: C
IntfName: INTFNAM6
IpAddr: 2001:db8::526:f603
Rank: 050 Moveable: SrvMgr: n/a Flg:
VIPA Define:
IpAddr/PrefixLen: 201.2.10.11/26
Moveable: WhenIdle SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.12/26
Moveable: Immediate SrvMgr: Yes Flg:
IpAddr/PrefixLen: 201.2.10.13/26
Moveable: Immediate SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.14/26
Moveable: Immediate SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.17/26
Moveable: Immediate SrvMgr: No Flg: 1
IpAddr/PrefixLen: 201.2.10.18/26
Moveable: Immediate SrvMgr: No Flg: 2C
IpAddr/PrefixLen: 201.2.10.19/26
Moveable: Immediate SrvMgr: No Flg: C
IpAddr/PrefixLen: 201.2.10.31/26
Moveable: Immediate SrvMgr: No Flg: 1
IntfName: INTFNAM1
IpAddr: 2001:0db8::522:f103
Moveable: Immediate SrvMgr: n/a Flg:
IntfName: INTFNAM2
IpAddr: 2001:0db8::522:f203
Moveable: Immediate SrvMgr: n/a Flg:
IntfName: INTFNAMB
IpAddr: 2001:0db8::522:f222/64
Moveable: Immediate SrvMgr: No Flg: 1
IntfName: INTFNAMC
IpAddr: 2001:0db8::522:f333/64
Moveable: Immediate SrvMgr: No Flg: 2C
IntfName: INTFNAMD
IpAddr: 2001:0db8::22:f334/64
Moveable: Immediate SrvMgr: No Flg: C
VIPA Range:
IpAddr/PrefixLen: 201.2.10.192/26
Moveable: NonDisr SAFName: RANGE1
IpAddr/PrefixLen: 201.2.20.192/26
Moveable: Disrupt
IntfName: INTFNAM3
IpAddr/PrefixLen: 2001:0db8::522:f303/24
Moveable: NonDisr SAFName: RANGE2 VIPA Distribute:
Dest: 201.2.10.11..n/a
DestXCF: ALL
DistMethod: Roundrobin
SysPt: Yes TimAff: 200 Flg: Roundrobin
Dest: 201.2.10.13..243
DestXCF: ALL
DistMethod: BaseWLM
SysPt: No TimAff: No Flg: OptLocal
Dest: 201.2.10.14..244
DestXCF: ALL
DistMethod: ServerWLM
SysPt: No TimAff: No Flg: Tier1
Dest: 201.2.10.17..8080
DestXCF: 200.1.10.10
SysPt: No TimAff: Yes Flg: Tier1
Dest: 201.2.10.18..4040
DestXCF: 201.3.10.15
DistMethod: ServerWLM
SysPt: No TimAff: Yes Flg: Tier2
Dest: 201.2.10.18..4040
DestXCF: 201.3.10.16
DistMethod: ServerWLM
SysPt: No TimAff: Yes Flg: Tier2
Dest: 201.4.10.15..7000
DestXCF: 201.3.10.16
DistMethod: HotStandby SrvType: Preferred
SysPt: No TimAff: Yes Flg:
Dest: 201.4.10.15..7000
DestXCF: 201.3.10.17
DistMethod: HotStandby SrvType: Backup Rank: 001
SysPt: No TimAff: Yes Flg:
DestIntf: INTFNAM1
Dest: 2001:0db8::522:f103..20
DestXCF: ALL
DistMethod: ServerWLM
SysPt: No TimAff: No Flg:
DestIntf: INTFNAM1
Dest: 2001:0db8::522:f103..21
DestXCF: ALL
DistMethod: ServerWLM
SysPt: Yes TimAff: 10 Flg:
DestIntf: INTFNAMB
Dest: 2001:0db8::522:f222..8000
DestXCF: 2001:0db8::540:f301
DistMethod: TargCtrl
SysPt: No TimAff: No Flg: Tier1
DestIntf: INTFNAMB
Dest: 2001:0db8::522:f222..8000
DestXCF: 2001:0db8::540:f302
DistMethod: TargCtrl
SysPt: No TimAff: No Flg: Tier1
VIPA Service Manager:
McastGroup: 224.0.0.1
Port: 04444 Pwd: Yes VIPA Route:
DestXCF: 201.10.10.1
TargetIp: 201.20.20.1
DestXCF: 201.10.10.2
TargetIp: 201.20.20.2
DestXCF: 2eco::500:f103
TargetIp: 2eco::100:f103
Deactivated Dynamic VIPA Information:
VIPA Backup:
IpAddr/PrefixLen: 201.2.10.40/26
Rank: 025 Moveable: Immediate SrvMgr: No Flg:
VIPA Define:
IpAddr/PrefixLen: 201.2.10.20/26
Moveable: Immediate SrvMgr: No Flg:
VIPA Distribute:
Dest: 201.2.10.20..5000
DestXCF: ALL
SysPt: No TimAff: No Flg: BaseWLMNETSTAT VIPADCFG DETAIL
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 19:49:12
Dynamic VIPA Information:
VIPA Backup:
IpAddr/PrefixLen: 201.2.10.29/26
Rank: 025 Moveable: WhenIdle SrvMgr: Yes Flg:
IpAddr/PrefixLen: 201.2.10.30/26
Rank: 025 Moveable: Immediate SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.32
Rank: 040 Moveable: SrvMgr: Flg:
IpAddr/PrefixLen: 201.2.10.40
Rank: 010 Moveable: Immediate SrvMgr: No Flg: 1
IpAddr/PrefixLen: 201.2.10.45
Rank: 020 Moveable: Immediate SrvMgr: No Flg: 2
IpAddr/PrefixLen: 201.2.10.54
Rank: 010 Moveable: Immediate SrvMgr: No Flg: C
IntfName: INTFNAM5
IpAddr: 2001:db8::526:f604/64
Rank: 050 Moveable: Immediate SrvMgr: n/a Flg: 2C
IntfName: INTFNAM4
IpAddr: 2001:db8::526:f606/64
Rank: 025 Moveable: WhenIdle SrvMgr: n/a Flg: C
IntfName: INTFNAM6
IpAddr: 2001:db8::526:f603
Rank: 050 Moveable: SrvMgr: n/a Flg:
VIPA Define:
IpAddr/PrefixLen: 201.2.10.11/26
Moveable: WhenIdle SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.12/26
Moveable: Immediate SrvMgr: Yes Flg:
IpAddr/PrefixLen: 201.2.10.13/26
Moveable: Immediate SrvMgr: No Flg:
IpAddr/PrefixLen: 201.2.10.17/26
Moveable: Immediate SrvMgr: No Flg: 1
IpAddr/PrefixLen: 201.2.10.18/26
Moveable: Immediate SrvMgr: No Flg: 2C
IpAddr/PrefixLen: 201.2.10.19/26
Moveable: Immediate SrvMgr: No Flg: C
IpAddr/PrefixLen: 201.2.10.31/26
Moveable: Immediate SrvMgr: No Flg: 1
IntfName: INTFNAM1
IpAddr: 2001:db8::522:f103
Moveable: Immediate SrvMgr: n/a Flg:
IntfName: INTFNAM2
IpAddr: 2001:db8::522:f203
Moveable: Immediate SrvMgr: n/a Flg:
IntfName: INTFNAMB
IpAddr: 2001:0db8::522:f222/64
Moveable: Immediate SrvMgr: No Flg: 1
IntfName: INTFNAMC
IpAddr: 2001:0db8::522:f333/64
Moveable: Immediate SrvMgr: No Flg: 2C
IntfName: INTFNAMD
IpAddr: 2001:0db8::22:f334/64
Moveable: Immediate SrvMgr: No Flg: C
VIPA Range:
IpAddr/PrefixLen: 201.2.10.192/26
Moveable: NonDisr SAFName: RANGE1
IpAddr/PrefixLen: 201.2.20.192/26
Moveable: Disrupt
IntfName: INTFNAM3
IpAddr/PrefixLen: 2001:db8::522:f303/24
Moveable: NonDisr SAFName: RANGE2
VIPA Distribute:
Dest: 201.2.10.11..n/a
DestXCF: ALL
DistMethod: Roundrobin
SysPt: Yes TimAff: 200 Flg: Roundrobin
OptLoc: No
Dest: 201.2.10.13..243
DestXCF: ALL
DistMethod: BaseWLM
SysPt: No TimAff: No Flg: OptLocal
OptLoc: 1
Dest: 201.2.10.14..244
DestXCF: ALL
DistMethod: ServerWLM
SysPt: No TimAff: No Flg: Tier1
OptLoc: No
Dest: 201.2.10.17..8080
DestXCF: 200.1.10.10
DistMethod: TargCtrl
SysPt: No TimAff: Yes Flg: Tier1
OptLoc: No
GrpName: CICSGROUP RtgType: GRE Control Port: 1010
Dest: 201.2.10.18..4040
DestXCF: 201.3.10.15
DistMethod: ServerWLM
SysPt: No TimAff: Yes Flg: Tier2
OptLoc: No
ProcXCost:
zAAP: 001 zIIP: 001
ILWeighting: 0
GrpName: CICSGROUP
Dest: 201.2.10.18..4040
DestXCF: 201.3.10.16
DistMethod: ServerWLM
SysPt: No TimAff: Yes Flg: Tier2
OptLoc: No
ProcXCost:
zAAP: 001 zIIP: 001
ILWeighting: 0
GrpName: CICSGROUP
Dest: 201.4.10.15..7000
DestXCF: 201.3.10.16
DistMethod: HotStandby SrvType: Preferred
AutoSwitchBack: Yes HealthSwitch: Yes
SysPt: No TimAff: Yes Flg:
OptLoc: No
Dest: 201.4.10.15..7000
DestXCF: 201.3.10.17
DistMethod: HotStandby SrvType: Backup Rank: 001
AutoSwitchBack: Yes HealthSwitch: Yes
SysPt: No TimAff: Yes Flg:
OptLoc: No
DestIntf: INTFNAM1
Dest: 2001:db8::522:f103..20
DestXCF: ALL
DistMethod: ServerWLM
SysPt: No TimAff: No Flg:
OptLoc: No
ProcXCost:
zAAP: 001 zIIP: 001
ILWeighting: 0
DestIntf: INTFNAM1
Dest: 2001:db8::522:f103..21
DestXCF: ALL
DistMethod: ServerWLM
SysPt: Yes TimAff: 10 Flg:
OptLoc: No
ProcXCost:
zAAP: 001 zIIP: 001
ILWeighting: 0DestIntf: INTFNAMB
Dest: 2001:0db8::522:f222..8000
DestXCF: 2001:0db8::540:f301
DistMethod: TargCtrl
SysPt: No TimAff: No Flg: Tier1
OptLoc: No
GrpName: FTPGROUP2 RtgType: ENCAP CtrlPort: 1010
DestIntf: INTFNAMB
Dest: 2001:0db8::522:f222..8000
DestXCF: 2001:0db8::540:f302
DistMethod: TargCtrl
SysPt: No TimAff: No Flg: Tier1
OptLoc: No
GrpName: FTPGROUP2 RtgType: ENCAP CtrlPort: 1010
VIPA Service Manager:
McastGroup: 224.0.0.1
Port: 04444 Pwd: Yes
VIPA Route:
DestXCF: 201.10.10.1
TargetIp: 201.20.20.1
DestXCF: 201.10.10.2
TargetIp: 201.20.20.2
DestXCF: 2eco::500:f103
TargetIp: 2eco::100:f103
Deactivated Dynamic VIPA Information:
VIPA Backup:
IpAddr/PrefixLen: 201.2.10.40/26
Rank: 025 Moveable: Immediate SrvMgr: No Flg:
VIPA Define:
IpAddr/PrefixLen: 201.2.10.20/26
Moveable: Immediate SrvMgr: No Flg:
VIPA Distribute:
Dest: 201.2.10.20..5000
DestXCF: ALL
SysPt: No TimAff: No Flg: BaseWLM Report field descriptions
Displays the following dynamic VIPA information defined in the VIPADYNAMIC profile statement. For more information about each field, see the VIPADYNAMIC profile statements in the z/OS Communications Server: IP Configuration Reference.
- VIPA Backup
- Displays the following configured dynamic VIPA backup information:
For a SHORT format report:
- IP Address
- The IP address for this DVIPA.
- AddressMask
- The net mask that determines how many of the bits of the IP address determine the net. This field is blank if Moveable and AddressMask were not specified on the VIPABACKUP statement or if another stack initially activated the DVIPA.
For a LONG format report:
- IntfName
- The name of this IPv6 interface. This name will match the interface name defined on the Primary stack that is being backed up.
- IpAddr/PrefixLen
- The IP address and prefix length for this DVIPA. For an IPv4 address, the prefix length range is 1 - 32. For an IPv6 address, the prefix length range is 1 – 128.
For a SHORT or LONG format report:
- Rank
- The relative position of this stack in the list of stacks that can activate (takeover) the DVIPA in case of failure. The stack with the highest ranked backup DVIPA will do the takeover.
- Moveable
- Indicates the conditions under which the active DVIPA can be moved
to another stack. This field is blank if Moveable and AddressMask
were not specified on the VIPABACKUP statement, or if another stack
initially activated the DVIPA.
- WhenIdle
- Indicates that this DVIPA can be moved to another stack when there are no connections for this DVIPA on the current stack. If there are connections on the current stack at the time another stack issues a VIPADEFINE for the same DVIPA, the DVIPA remains active on this stack until the last connection on this stack ends.
- Immediate
- Indicates that this DVIPA can be moved to another stack as soon as the other stack requests ownership by executing a VIPADEFINE for the same DVIPA. Existing connections on the current stack are maintained by the new owning stack.
- SrvMgr
- Indicates whether sysplex distributor performs Multinode Load Balancing (MNLB) by functioning as a Service Manager (in place of Cisco's LocalDirector) for this DVIPA. This field for an IPv4 entry is blank if Moveable and AddressMask were not specified on the VIPABACKUP statement or if another stack initially activated the DVIPA. This field for an IPv6 entry will always display n/a as it is not applicable for IPv6.
- Flg
- The following values can be displayed in the Flg field:
- 1
- Indicates that this DVIPA is used to distribute incoming requests to z/OS® or non-z/OS targets (for example, DataPower® appliances).
- 2
- Indicates that this DVIPA is used to distribute incoming requests from tier 1 targets to the group of server applications.
- C
- Indicates that this DVIPA is specific to the central processor complex (CPC) that it is defined on and that it cannot be moved to or taken over by a TCP/IP stack on a different CPC. This DVIPA can serve as a default route from DataPower appliances that are associated with this CPC. When used with the tier 2 flag (see Flg value 2), this value indicates that all of the tier 2 target applications are on TCP/IP stacks on the same CPC.
- VIPA Define
- Displays the configured dynamic VIPA define information.
For a SHORT format report:
- IP Address
- The IP address for this DVIPA.
- AddressMask
- The net mask that determines how many of the bits of the IP address determine the net.
For a LONG format report:
- IntfName
- The name of this IPv6 interface.
- IpAddr/PrefixLen
- The IP address and prefix length for this DVIPA. For an IPv4 address, the prefix length range is 1 – 32. For an IPv6 address, the prefix length range is 1 – 128.
For a SHORT or LONG format report:
- Moveable
- Indicates the conditions under which the DVIPA can be moved to
another stack.
- WhenIdle
- Indicates that this DVIPA can be moved to another stack when there are no connections for this DVIPA on the current stack. If there are connections on the current stack at the time another stack issues a VIPADEFINE for the same DVIPA, the DVIPA remains active on this stack until the last connection on this stack ends.
- Immediate
- Indicates that this DVIPA can be moved to another stack as soon as the other stack requests ownership by executing a VIPADEFINE for the same DVIPA. Existing connections on the current stack are maintained by the new owning stack.
- SrvMgr
- Indicates whether sysplex distributor performs Multinode Load Balancing (MNLB) by functioning as a Service Manager (in place of Cisco's LocalDirector) for this DVIPA. This field for an IPv6 entry always displays n/a as it is not applicable for IPv6.
- Flg
- The following values can be displayed in the Flg field:
- 1
- Indicates that this DVIPA is used to distribute incoming requests to the z/OS targets or non-z/OS targets (for example, DataPower appliances).
- 2
- Indicates that this DVIPA is used to distribute incoming requests from tier 1 targets to the group of server applications.
- C
- Indicates that this DVIPA is specific to the central processor complex (CPC) that it is defined on and that it cannot be moved to or taken over by a TCP/IP stack on a different CPC. This DVIPA can serve as a default route from DataPower appliances that are associated with this CPC. When used with the tier 2 flag (see Flg value 2), this value indicates that all of the tier 2 target applications are on TCP/IP stacks on the same CPC.
- VIPA Range
- Displays the configured dynamic VIPA range information.
For a SHORT format report:
- AddressMask
- The net mask that determines how many bits of the IP address determine the net.
- IP Address
- An IP address that determines a VIPARANGE net value when ANDed with the specified address mask. DVIPAs that fall within the range can be created by BIND or SIOCSVIPA ioctl.
- SAFName
- The final qualifier of a System Authorization Facility (SAF) resource name. The maximum length is 8 characters.
For a LONG format report:
- IntfName
- The name of this IPv6 interface.
- IpAddr/PrefixLen
- The IP address and prefix length for this DVIPA. For an IPv4 address, the prefix length range is 1 – 32. For an IPv6 address, the prefix length range is 1 – 128.
- SAFName
- The final qualifier of a System Authorization Facility (SAF) resource name. The maximum length is 8 characters.
For a SHORT or LONG format report:
- Moveable
- Indicates the conditions under which DVIPAs created within this
VIPARANGE can be moved to another stack.
- Disrupt
- Indicates that nondisruptive movement will not occur for DVIPAs created within this VIPARANGE on this stack. In the case of a BIND-created DVIPA, a subsequent BIND for the same DVIPA will not move the DVIPA and the subsequent BIND will fail. In the case of an ioctl-created DVIPA, a subsequent ioctl request for the same DVIPA moves the DVIPA to the new stack, but connections on that DVIPA on the first stack are broken.
- NonDisr
- Indicates immediate nondisruptive movement for DVIPAs within this VIPARANGE created on this stack by SIOCSVIPA ioctl (or BIND) when the same DVIPA is requested by subsequent net mask (or subsequent BIND) on another stack. Any existing connections on the original owning stack are maintained by the new owning stack.
- VIPA Distribute
- Displays the configured dynamic VIPA define information.
For a SHORT format report:
- IP Address
- The specific IP address for which incoming connections are to be distributed.
- Port
- The specific port for which incoming connections are to be distributed.
A port value of n/a indicates that the PORT parameter was not specified
on the VIPADISTRIBUTE profile statement.
Result: If multiple ports were specified individually or in a range on a VIPADISTRIBUTE statement, one entry is displayed for each address and port combination.
- XCF Address
- The dynamic XCF address (IPCONFIG DYNAMICXCF) of a target stack
for incoming connections to the DVIPA and port.
If the Flg field value 1 is displayed and RtgType GRE is displayed when the DETAIL keyword is used, then this field represents the IP address of the tier 1 target for incoming connections to the DVIPA.
- Weight
- The configured distribution method is WEIGHTEDActive. This is the configured active connection weight that is used when incoming connections are distributed to this target stack.
- Flg
- Flags including the following values:
- 1
- Indicates that the DVIPA is used to distribute incoming requests to tier 1 targets.
- 2
- Indicates that the DVIPA is used to distribute incoming requests from tier 1 targets to a group of tier 2 server applications.
- O
- Indicates that the OPTLOCAL keyword was defined on the VIPADISTRIBUTE profile statement. To see the OPTLOCAL value currently in effect, issue the Netstat VIPADCFG/-F command with the DETAIL keyword.
For a LONG format report:
- DestIntf
- The name of this IPv6 interface.
- Dest
- The specific IP address and port for which incoming connections
are to be distributed. A port value of n/a indicates that the PORT
parameter was not specified on the VIPADISTRIBUTE profile statement.
Result: If multiple ports were specified individually or in a range on a VIPADISTRIBUTE statement, one entry is displayed for each address and port combination.
- DestXCF
- The dynamic XCF address (IPCONFIG6 DYNAMICXCF) of a target stack
for incoming connections to the DVIPA and port.
If the Flg field value 1 is displayed and the RtgType field value GRE or ENCAP is displayed when the DETAIL keyword is used, then this field represents the IP address of the tier 1 target for incoming connections to the DVIPA.
- Flg
- Flags including the following values:
- OptLocal
- Indicates that the OPTLOCAL keyword was defined on the VIPADISTRIBUTE profile statement. To see the OPTLOCAL value currently in effect, issue the Netstat VIPADCFG/-F command with the DETAIL keyword.
- Tier1
- Indicates that the DVIPA is used to distribute incoming requests to tier 1 targets.
- Tier2
- Indicates that the DVIPA is used to distribute incoming requests from tier 1 targets to a group of tier 2 server applications.
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.
- 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.
When the server type is backup, the rank of the backup is displayed:
- Rank
- Used to determine which target is selected if the preferred target is unavailable. The highest ranked available backup is used.
- 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.
- SysPt
- Indicates whether coordinated Sysplex-wide ephemeral port assignment is activated for this distributed DVIPA.
- TimAff
- The value that was defined in the TIMEDAFFINITY parameter on the VIPADISTRIBUTE profile statement. The value No indicates that TIMEDAFFINITY is not specified or is set to zero.
- DETAIL
- Displays the general dynamic VIPA configuration information and
the OPTLOCAL value.
If the distribution method is WEIGHTEDActive, then the configured active connection weight is displayed.
If the distribution method is HotStandby, then the AUTOSWITCHBACK and HEALTHSWITCH information is displayed.
If the DVIPA value TIER1 or TIER2 was specified, the name of the targeted server application group is displayed.
- AUTOSWITCHBACK
- Indicates whether the distributor automatically switches distribution
back to the preferred target when it is available and healthy.
If the preferred target becomes a standby target because it is no longer available and later becomes available and healthy, the value Yes indicates that the distributor automatically switches back to using the preferred target as the active target. This is the default value.
The value No indicates that the distributor does not automatically switch back to the preferred target.
- HEALTHSWITCH
- Indicates whether the distributor automatically switches from
the active target if the active target is not healthy.
The value Yes indicates that the distributor does switch from the active target when it is not healthy. This is the default.
The value No indicates that the distributor ignores health metrics. The distributor switches from the active target only if the target is not ready or if the distributor does not have an active route to the target.
- OPTLOCAL
- A value of 0 indicates that connections originating from a target
stack within the sysplex should always bypass sending the connection
request to the sysplex distributor. The relative capacity of the WLM
weights for servers on other target stacks within the sysplex are
not considered when determining whether the connection should remain
local.
A value of 1 indicates that connections originating from a target stack within the sysplex should always bypass sending the connection request to the sysplex distributor as long as the WLM weight for the server on the local target stack's WLM weight is not 0. This is the default value if the OPTLOCAL field is specified without a value.
If a value in the range 2 – 16 is specified, this value is used as a multiplier against the raw WLM weight of the server on the local target stack to cause this server to be favored over the servers on other target stacks. The relative capacity of the WLM weights of the servers on the other target stacks within the sysplex is considered when determining which stack should process the connection. The greater the value specified, the more likely that the local stack is favored over other target stacks.
Regardless of the value that is specified on the OPTLOCAL statement, if one of the following conditions exists, connections are sent to the distributing stack:- No local server is available
- The SEF value has fallen below 75
- The number of abnormal transaction completions has exceeded 250
- The health indicator is less than 75
- Weight
- The configured distribution method is WEIGHTEDActive. This is the configured active connection weight that is used when incoming connections are distributed to this target stack.
- PROCTYPE
- The expected utilization proportion of each type of processor
(CP, zAAP, and zIIP) that an application's workload will consume.
This field is displayed only when the configured distribution method
is BASEWLM.
- CP
- The expected utilization proportion of general CPU processor capacity.
- zAAP
- The expected utilization proportion of zAAP processor capacity.
- zIIP
- The expected utilization proportion of zIIP processor capacity.
- ProcXCost
- The crossover cost that is applied to the workload that was targeted
to a zAAP or zIIP processor but that ran on the conventional processor
when the composite SERVERWLM weight is determined. The weight 1 indicates
that crossover cost is not considered when the composite SERVERWLM
weight is determined. This parameter is displayed only when the distribution
method is SERVERWLM.
- zAAP
- The crossover cost of running a workload that was targeted to a zAAP processor on a general CPU instead of on the zAAP processor.
- zIIP
- The crossover cost of running a workload that was targeted to a zIIP processor on a general CPU instead of on the zIIP processor.
- ILWeighting
- The configured importance level weighting factor. This field
is displayed only when the configured distribution method is SERVERWLM.
See the following possible values:
- 0
- Indicates that systems that have displaceable capacity at low importance levels are not favored over systems that have displaceable capacity at high importance levels.
- 1
- Indicates that WLM should weight displaceable capacity at each successively lower importance level slightly higher than the capacity that is at the preceding higher importance level. The weighting increases proportionally to the square root of the difference between the importance level values plus 1. This ILWeighting value provides a moderate bias when you compare displaceable capacity at different importance levels.
- 2
- Indicates that WLM should weight displaceable capacity at each successively lower importance level significantly higher than the capacity that is at the preceding higher importance level. The weighting increases proportionally to the difference between the importance level values plus 1. This ILWeighting value provides an aggressive bias when you compare displaceable capacity at different importance levels.
- 3
- Indicates that WLM should weight displaceable capacity at each successively lower importance level significantly higher than the capacity that is at the preceding higher importance level. The weighting grows proportionally to the square of the difference between the importance level values plus 1. This ILWeighting value provides an exceptionally aggressive bias when you compare displaceable capacity at different importance levels.
- GrpName
- The name of the targeted server application group, if TIER1 or TIER2 was specified for this DVIPA. This name is used to correlate the two tiers of sysplex distribution to and from tier 1 targets.
- RtgType
- Indicates the protocol that is used when requests are routed to
the tier 1 targets.
- GRE
- Indicates that IPv4 Generic Routing Encapsulation (GRE) is used to forward requests.
- ENCAP
- Indicates that IPv6 encapsulation is used to forward requests.
- CtrlPort
- Specifies the port number to be used for the control connection with the tier 1 target.
- VIPA Service Manager
- Displays the configured dynamic VIPA service manager information.
- McastGroup
- The multicast address used for communications between the sysplex distributor and the Cisco routers acting as forwarding agents.
- Port
- The UDP port used for communications between the sysplex distributor and Cisco forwarding agents.
- PWD
- Indicates whether the SMPASSWORD was specified.
- VIPA Route
- Displays the configured route information defined by the VIPAROUTE
statement.
For a SHORT format report:
- XCF Address
- The dynamic XCF address (IPCONFIG DYNAMICXCF) of a target stack.
- TargetIp
- The IP address in the HOME list of the target stack that should be used to obtain the best available route from the sysplex distributor to that target.
For a LONG format report:
- DestXCF
- The dynamic XCF address (IPCONFIG DYNAMICXCF or IPCONFIG6 DYNAMICXCF) of a target stack.
- TargetIp
- The IP address in the HOME list of the target stack that should be used to obtain the best available route from the sysplex distributor to that target.
- Deactivated Dynamic VIPA Information
- Displays the configured VIPABACKUP, VIPADEFINE, and VIPADISTRIBUTE definitions that have been deactivated by the VARY TCPIP,,SYSPLEX,DEACTIVATE,DVIPA= command. See VARY TCPIP,,SYSPLEX for more information about the command.