Netstat HOme/-h report
Displays information about each home IP address and its associated link or interface name.
For more information about the home list, see the z/OS Communications Server: IP Configuration Reference.
TSO syntax
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
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
- INTFName/-K intfname
- Filter the output of the HOme/-h report
using the specified interface name intfname.
You can enter one filter value at a time and the specified value can
be up to 16 characters long. The INTFName filter value intfname can be one of the following names:
- The link name of a network interface that was configured on a LINK profile statement (this option selects one interface).
- The interface name of a network interface that was configured on an INTERFACE profile statement (this option selects one interface).
- The port name of an OSA-Express feature in QDIO mode, where the port name value is the name that is specified on the PORTNAME keyword in the TRLE (this option selects all interfaces that are associated with the OSA-Express port).
- The name of a HiperSockets™ TRLE. This option selects all interfaces that are associated with the HiperSockets TRLE.
Restriction: The INTFName/-K filter value does not support wildcard characters.
Command syntax examples
From TSO environment
NETSTAT HOME
Display the home list information for the default stack. If the stack is IPv6-enabled,
then both IPv4 and IPv6 home list information are displayed.
NETSTAT HOME TCP TCPCS6
Display the home list information for the TCPCS6 stack. If the TCPCS6 stack is
IPv6-enabled, then both IPv4 and IPv6 home list information are displayed.
NETSTAT HOME TCP TCPCS8 (INTFNAME OSAQDIOLINK
Display the home list information for the OSAQDIOLINK in the TCPCS8 TCP/IP adress space.From UNIX shell environment
netstat -h
netstat -h -p tcpcs6
netstat -h -p tcpcs8 -KReport 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 HOME
MVS TCP/IP NETSTAT CS V2R1 TCPIP NAME: TCPCS 17:41:00
Home address list:
Address Link Flg
------- ---- ---
9.67.115.5 OSAQDIOLINK P
9.67.113.11 TR1
201.2.10.31 VIPLC9020A1F I
127.0.0.1 LOOPBACK
Address Interface Flg
------- --------- ---
9.2.2.2 VIRTUAL2
9.67.125.5 OSAQDIOINTF
9.1.1.1 HIPERSOCK1 NETSTAT HOME
EZZ2350I MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 19:43:50
EZZ2700I Home address list:
EZZ2701I Address Link Flg
EZZ2702I ------- ---- ---
EZZ2703I 10.220.0.1 EZASAMEMVS
EZZ2703I 127.0.0.1 LOOPBACK
EZZ2704I Address Interface Flg
EZZ2704I ------- --------- ---
EZZ2703I 0.0.0.0 LOSAQDIO2 PI IPv6 enabled or request for LONG format
NETSTAT HOME
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 14:23:53
Home address list:
LinkName: OSAQDIOLINK
Address: 9.67.115.5
Flags: Primary
LinkName: TR1
Address: 9.67.113.11
Flags:
LinkName: VIPLC9020A1F
Address: 201.2.10.31
Flags: Internal
LinkName: LOOPBACK
Address: 127.0.0.1
Flags:
IntfName: VIRTUAL2
Address: 9.2.2.2
Flags:
IntfName: OSAQDIOINTF
Address: 9.67.125.5
Flags:
IntfName: HIPERSOCK1
Address: 9.1.1.1
Flags:
IntfName: VIPAV6
Address: 2001:0db8::a:9:67:115:5
Type: Global
Flags:
Address: 50c9:c2d4:0:a:9:67:115:5
Type: Global
Flags: Deprecated
IntfName: OSAQDIO46
Address: 2001:0db8::9:67:125:5
Type: Global
Flags:
Address: fe80::6:2900:1dc:217c
Type: Link_Local
Flags: Autoconfigured
IntfName: OSAQDIO48
Address: fe80::6:2900:6dc:217c
Type: Link_Local
Flags: Autoconfigured
Address: 50c9:c2d4::6:2900:6dc:217c
Type: Global
Flags: Autoconfigured
Address: 50c9:c2d4::a8ed:838d:c853:3832
Type: Global
Flags: Autoconfigured,Temporary
ValidLifetimeExp: 08/28/2011 15:35
Address: 50c9:c2d4::5757:3772:9494:9944
Type: Global
Flags: Autoconfigured,Temporary,Deprecated
ValidLifetimeExp: 08/21/2011 16:36
IntfName: LOOPBACK6
Address: ::1
Type: Loopback
Flags:
Unavailable IPv6 Home addresses:
IntfName: OSAQDIO26
Address: 2001:0db8::9:67:115:66
Type: Global
Reason: Duplicate address detection pending start of interface
Address: 2001:0db8::/64
Type: Global
Reason: Interface ID not yet known NETSTAT HOME
MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPCS 19:47:19
Home address list:
LinkName: EZASAMEMVS
Address: 10.220.0.1
Flags:
LinkName: LOOPBACK
Address: 127.0.0.1
Flags:
IntfName: LOSAQDIO2
Address: 0.0.0.0
Flags: Primary Internal Report field descriptions
For a SHORT format report
- Address
- IPv4 address for this home entry.
- Link
- Link name for this home entry.
- Flg
- Flags, which include the following values:
- P
- Primary interface.
- I
- One of the following flags:
- An internally generated dynamic VIPA that is not advertised to
routing daemons or an interface that is defined with the TEMPIP
keyword. This flag is displayed for the following VIPAs or interfaces:
- Dynamic VIPAs that are created on target stacks for the sysplex distributor
- Dynamic VIPAs on stacks that are the endpoint for connections where the dynamic VIPA has moved to another stack
- IPAQENET interfaces that are defined with the TEMPIP keyword
- An interface that is defined with the TEMPIP keyword. This flag is displayed for IPAQENET interfaces that are defined with the TEMPIP keyword.
- An internally generated dynamic VIPA that is not advertised to
routing daemons or an interface that is defined with the TEMPIP
keyword. This flag is displayed for the following VIPAs or interfaces:
For a LONG format report
For an IPv4 home list entry:
- Address
- IPv4 address for this home entry.
- LinkName
- Link name for this home entry.
- Flags
-
- Primary
- Primary interface.
- Internal
- One of the following flags:
- An internally generated dynamic VIPA that is not advertised
to routing daemons or an interface that is defined
with the TEMPIP keyword. This flag is displayed for the following
dynamic VIPAs or interfaces:
- Dynamic VIPAs that are created on target stacks for the sysplex distributor
- Dynamic VIPAs on stacks that are the endpoint for connections where the dynamic VIPA has moved to another stack
- IPAQENET interfaces that are defined with the TEMPIP keyword
- An interface that is defined with the TEMPIP keyword. This flag is displayed for IPAQENET interfaces that are defined with the TEMPIP keyword.
- An internally generated dynamic VIPA that is not advertised
to routing daemons or an interface that is defined
with the TEMPIP keyword. This flag is displayed for the following
dynamic VIPAs or interfaces:
For an IPv6 home list entry:
- IntfName
- Interface name for this home entry.
- Address
- IPv6 address for this home entry.
- Type
- Address type that can be Global, Loopback, or Link_Local.
- Flags
-
- Autoconfigured
- The IP address was built from prefix information supplied by the router.
- Deprecated
- The preferred lifetime of the autoconfigured address has expired.
- Internal
- An internally generated VIPA that is not advertised to routing daemons.
- Temporary
- A temporary IP address that was built from prefix information that was supplied by the router, and a randomly generated interface ID.
- ValidLifetimeExp
- The time at which the IPv6 temporary autoconfigured address will be deleted. This valid lifetime can be extended by router-supplied information. This field is displayed only for a temporary IP address.
For an IPv6-enabled stack, the unavailable IPv6 home addresses
are also displayed, which contain the following information for each
entry in the list:
- IntfName
- Interface name for this home entry.
- Address
- IPv6 address for this home entry.
- Type
- Address type including Global, Loopback, or Link_Local.
- Reason
- Reason the IP address is unavailable:
- Duplicate address detection in progress
- Duplicate address detection is in progress to determine if another node is currently using the IP address. The IP address is made available if it is determined to be unique on the local link.
- Duplicate address detected
- Duplicate address detection was previously done for this IP address and the IP address was in use elsewhere.
- Duplicate address detection pending start of interface
- Duplicate address detection has been requested for the interface but the interface has not been started. The interface must be started before duplicate address detection can be done and this IP address made available.
- Duplicate address detection prevented by IPSec
- Duplicate address detection has been requested for the interface, but the outbound Neighbor Solicitation packet has been denied by IPSec policy.
- Interface ID not yet known
- This reason applies to interfaces for which duplicate address detection will not be performed (for example, where a value of 0 was configured for the DUPADDRDET parameter) and where an IP address prefix was configured. An interface ID is required to append to the prefix to create the full IP address. The interface ID is not available until the interface is successfully started.