Netstat ARp/-R report

Queries the ARP cache information. In addition to ARP cache entries for physical devices, when applicable, ARP cache entries for all configured static and dynamic VIPAs are displayed as potential ARP targets, even when they might not be used.

Tip: This report can also display all IPv4 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 ARp--| Modifier |--| Target |--| Output |-----------><

Modifier


>>-+-netAddress-+----------------------------------------------><
   '-ALL--------'

netAddress: Queries the ARP cache for a given address.

ALL: Queries all ARP cache entries. In addition to ARP cache entries for physical devices when applicable, ARP cache entries for all configured static and dynamic VIPAs are displayed as potential ARP targets, even when they might not be used.

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


>>-netstat -R--| Modifier |----| Target |--| Output |----------><

Modifier


>>-+-netAddress-+----------------------------------------------><
   '-ALL--------'

netAddress: Queries the ARP cache for a given address.

ALL: Queries all ARP cache entries. In addition to ARP cache entries for physical devices when applicable, ARP cache entries for all configured static and dynamic VIPAs are displayed as potential ARP targets even when they might not be used.

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 -p 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 ARP 201.2.10.32
Queries the ARP cache for 201.2.10.32 in the default TCP/IP stack. 
NETSTAT ARP ALL TCP TCPCS6
Queries all ARP cache entries in TCPCS6 stack.

From UNIX shell environment

   netstat -R 201.2.10.32
   netstat -R ALL -p tcpcs6

Report examples

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

NETSTAT ARP ALL
MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            12:48:54 
Querying ARP cache for address 201.2.10.32                             
Interface: SZ_TR1            IBMTR: 08005A0D97A2                            
Route info: 0270                                                       
                                                                       
Querying ARP cache for address 201.2.10.31                             
Interface: SZ_TR1            IBMTR: 08005A0D97A2                            
Route info: 0270                                                       
                                                                       
Querying ARP cache for address 9.67.128.1                               
Interface: IQDIOLNKC0010203  IPAQIDIO                                         
                                                                        
Querying ARP cache for address 9.67.1.8                                
Interface: OSA90LINK1        NSAP: 39999999999999999999ABCDEFABCD1234567890 

Querying ARP cache for address 172.16.0.1                                        
Interface: OSXCAINT1         ETHERNET: 420003AA0E56                              
   
Querying ARP cache for address 172.16.0.2                                        
Interface: OSXCAINT1         ETHERNET: 420003AA0E5A                              

Querying ARP cache for address 172.16.0.1                                   
Interface: EZAIQXCA          IPAQIQDX: 820005AA0E0E  OSX: OSXCAINT1         
                                                                                  
Querying ARP cache for address 172.16.0.2                              
Interface: EZAIQXCA          IPAQIQDX: 820006AA0E22  OSX: OSXCAINT1

NETSTAT ARP 201.2.10.32
MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            12:48:54 
Querying ARP cache for address 201.2.10.32                             
Interface: SZ_TR1            IBMTR: 08005A0D97A2                            
Route info: 0270

Tip: This report does not reflect information for certain devices that support ARP offload. The information provided differs depending on the type of device. See the z/OS Communications Server: IP Configuration Reference or the z/OS Communications Server: SNA Network Implementation Guide for more information.

Report field descriptions

IP address: The IP address from the ARP cache.

Interface: The interface name.

Interface Type: The interface type.

MAC address: The MAC address associated with the IP address. This field is not displayed for HiperSockets links.

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

Route info: The Token Ring Routing Information Field (RIF). See the RIF portion of RFC 1042 for detailed information about this field. This field is displayed only for Token Ring links.