ltm rule command ROUTE age

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



ROUTE::age
       Deprecated: Returns the age of the route metrics in seconds.

SYNOPSIS
       ROUTE::age DESTINATION_IP_ADDRESS (GATEWAY_IP_ADDRESS)?

DESCRIPTION
       The amount of time that has elapsed since the last update to the
       ROUTE::rtt, ROUTE::rttvar and ROUTE::bandwidth statistics for the
       matched route metric entry.  ROUTE::age has a value of 0 when there are
       no statistics available.

       Note: As of v12.0 ROUTE::age is deprecated, as the expiration time,
       rather than the creation time, is now stored. Since deprecation,
       ROUTE::age reports the age assuming that initial timeout was the sys db
       variable route.metrics.timeout. Results are incorrect if timeout was
       changed by the TCP profile or an iRule.

       Note: The return value only applies to the TMM executing the command.
       It does not consider cache entries on other TMMs.

       Syntax

       ROUTE::age 

	    * The age of the route metrics for the given destination IP address.

       ROUTE::age  

	    * The age of the route metrics for the given destination IP address
	      reached through the given gateway.

RETURN VALUE
       The age of the route metrics in seconds

VALID DURING
EXAMPLES
	when CLIENT_ACCEPTED {
	    log local0. "Cached age is: [ROUTE::age [IP::remote_addr]]"
	}

	when CLIENT_ACCEPTED {
	    set Gateway 10.3.1.11
	       #
	       # assume that $Gateway is the gateway address for [IP::remote_addr]
	       #
	    set age [ROUTE::age [IP::remote_addr] $Gateway]
	    if { $age > 0 } {
		# There is a cache entry
		log local0. "Cached age is: [ROUTE::age [IP::remote_addr] $Gateway]"
	    }
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-9.0.0 --First introduced the command.  @BIGIP-12.0.0
       --Deprecated in favor of ROUTE::expiration



BIG-IP				  2017-01-31			      iRule(1)