Netstat VIPADyn/-v report
Displays the current dynamic VIPA and VIPAROUTE information for a local host.
TSO syntax
Modifier
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.
Command syntax examples
From TSO environment
NETSTAT VIPADYN
Display the current dynamic VIPA and VIPAROUTE information for a local host in the default
TCP/IP stack.
NETSTAT VIPADYN DVIPA
Display the current dynamic VIPA information for a local host in the default TCP/IP stack.
NETSTAT VIPADYN VIPAROUTE
Display the current VIPAROUTE information for a local host in the default TCP/IP stack.
NETSTAT VIPADYN TCP TCPCS6
Display the current dynamic VIPA and VIPAROUTE information for a local host in the TCPCS6
stack.
From UNIX shell environment
netstat -v
netstat -v DVIPA
netstat -v VIPAROUTE
netstat -v -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.
Not IPv6 enabled (SHORT format)
NETSTAT VIPADYN
MVS TCP/IP NETSTAT CS V2R2 TCPIP Name: TCPCS 18:28:50
Dynamic VIPA:
IP Address AddressMask Status Origination DistStat
---------- ----------- ------ ----------- --------
201.2.10.11 255.255.255.192 Active VIPADefine Dist
ActTime: 03/02/2005 16:45:20
201.2.10.12 255.255.255.192 Active VIPADefine Dist/Dest
ActTime: 03/02/2005 16:45:20
201.2.10.14 255.255.255.192 Backup VIPABackup
ActTime: n/a
201.2.10.32 <None> Backup VIPABackup
ActTime: n/a
199.199.199.8 255.255.255.0 ACTIVE VIPARANGE IOCTL
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1A
Affinity: No
199.199.199.9 255.255.255.0 ACTIVE VIPARANGE BIND
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1B
VIPA Route:
XCF Address TargetIp RtStatus
----------- -------- --------
201.10.10.1 201.20.20.1 Defined
201.10.10.2 201.20.20.2 Active
201.10.10.3 201.20.20.3 Unavail
NETSTAT VIPADYN DVIPA
MVS TCP/IP NETSTAT CS V2R2 TCPIP Name: TCPCS 18:28:50
Dynamic VIPA:
IP Address AddressMask Status Origination DistStat
---------- ----------- ------ ----------- --------
201.2.10.11 255.255.255.192 Active VIPADefine Dist
ActTime: 03/02/2005 16:45:20
201.2.10.12 255.255.255.192 Active VIPADefine Dist/Dest
ActTime: 03/02/2005 16:45:20
201.2.10.14 255.255.255.192 Backup VIPABackup
ActTime: n/a
201.2.10.32 <None> Backup VIPABackup
ActTime: n/a
199.199.199.8 255.255.255.0 ACTIVE VIPARANGE IOCTL
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1A
Affinity: No
199.199.199.9 255.255.255.0 ACTIVE VIPARANGE BIND
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1B
NETSTAT VIPADYN VIPAROUTE
MVS TCP/IP NETSTAT CS V2R2 TCPIP Name: TCPCS 18:28:50
VIPA Route:
XCF Address TargetIp RtStatus
----------- -------- --------
201.10.10.1 201.20.20.1 Defined
201.10.10.2 201.20.20.2 Active
201.10.10.3 201.20.20.3 Unavail
IPv6 enabled or request for LONG format
NETSTAT VIPADYN
MVS TCP/IP NETSTAT CS V2R2 TCPIP Name: TCPCS 18:29:44
Dynamic VIPA:
IpAddr/PrefixLen: 201.2.10.11/26
Status: Active Origin: VIPADefine DistStat: Dist
ActTime: 03/02/2005 16:45:20
IpAddr/PrefixLen: 201.2.10.12/26
Status: Active Origin: VIPADefine DistStat: Dist/Dest
ActTime: 03/02/2005 16:45:20
IpAddr/PrefixLen: 201.2.10.14/26
Status: Backup Origin: VIPABackup DistStat:
ActTime: n/a
IpAddr/PrefixLen: 201.2.10.32
Status: Backup Origin: VIPABackup DistStat:
ActTime: n/a
IPADDR/PREFIXLEN: 199.199.199.8/24
Status: Active Origin: VIPARange IOCTL Affinity: No
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1A
IPADDR/PREFIXLEN: 199.199.199.9/24
Status: Active Origin: VIPARange BIND
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1B
IntfName: INTFNAM1
IpAddr: 2001:0db8::522:f103
Status: Active Origin: VIPADefine DistStat: Dist/Dest
ActTime: 03/02/2005 16:45:20
IntfName: INTFNAM2
IpAddr: 2001:0db8::522:f203
Status: Active Origin: VIPADefine DistStat:
ActTime: 03/02/2005 16:45:20
IntfName: INTFNAMR1
IpAddr: 2001:0db8::522:f229
Status: Active Origin: VIPARange IOCTL Affinity: No
ActTime: 03/02/2005 16:45:20 JobName: JOBTST6A
VIPA Route:
DestXCF: 201.10.10.1
TargetIp: 201.20.20.1
RtStatus: Defined
DestXCF: 201.10.10.2
TargetIp: 201.20.20.2
RtStatus: Active
DestXCF: 2eco::500:f103
TargetIp: 2eco::100:f103
RtStatus: Unavail
NETSTAT VIPADYN DVIPA
MVS TCP/IP NETSTAT CS V2R2 TCPIP Name: TCPCS 18:29:44
Dynamic VIPA:
IpAddr/PrefixLen: 201.2.10.11/26
Status: Active Origin: VIPADefine DistStat: Dist
ActTime: 03/02/2005 16:45:20
IpAddr/PrefixLen: 201.2.10.12/26
Status: Active Origin: VIPADefine DistStat: Dist/Dest
ActTime: 03/02/2005 16:45:20
IpAddr/PrefixLen: 201.2.10.14/26
Status: Backup Origin: VIPABackup DistStat:
ActTime: n/a
IpAddr/PrefixLen: 201.2.10.32
Status: Backup Origin: VIPABackup DistStat:
ActTime: n/a
IPADDR/PREFIXLEN: 199.199.199.8/24
Status: Active Origin: VIPARange IOCTL Affinity: No
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1A
IPADDR/PREFIXLEN: 199.199.199.9/24
Status: Active Origin: VIPARange BIND
ActTime: 03/02/2005 16:45:20 JobName: JOBTST1B
IntfName: INTFNAM1
IpAddr: 2001:0db8::522:f103
Status: Active Origin: VIPADefine DistStat: Dist/Dest
ActTime: 03/02/2005 16:45:20
IntfName: INTFNAM2
IpAddr: 2001:0db8::522:f203
Status: Active Origin: VIPADefine DistStat:
ActTime: 03/02/2005 16:45:20
IntfName: INTFNAMR1
IpAddr: 2001:0db8::522:f229
Status: Active Origin: VIPARange IOCTL Affinity: No
ActTime: 03/02/2005 16:45:20 JobName: JOBTST6A
NETSTAT VIPADYN VIPAROUTE
MVS TCP/IP NETSTAT CS V2R2 TCPIP Name: TCPCS 18:29:44
VIPA Route:
DestXCF: 201.10.10.1
TargetIp: 201.20.20.1
RtStatus: Defined
DestXCF: 201.10.10.2
TargetIp: 201.20.20.2
RtStatus: Active
DestXCF: 2eco::500:f103
TargetIp: 2eco::100:f103
RtStatus: Unavail
Report field descriptions
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
- Dynamic VIPA
- Displays the current dynamic VIPA information.
- Status
- The state of the DVIPA on this stack. It can be any one of the
following value:
- Active
- The DVIPA is active on this stack.
- Backup
- This stack is eligible to activate the DVIPA if the stack where
the DVIPA is currently active goes down or deletes the DVIPA.
Tip: If the DistStat value is equal to Dest, then the DVIPA is currently a target for distribution.
- Moving
- The DVIPA was active on this stack and has been moved to another stack. The DVIPA remains in 'Moving' status no established connections exist. Connections on this stack for this DVIPA that were established before the move are being serviced. If new connections on this stack use the DVIPA, they are also serviced.
- Quiescing
- The DVIPA was a target for distribution and has been removed as a target. However, connections for this DVIPA are still being serviced. The DVIPA is removed from this stack when all its connections complete.
- Origin
- Indicates how the DVIPA was created. It can be one of the following
value:
- VIPABackup
- The DVIPA was created with a VIPABACKUP profile statement.
- VIPADefine
- The DVIPA was created with a VIPADEFINE profile statement.
- VIPARange Bind
- The DVIPA was created when a socket did an explicit bind to an IP address that fell with a range of IP addresses configured on a VIPARANGE profile statement.
- VIPARange ioctl
- The DVIPA was created when an application, or the MODDVIPA utility, issued an SIOCSVIPA or SIOCSVIPA6 ioctl to create a DVIPA that was within a range of IP addresses configured on a VIPARANGE profile statement
- Blank
- The DVIPA was not explicitly created on this stack. It was dynamically created when another stack processed a VIPADISTRIBUTE statement that specified this stack to be a target for connections to this DVIPA.
- DistStat
- Indicates that the distribution status for this DVIPA. It can
be one of the following value:
- Dist
- This stack is distributing incoming connections for the DVIPA to one or more other stacks in the sysplex.
- Dist/Dest
- This stack is distributing incoming connections for this DVIPA to one or more stacks in the sysplex and this stack is also a target for the distribution.
- Dest
- The DVIPA was activated on this stack because this stack is a target for distributed connections to this DVIPA.
- Blank
- The DVIPA is neither being distributed by this stack, nor a target of distribution from another stack.
Rule: DistStat is not used if the Origin is VIPARANGE.
- Affinity
- Indicates whether a DVIPA with an origin of VIPARANGE IOCTL was
created with affinity. A connection request for a DVIPA that was created
with affinity is sent to a TCP listener if its bind() call was issued
by the application instance that created the DVIPA. If no matching
listener is found, a TCP listener is selected by using normal shareport
load balancing.
- No
- A DVIPA was not created with affinity.
- Yes
- A DVIPA was created with affinity.
- ActTime
- The time when this DVIPA was activated on the local stack, either
because it is the owner of the DVIPA or because it is a target for
this DVIPA, specified as Coordinated Universal Time (UTC).
The value n/a indicates that this DVIPA was not owned by this stack or that this stack is not the target for distributed connections to this DVIPA.
- JobName
- The job name of either the application or the MODDVIPA utility
that enabled creation of this DVIPA. This field is significant only
when this DVIPA was created with one of the following methods:
- A socket performed an explicit bind to an IP address that fell within a range of IP addresses configured on a VIPARANGE profile statement.
- An application or the MODDVIPA utility issued an SIOCSVIPA or SIOCSVIPA6 ioctl call to create a DVIPA that fell within a range of IP addresses configured on a VIPARANGE profile statement.
- Applications submitted as batch jobs use the batch job name.
- The job name associated with applications that are started from
the MVS™ operator console using
the START command is determined as follows:
- If the START command is issued with the name of a member in a cataloged procedure library (for example, S APP1), then the job name is the member name (for example, APP1).
- If the member name on the START command is qualified by a started task identifier (for example, S APP1.ABC), then the job name is the started task identifier (for example, ABC).
The JOBNAME value can also be included on the JOB card.
- Applications that are run from a TSO user ID use the TSO user ID as the job name.
- Applications that run from the z/OS® shell usually have a job name that is the logged on user ID plus a 1-character suffix.
- Authorized users can run applications from the z/OS shell and use the _BPX_JOBNAME environment variable to set the job name. In this case, the value specified for the environment variable is used as the job name.
- z/OS UNIX applications started by INETD typically use the job name of the INETD server plus a 1-character suffix.
- VIPA Route
- Displays the current VIPAROUTE information.
- XCF Address or 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.
- RtStatus
- Indicates the status of the route entry. Can have the following
values:
- Active
- Indicates that the target stack identified by XCF Address or DestXCF is active, that TargetIp is defined at that target stack, and at least one route is available to TargetIp. The local stack will forward DVIPA packets to the target stack using normal IP routing table to determine the best available route.
- Defined
- Indicates that the target stack identified by XCF Address or DestXCF is not active or that the target stack is the same as the stack on which the VIPAROUTE is defined.
- Inactive
- Indicates that the target stack identified by XCF Address or DestXCF is active and that TargetIp is defined at that target stack; however no route is available to TargetIp. As a result, the local stack cannot forward any DVIPA packets to the target stack. For more information, see the steps for diagnosing sysplex routing problems in the z/OS Communications Server: IP Diagnosis Guide.
- Unavail
- Indicates that the target stack identified by XCF Address or DestXCF
is active, but that TargetIp is not defined
at that target stack. The local stack will forward DVIPA packets to
the target stack using dynamic XCF interfaces. Message EZD1173I is
issued when the routing stack detects this condition.
To correct the problem take the following actions:
- Verify that the VIPAROUTE statement specifies the correct dynamic XCF address and target IP address for the required target stack.
- Verify that the target IP address is correctly defined in the HOME list of the target stack.