Netstat ROUTe/-r report

Displays the routing information that this stack uses when it determines what addresses it can communicate with and over which links or interfaces and first hops the communication takes place. The routes in the stack main routing table can be displayed, as well as the routes in the stack policy-based routing tables. These routes can be static routes (those defined in the TCP/IP profile for the main route table and those defined to the Policy Agent for policy-based route tables), routes learned from routing daemons, and routes learned by other ICMP or ICMPv6 information, such as redirects. If there is no route that covers the destination IP address and if there is no default route defined, then this stack cannot communicate with that destination. Multiple routes to the same destination, referred to as multipath routes, are also displayed. If multipath is not enabled (on the IPCONFIG or IPCONFIG6 statement for the main route table and on the RouteTable policy statement for policy-based route tables), then the first active route to the destination is always used.

Tip: Static routes over deleted interfaces are removed from the main routing table and therefore do not appear in reports that are generated for the main routing table. Loopback routes are displayed as well as implicit (HOME list) routes.

TSO syntax

Read syntax diagramSkip visual syntax diagram
>>---NETSTAT ROUTe--| Modifier |--| Target |--| Output |--| (Filter |---><

Modifier

Read syntax diagramSkip visual syntax diagram
   .------------------------.   
   V                        |   
>>---+--------------------+-+----------------------------------><
     +-ADDRTYPE--+-IPV4-+-+     
     |           '-IPV6-' |     
     +-DETAIL-------------+     
     +-IQDIO--------------+     
     +-PR--+-ALL----+-----+     
     |     '-prname-'     |     
     +-QDIOACCEL----------+     
     +-RADV---------------+     
     '-RSTAT--------------'     

ADDRTYPE IPV4 | IPV6
Display the specified IP type routing information.
IPV4
Display IPv4 routing information. This parameter is mutually exclusive with the RADV parameter.
IPV6
Display IPv6 routing information.
DETAIL
Displays additional details such as the metric or cost of use for the route, MTU size if it is an IPv4 route, and the MVS™ specific configured parameters for each route.

This parameter is mutually exclusive with the QDIOACCEL and IQDIO parameters.

PR
Displays policy-based routing tables. This parameter is mutually exclusive with the QDIOACCEL and IQDIO parameters.
ALL
Displays all policy-based routing tables.
prname
Displays the policy-based routing table that has the name prname.
Restriction: The Netstat ROUTe command displays only active policy-based route tables. A policy-based route table is active if it is referenced by an active routing rule and its associated action. You can display active and inactive policy-based route tables with the pasearch command. For more information, see The z/OS UNIX pasearch command: Display policies.
QDIOACCEL
IQDIO
Displays the routes that are eligible for accelerated routing using QDIO Accelerator or HiperSockets™ Accelerator. See the QDIO Accelerator information and the information about efficient routing using HiperSockets Accelerator in z/OS Communications Server: IP Configuration Guide for more details. This parameter is mutually exclusive with the DETAIL, RADV, PR, and RSTAT parameters.
RADV
Displays all of the IPv6 routes that are added based on information received in router advertisement messages. All IPv6 router advertisement routes are displayed whether or not they are currently used for routing. The flags and reference count are not displayed on the report. This parameter is mutually exclusive with the RSTAT, QDIOACCEL, IQDIO, and ADDRTYPE IPV4 parameters.
RSTAT
Displays all of the static routes that are defined as replaceable. All defined replaceable static routes are displayed whether or not they are currently being used for routing. The flags and reference count are not displayed on the report. This parameter is mutually exclusive with the RADV, QDIOACCEL, and IQDIO 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.

Filter

Read syntax diagramSkip visual syntax diagram
           .-----------------------.   
           V                       |   
>>-IPAddr----+-ipaddr------------+-+---------------------------><
             +-ipaddr/prefixLen--+     
             '-ipaddr/subnetmask-'     

z/OS UNIX syntax

Read syntax diagramSkip visual syntax diagram
>>---netstat -r--| Modifier |--| Target |--| Output |--| Filter |---><

Modifier

Read syntax diagramSkip visual syntax diagram
   .------------------------.   
   V                        |   
>>---+--------------------+-+----------------------------------><
     +-ADDRTYPE--+-IPV4-+-+     
     |           '-IPV6-' |     
     +-DETAIL-------------+     
     +-IQDIO--------------+     
     +-PR--+-ALL----+-----+     
     |     '-prname-'     |     
     +-QDIOACCEL----------+     
     +-RADV---------------+     
     '-RSTAT--------------'     

ADDRTYPE IPV4 | IPV6
Display the specified IP type routing information.
IPV4
Display IPv4 routing information. This parameter is mutually exclusive with the RADV parameter.
IPV6
Display IPv6 routing information.
DETAIL
Displays additional details such as the metric or cost of use for the route, MTU size if it is an IPv4 route, and the MVS-specific configured parameters for each route. This parameter is mutually exclusive with the QDIOACCEL and IQDIO parameters.
PR
Displays policy-based routing tables. This parameter is mutually exclusive with the QDIOACCEL and IQDIO parameters.
ALL
Displays all policy-based routing tables.
prname
Displays the policy-based routing table that has the name prname.
Restriction: The Netstat ROUTe command displays only active policy-based route tables. A policy-based route table is active if it is referenced by an active routing rule and its associated action. You can display active and inactive policy-based route tables with the pasearch command. For more information, see The z/OS UNIX pasearch command: Display policies.
QDIOACCEL
IQDIO
Displays the routes that are eligible for accelerated routing using QDIO Accelerator or HiperSockets Accelerator. See QDIO Accelerator information and efficient routing using HiperSockets Accelerator information in z/OS Communications Server: IP Configuration Guide for more details. This parameter is mutually exclusive with the DETAIL, RADV, PR, and RSTAT parameters.
RADV
Displays all of the IPv6 routes that are added based on information received in router advertisement messages. All IPv6 router advertisement routes are displayed whether or not they are currently used for routing. The flags and reference count are not displayed on the report. This parameter is mutually exclusive with the RSTAT, QDIOACCEL, IQDIO, and ADDRTYPE IPV4 parameters.
RSTAT
Displays all static routes that are defined as replaceable. All defined replaceable static routes are displayed without regard to whether or not they are currently being used for routing. The flags and reference count are not displayed on the report. This parameter is mutually exclusive with the RADV, QDIOACCEL, and IQDIO parameters.

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

Read syntax diagramSkip visual syntax diagram
        .-----------------------.   
        V                       |   
>>- -I----+-ipaddr------------+-+------------------------------><
          +-ipaddr/prefixLen--+     
          '-ipaddr/subnetmask-'     

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 ROUTe/-r 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 ROUTe/-r 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 ROUTe/-r report using the specified IP address and subnet mask ipaddr/subnetmask. The IP address ipaddr in this format must be an IPv4 IP address.

The IPAddr/-I filter value can be a complete string or a partial string using wildcard characters. A wildcard character can be an asterisk (*), which matches a null string or any character or character string, at the same position. A wildcard character can be a question mark (?), which matches any single character at the same position. For example, a string "searchee" matches with "*ar?he*", but the string "searhee" does not match with "*ar?he*". If you want to use the wildcard character on the IPAddr/-I filter, you must specify the value in the ipaddr format. The wildcard character is not accepted for the ipaddr/prefixlen or ipaddr/subnetmask format of IPAddr/-I values.

When you use z/OS UNIX netstat/onetstat command in a z/OS UNIX shell environment, take care if you use a z/OS UNIX MVS special character in a character string. It might cause an unpredictable result. To be safe, if you want to use a z/OS UNIX MVS special character in a character string, surround the character string with single (') or double (") quotation marks. For example, to use an asterisk (*) in the IP address, 10.*.0.0 for the -I filter, issue the command as: netstat -r -I '10.*.0.0' or netstat -r -I "10.*.0.0".

Note: When filtering ROUTe/-r responses on a specified IP address, the DEFAULT and DEFAULTNET routes are not displayed.
Guidelines:
  1. For an IPv6-enabled stack:
    • Both IPv4 and IPv6 ipaddr values are accepted and can be mixed on the IPAddr/-I option.
    • 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.
Restrictions:
  1. The filter value for an IPv6 address does not support wildcard characters.
  2. For an IPv4-only stack, only IPv4 ipaddr values are accepted.

Command syntax examples

From TSO environment

NETSTAT ROUTE
   Display the routing information the default stack will use when it determines what 
   addresses it can communicate with and over which links/interfaces and first hops the 
   communication will take place. If the stack is IPv6-enabled, then both IPv4 and IPv6 
   routing information are displayed.
NETSTAT ROUTE TCP TCPCS6
   Display the routing information the TCPCS6 stack will use when it determines what 
   addresses it can communicate with and over which links/interfaces and first hops the 
   communication will take place. If the TCPCS6 stack is IPv6-enabled, then both IPv4 and 
   IPv6 routing information are displayed.
NETSTAT ROUTE TCP TCPCS8 (IPADDR 9.43.1.1 9.43.2.2
   Display the routing information in the TCPCS8 stack whose destination address match 
   the specified filter IP address values.
NETSTAT ROUTE ADDRTYPE IPV4
   Display the IPv4 routing information the default stack will use when it determines 
   what addresses it can communicate with and over which links/interfaces and first hops 
   the communication will take place.

From UNIX shell environment

   netstat -r
   netstat -r -p tcpcs6 
   netstat -r -p tcpcs8 -I 9.43.1.1 9.43.2.2
   netstat -r ADDRTYPE IPV4  

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 ROUTE or
NETSTAT ROUTE ADDRTYPE IPV4

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:24:09 
Destination        Gateway         Flags    Refcnt     Interface         
-----------        -------         -----    ------     ---------         
Default            9.67.115.65     UGS      0000000002 OSAQDIOLINK       
9.67.115.65/32     0.0.0.0         UHS      0000000000 OSAQDIOLINK       
9.67.115.69/32     0.0.0.0         UH       0000000000 OSAQDIOLINK       
127.0.0.1/32       0.0.0.0         UH       0000000002 LOOPBACK          
NETSTAT ROUTE DETAIL

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:03:13  
Destination        Gateway         Flags    Refcnt     Interface          
-----------        -------         -----    ------     ---------          
Default            9.67.115.1      UGS      0000000000 OSAQDIO5L          
  Metric: 00000001  MTU: 1496           
  MVS Specific Configured Parameters:                                  
    MaxReTransmitTime:  120.000   MinReTransmitTime: 0.500             
    RoundTripGain:      0.125     VarianceGain:      0.250             
    VarianceMultiplier: 2.000     DelayAcks:         Yes               
        
NETSTAT ROUTE RSTAT

MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            17:40:36 
IPv4 Destinations                                                      
Destination        Gateway         Interface                            
-----------        -------         ---------                            
9.67.1.9/32        0.0.0.0         OSA00LINK1                           
NETSTAT ROUTE QDIOACCEL 

MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            09:51:02
Destination        Gateway         Interface                       
-----------        -------         ---------                        
9.67.1.9/32        0.0.0.0         LIQDIO1        
9.67.5.10/32       0.0.0.0         OSAQDIO5L
NETSTAT ROUTE PR prtable1

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:24:09
Policy Routing Table: prtable1
  IgnorePathMtuUpdate: Yes  MultiPath: Conn(Policy)
  DynamicXCFRoutes:    No
Dynamic Routing Parameters
  Interface        NextHop
  ---------        -------
  OSAQDIOLINK      9.67.115.65
Destination        Gateway         Flags    Refcnt     Interface         
-----------        -------         -----    ------     ---------         
Default            9.67.115.65     UGS      0000000002 OSAQDIOLINK       
9.67.115.65/32     0.0.0.0         UHS      0000000000 OSAQDIOLINK       
9.67.115.69/32     0.0.0.0         UH       0000000000 OSAQDIOLINK       

IPv6 enabled or request for LONG format

NETSTAT ROUTE

MVS TCP/IP NETSTAT CS V2R1      TCPIP Name: TCPCS           14:24:09 
IPv4 Destinations                                                     
Destination Gateway Flags Refcnt Interface         
-        -         -    -     -         
Default            9.67.115.65     UGS      0000000002 OSAQDIOLINK       
9.67.115.65/32     0.0.0.0         UHS      0000000000 OSAQDIOLINK       
9.67.115.69/32     0.0.0.0         UH       0000000000 OSAQDIOLINK       
127.0.0.1/32       0.0.0.0         UH       0000000002 LOOPBACK          
IPv6 Destinations                                                     
DestIP:   Default                                                     
  Gw:     2001:0db8::206:2aff:fe71:4400                               
  Intf:   OSAQDIO46         Refcnt:  0000000000                       
  Flgs:   UGS               MTU:     1492                             
DestIP:   ::1/128                                                     
  Gw:     ::                                                          
  Intf:   LOOPBACK6         Refcnt:  0000000000                       
  Flgs:   UH                MTU:     65535                            
DestIP:   2001:0db8::9:67:115:13/128                                  
  Gw:     ::                                                           
  Intf:   OSAQDIO46         Refcnt:  0000000000                        
  Flgs:   UD                MTU:     1492                              
DestIP:   2001:0db8::206:2aff:fe71:4400/128                            
  Gw:     ::                                                           
  Intf:   OSAQDIO46         Refcnt:  0000000000                        
  Flgs:   UHS               MTU:     1492   
NETSTAT ROUTE ADDRTYPE IPV4

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:24:09 
IPv4 Destinations                                                     
Destination        Gateway         Flags    Refcnt     Interface         
-----------        -------         -----    ------     ---------         
Default            9.67.115.65     UGS      0000000002 OSAQDIOLINK       
9.67.115.65/32     0.0.0.0         UHS      0000000000 OSAQDIOLINK       
9.67.115.69/32     0.0.0.0         UH       0000000000 OSAQDIOLINK       
127.0.0.1/32       0.0.0.0         UH       0000000002 LOOPBACK          
NETSTAT ROUTE ADDRTYPE IPV6

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:24:09 
IPv6 Destinations                                                     
DestIP:   Default                                                     
  Gw:     2001:0db8::206:2aff:fe71:4400                               
  Intf:   OSAQDIO46         Refcnt:  0000000000                       
  Flgs:   UGS               MTU:     1492                             
DestIP:   ::1/128                                                     
  Gw:     ::                                                          
  Intf:   LOOPBACK6         Refcnt:  0000000000                       
  Flgs:   UH                MTU:     65535                            
DestIP:   2001:0db8::9:67:115:13/128                                  
  Gw:     ::                                                           
  Intf:   OSAQDIO46         Refcnt:  0000000000                        
  Flgs:   UD                MTU:     1492                              
DestIP:   2001:0db8::206:2aff:fe71:4400/128                            
  Gw:     ::                                                           
  Intf:   OSAQDIO46         Refcnt:  0000000000                        
  Flgs:   UHS               MTU:     1492                              
NETSTAT ROUTE DETAIL

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:03:13  
IPv4 Destinations                                                      
Destination        Gateway         Flags    Refcnt     Interface          
-----------        -------         -----    ------     ---------          
Default            9.67.115.1      UGS      0000000000 OSAQDIO5L          
  Metric: 00000001  MTU: 1496                                          
  MVS Specific Configured Parameters:                                  
    MaxReTransmitTime:  120.000   MinReTransmitTime: 0.500             
    RoundTripGain:      0.125     VarianceGain:      0.250             
    VarianceMultiplier: 2.000     DelayAcks:         Yes               
......                                                           
                                                                 
IPv6 Destinations                                                
......                                                           
                                                                 
DestIP:   2001:0db8::206:2aff:fe71:4400/128                      
  Gw:     ::                                                     
  Intf:   OSAQDIO46         Refcnt:  0000000000                  
  Flgs:   UHS               MTU:     1492                        
  Metric: 00000000                                               
  MVS Specific Configured Parameters:                            
    MaxReTransmitTime:  120.000   MinReTransmitTime: 0.500       
    RoundTripGain:      0.125     VarianceGain:      0.250       
    VarianceMultiplier: 2.000     DelayAcks:         Yes             
NETSTAT ROUTE RSTAT

MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            17:40:36 
IPv4 Destinations                                                      
Destination        Gateway         Interface                            
-----------        -------         ---------                            
9.67.1.9/32        0.0.0.0         OSA00LINK1                           
                                                                       
IPv6 Destinations                                                      
DestIP:   fe80::6:2900:1dc:21bc/128                                    
  Gw:     ::                                                           
  Intf:   OSAQDIO46  MTU:  1492                                                    
NETSTAT ROUTE QDIOACCEL 

MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            09:51:02
Destination        Gateway         Interface                       
-----------        -------         ---------                        
9.67.1.9/32        0.0.0.0         LIQDIO1    
9.67.5.10/32       0.0.0.0         OSAQDIO5L
NETSTAT ROUTE PR prtable1

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:24:09
Policy Routing Table: prtable1
  IgnorePathMtuUpdate: IPv4: No           IPv6: No
  MultiPath:           IPv4: Conn(Policy) IPv6: Pkt(Profile)
  DynamicXCFRoutes:    IPv4: No           IPv6: No
IPv4 Dynamic Routing Parameters
  Interface        NextHop
  ---------        -------
  OSAQDIOLINK      9.67.115.65
IPv4 Destinations
Destination        Gateway         Flags    Refcnt     Interface
-----------        -------         -----    ------     ---------
Default            9.67.115.65     UGS      0000000002 OSAQDIOLINK
9.67.115.65/32     0.0.0.0         UHS      0000000000 OSAQDIOLINK
9.67.115.69/32     0.0.0.0         UH       0000000000 OSAQDIOLINK
IPv6 Dynamic Routing Parameters
  Interface        NextHop
  ---------        -------
  OSAQDIO46        fe80::9:67:115:65
IPv6 Destinations
DestIP:   Default
  Gw:     2001:0db8::206:2aff:fe71:4400
  Intf:   OSAQDIO46         Refcnt: 0000000000
  Flgs:   UGS               MTU: 1492
DestIP:   2001:0db8::9:67:115:13/128
  Gw:     ::
  Intf:   OSAQDIO46         Refcnt: 0000000000
  Flgs:   UD                MTU: 1492
DestIP:   2001:0db8::206:2aff:fe71:4400/128
  Gw:     ::
  Intf:   OSAQDIO46         Refcnt: 0000000000
  Flgs:   UHS               MTU: 1492
NETSTAT ROUTE RADV

MVS TCP/IP NETSTAT CS V2R1       TCPIP NAME: TCPCS            17:40:36 
IPv6 Destinations                                                      
DestIP:   2001:0db8::206:2aff::/64                                     
  Gw:     fe80::6:2900:6dc:217c                                    
  Intf:   OSAQDIO46  MTU:  1492                                                    
NETSTAT ROUTE RADV DETAIL

MVS TCP/IP NETSTAT CS V2R1       TCPIP Name: TCPCS           14:03:13  
IPv6 Destinations                                                
......                                                           
                                                                 
DestIP:   2001:0db8::206:2aff::/64                               
  Gw:     fe80::6:2900:6dc:217c                              
  Intf:   OSAQDIO46  MTU:  1492                                  
  Metric: 00000001                LifetimeExp: 08/28/2010 15:35  
  GwReachable:  Yes               IntfActive:  Yes               
  MVS Specific Configured Parameters:                            
    MaxReTransmitTime:  120.000   MinReTransmitTime: 0.500       
    RoundTripGain:      0.125     VarianceGain:      0.250       
    VarianceMultiplier: 2.000     DelayAcks:         Yes         

Report field descriptions

Destination or DestIP
The address of a destination host or network, followed by a slash and the net mask.
Gateway or Gw
The gateway used to send packets to the destination. If the value is 0.0.0.0 for an IPv4 entry or :: for an IPv6 entry, then the destination is directly reachable without needing to go through a gateway.
GwReachable
Indicates whether IPv6 neighbor unreachability detection has detected that the gateway is reachable. The gateway is the router that originates the router advertisement message containing the route.
Yes
Indicates that the gateway is reachable.
No
Indicates that the gateway is unreachable. When the gateway is unreachable, the route is not being used for routing. If an alternate route is available, this route is not installed in the routing table.
N/A
The value is displayed for direct prefix router advertisement routes. These routes do not have an associated gateway.
Flags or Flgs
The state of the route, which can have the following values:
G
The route uses a gateway.
H
The route is to a host rather than to a network.
I
The static route in a policy-based routing table is not valid because it is configured to use a link that is not defined in the stack for the same IP version as the route.
U
The route is up.

The following flags are mutually exclusive:

C
The route was created by a connection (not using a definition or a routing protocol). Routes to subnets or point-to-point destinations using interfaces over which OMPROUTE is active but has not yet established a routing protocol are considered connection routes.
D
The route was created dynamically by ICMP processing or router advertisements (IPv6).
O
The route was created by OSPF (includes OSPF external routes).
R
The route was created by RIP.
S
The route is a static route not replaceable by a routing daemon or router advertisements (IPv6).
Z
The route is a static route replaceable by dynamic routes learned by OMPROUTE or from router advertisements (IPv6).
Interface or Intf
The link or interface name for the route.
IntfActive
Indicates whether the interface for the route is active.
Yes
Indicates that the interface is active.
No
Indicates that the interface is not active. When the interface is not active, the route is not being used for routing. If an alternate route is available, this route is not installed in the routing table.
LifetimeExp
The time at which the IPv6 router advertisement route will be deleted. This lifetime can be extended by router-supplied information. The N/A value is displayed for routes that are advertised with an infinite lifetime.
MTU
The value of the maximum transmission unit (MTU). The value can be one of the following depending on the modifier with which the report that contains the MTU value is displayed:
  • In a report that is displayed by using neither the RADV modifier nor the RSTAT modifier:
    • If the route is active, this MTU value is the largest packet size that can be sent by using this route. If the packet is larger than the MTU value, the packet must be fragmented if fragmentation is permitted. If fragmentation is not permitted, the packet is dropped and an ICMP error is returned to the originator of the packet.
    • If the route is inactive and was configured by using the BEGINROUTES, RouteTable, or GATEWAY statement, this MTU value is the same as the MTU value that was configured for the route.
    • If the route is inactive and was not configured by using the BEGINROUTES, RouteTable, or GATEWAY statement, this MTU value is either the link MTU value that is received in a router advertisement message for IPv6 routes only or 0.
  • In a report that is displayed by using the RADV modifier, this MTU value is the link MTU value that is received in a router advertisement message or 0 if no link MTU value was received.
  • In a report that is displayed by using the RSTAT modifier, this MTU value is the MTU value that was configured for the route by using the BEGINROUTES or RouteTable statement.
Metric
Displays the metric of the route. For static routes, direct routes have a metric of 0 and indirect routes have a metric of 1. If a route was learned from a routing daemon, the displayed metric is the metric that is set by the routing daemon. If a route was learned from an IPv6 router advertisement, the metric value is one of the following values:
1
When the router advertisement indicates a high preference.
2
When the router advertisement indicates a medium preference.
3
When the router advertisement indicates a low preference.
After the routes are in the stack routing table, the Metric field is not used. The routing daemons use metrics to compare routes and to inform the stack only of the routes that have the best metric.
Maximum retransmit time (MaxReTransmitTime)
The TCP retransmission interval in seconds for this route. If this parameter was not defined for the route, the default value of 120 seconds is displayed. This parameter does not affect initial connection retransmission.
Minimum retransmit time (MinReTransmitTime)
The minimum retransmit interval in seconds for this route. If this parameter was not defined for the route, the default value 0.5 (500 milliseconds) seconds is displayed.
Reference count (RefCnt)
The current number of active users for the route.
Round trip gain (RoundTripGain)
The percentage of the latest round trip time (RTT) to be applied to the smoothed RTT average. The higher this value, the more influence the latest packet RTT has on the average. If this parameter was not defined for the route, the default value 0.125 is displayed. This parameter does not affect initial connection retransmission.
Variance gain (VarianceGain)
The percentage of the latest RTT variance from the RTT average to be applied to the RTT variance average. The higher this value, the more influence the latest packet's RTT has on the variance average. If this parameter was not defined for the route, the default value 0.25 is displayed. This parameter does not affect initial connection retransmission.
Variance multiplier (VarianceMultiplier)
This value is multiplied against the RTT variance in calculating the retransmission interval. [The higher this value, the more effect variation in RTT has on calculating the retransmission interval.] If this parameter was not defined for the route, the default value 2 is displayed. This parameter does not affect initial connection retransmission.
DelayAcks
Indicates whether the DELAYACKS option is enabled or disabled. The value Yes indicates that acknowledgments are delayed when a packet is received (the DELAYACKS parameter was defined for the route). The value No indicates that acknowledgements are not delayed when a packet is received (the NODELAYACKS parameter was defined for the route).
Policy Routing Table
The name of the policy-based routing table being displayed.
IgnorePathMtuUpdate
IPv4
Indicates whether IPv4 ICMP Fragmentation Needed messages are ignored for this routing table. See the IgnorePathMtuUpdate parameter on the RouteTable statement in the z/OS Communications Server: IP Configuration Reference for more information. This field can have the following values:
Yes
IPv4 ICMP Fragmentation Needed messages are ignored for this routing table.
No
IPv4 ICMP Fragmentation Needed messages are processed for this routing table.
N/A
This value is displayed when either the routing table is not configured for IPv4 routing or only IPv6 routing information is being displayed for the table.
IPv6
Indicates whether IPv6 ICMP Packet Too Big messages are ignored for this routing table. See the IgnorePathMtuUpdate6 parameter on the RouteTable statement in the z/OS Communications Server: IP Configuration Reference for more information. This field can have the following values:
Yes
IPv6 ICMP Packet Too Big messages are ignored for this routing table.
No
IPv6 ICMP Packet Too Big messages are processed for this routing table.
N/A
This value is displayed when either the routing table is not configured for IPv6 routing or only IPv4 routing information is being displayed for the table.
MultiPath
IPv4
The information in this field is divided into two parts. The value before the parentheses indicates whether the multipath routing selection algorithm for outbound IPv4 traffic is enabled for this policy-based routing table. See the multipath parameter on the RouteTable statement in the z/OS Communications Server: IP Configuration Reference for more information. The possible values for the MultiPath field are:
Pkt
Indicates that outbound IPv4 traffic uses the round-robin distribution method to use multipath routes for each outbound packet.
Conn
Indicates that outbound IPv4 traffic uses the round-robin distribution method to use multipath routes for each outbound connection request.
No
Indicates that outbound IPv4 traffic always uses the first active route in a multipath group.
N/A
This value is displayed when either the routing table is not configured for IPv4 routing or only IPv6 routing information is being displayed for the table.
The value inside the parentheses identifies where the multipath value was obtained. The possible values are:
Profile
Indicates that the value UseGlobal has been coded on the Multipath parameter on the RouteTable statement; the value was obtained from the IPCONFIG statement.
Policy
Indicates that the multipath value was obtained from the Multipath parameter of the RouteTable statement.

Tip: If IPSECURITY is coded on the IPCONFIG statement and Multipath PerPacket is specified on a RouteTable statement, the Multipath PerPacket option is disabled. The value No(Policy) is displayed on the report. For more information, see the RouteTable statement information in the z/OS Communications Server: IP Configuration Reference.

IPv6
The information in this field is divided into two parts. The value before the parentheses indicates whether the multipath routing selection algorithm for outbound IPv6 traffic is enabled for this policy-based routing table. See the Multipath6 parameter on the RouteTable statement in the z/OS Communications Server: IP Configuration Reference for more information. The possible values for the MultiPath6 field are:
Pkt
Indicates that outbound IPv6 traffic uses the round-robin distribution method to use multipath routes for each outbound packet.
Conn
Indicates that outbound IPv6 traffic uses the round-robin distribution method to use multipath routes for each outbound connection request.
No
Indicates that outbound IPv6 traffic always uses the first active route in a multipath group.
N/A
This value is displayed when either the routing table is not configured for IPv6 routing or only IPv4 routing information is being displayed for the table.
The value inside the parentheses identifies where the multipath value was obtained. The possible values are:
Profile
Indicates that the value UseGlobal has been coded on the Multipath6 parameter on the RouteTable statement; the value was obtained from the IPCONFIG6 statement.
Policy
Indicates that the multipath value was obtained from the Multipath6 parameter of the RouteTable statement.
Tip: If IPSECURITY is coded on the IPCONFIG6 statement and Multipath6 PerPacket is specified on a RouteTable statement, the Multipath6 PerPacket option is disabled. The value No(Policy) is displayed on the report. For more information, see the RouteTable statement information in the z/OS Communications Server: IP Configuration Reference.
DynamicXCFRoutes
IPv4
Indicates whether direct routes to the IPv4 dynamic XCF addresses on other TCP/IP stacks are added to the policy-based routing table when the dynamic XCF links to those stacks are active. These are the same routes that are automatically generated in the main routing table when the IPv4 dynamic XCF links are active. See Dynamic XCF in the z/OS Communications Server: IP Configuration Guide for information about the dynamic XCF function and the definitions that are automatically generated when IPCONFIG DYNAMICXCF is specified in the TCP/IP profile. This field can have the following values:
Yes
Direct routes to the IPv4 dynamic XCF addresses on other TCP/IP stacks are added to the policy-based routing table when the dynamic XCF links to those stacks are active.
No
Direct routes to the IPv4 dynamic XCF addresses on other TCP/IP stacks are not added to the policy-based routing table when the dynamic XCF links to those stacks are active.
N/A
This value is displayed when either the routing table is not configured for IPv4 routing or only IPv6 routing information is being displayed for the table.
IPv6
Indicates whether direct routes to the IPv6 dynamic XCF addresses on other TCP/IP stacks are added to the policy-based routing table when the dynamic XCF links to those stacks are active. These are the same routes that are automatically generated in the main routing table when the IPv6 dynamic XCF links are active. See Dynamic XCF in the z/OS Communications Server: IP Configuration Guide for information about the dynamic XCF function and the definitions that are automatically generated when IPCONFIG6 DYNAMICXCF is specified in the TCP/IP profile. This field can have the following values:
Yes
Direct routes to the IPv6 dynamic XCF addresses on other TCP/IP stacks are added to the policy-based routing table when the dynamic XCF links to those stacks are active.
No
Direct routes to the IPv6 dynamic XCF addresses on other TCP/IP stacks are not added to the policy-based routing table when the dynamic XCF links to those stacks are active.
N/A
This value is displayed when either the routing table is not configured for IPv6 routing or only IPv4 routing information is being displayed for the table.
Interface
The name of the interface that is specified in a dynamic routing parameter for the policy-based routing table. If the interface is not currently defined to the TCP/IP stack for the same IP version as the dynamic routing parameter or the interface is inactive on the TCP/IP stack, the name is preceded by an asterisk (*).
NextHop
The next-hop router IP address that is specified in a dynamic routing parameter for the policy-based routing table. The value Any is displayed when no next-hop router IP address is specified for the dynamic routing parameter.