Netstat ND/-n report

Displays the IPv6 Neighbor cache entries.

Tip: This report can also be used to display all IPv6 addresses on the HiperSockets™ internal LAN to which the stack has a route over this interface.

Guideline: For HiperSockets interfaces, the stack requests this data from the appropriate device. If a device does not return this data in a timely fashion, then Netstat will not display data for that interface.

TSO syntax


>>---NETSTAT ND--| Target |--| Output |--| (Filter |-----------><

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-'

z/OS UNIX syntax


>>---netstat -n--| Target |--| Output |--| Filter |------------><

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                      |   
>>- -I----+-ipaddr-----------+-+-------------------------------><
          '-ipaddr/prefixLen-'

Filter description

IPAddr/-I ipaddrIPAddr/-I ipaddr/prefixlength

Filter the report output using the specified IP address ipaddr or ipaddr/prefixlength. You can enter up to six filter values. Each specified ipaddr value must be an IPv6 address that can be up to 45 characters in length.

ipaddr: Filter the output of the ND/-n report using the specified IP address ipaddr. The default prefixlength is 128.

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

Restrictions:

The filter value for an IPv6 address does not support wildcard characters.
For the ND/-n report, an IPv4 ipaddr value is not accepted.
For an IPv6-enabled stack, an IPv4-mapped IPv6 address is accepted and is treated as an IPv6 address. If an IPv4-mapped IPv6 address is entered as an IPAddr/-I value, there is no matching entry found.

Command syntax examples

From TSO environment

   NETSTAT ND

From UNIX shell environment

   netstat -n

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.

NETSTAT ND
MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:33:33 
Query Neighbor cache for fe80::202:55ff:fe64:2de7                     
  Intfname: OSAQDIO46          Intftype: IPAQENET6                    
  LinklayerAddr: 000255642DE7  State: Stale                           
  Type: Host                   AdvDfltRt: No                          
Query Neighbor cache for 2001:0db8::9:67:114:46                       
  Intfname: OSAQDIO46          Intftype: IPAQENET6                    
  LinkLayerAddr: 0060CF208827  State: Reachable                       
  Type: Host                   AdvDfltRt: No                          
Query Neighbor cache for fe80::206:2aff:fe71:4400                     
  IntfName: OSAQDIO46          IntfType: IPAQENET6                    
  LinkLayerAddr: 00062A714400  State: Reachable                       
  Type: Route                  AdvDfltRt: Yes                         
Query Neighbor cache for fe80::206:2aff:fe66:c800                     
  IntfName: OSAQDIO46          IntfType: IPAQENET6                    
  LinkLayerAddr: 00062A66C800  State: Stale                           
  Type: Route                  AdvDfltRt: Yes                         
Query Neighbor cache for fe80::6000:1ff:feaa:e5a  
     IntfName: OSXC9INT2          IntfType: IPAQENET6                 
     LinkLayerAddr: 620001AA0E5A  State: Reachable                    
     Type: Host                   AdvDfltRtr: No                      
Query Neighbor cache for 2001:db8:172::16:0:2                         
     IntfName: OSXC9INT2          IntfType: IPAQENET6                 
     LinkLayerAddr: 620001AA0E5A  State: Reachable                    
     Type: Host                   AdvDfltRtr: No                      
Query Neighbor cache for 2001:db8:172::16:0:2                          
     IntfName: EZ6IQXC9           IntfType: IPAQIQDX6    OSX: OSXC9INT2
     LinkLayerAddr: 820002AA0E22  State: Reachable                    
     Type: Host                   AdvDfltRtr: No

Report field descriptions

Neighbor's IP address

IntfName: Interface name where the neighbor cache entry exists.

IntfType: Interface type.

OSX: For HiperSockets interfaces that use the Internal Queued Direct I/O extensions function (IQDX), this field indicates the associated OSX interface.

LinkLayerAddr: Neighbor's link layer address (MAC address).

State

Reachability state of the neighbor as defined in RFC 2461. Possible values include:

Incomplete: Address resolution has not been completed.

Reachable: Confirmation of neighbor's reachability received recently (within ReachableTime as defined by RFC 2461).

Stale: Reachability confirmation not recent.

Delay: Reconfirmation of reachability can be done after a short delay.

Probe: In process of reconfirming neighbor's reachability.

Type: Neighbor type is either Host or Router.

AdvDfltRtr

Whether the neighbor advertised itself as a default router.

Y: Indicates the neighbor advertised itself as a default router.

N: Indicates the neighbor did not advertise itself as a default router.