ltm rule command GENERICMESSAGE route

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



GENERICMESSAGE::route
       Adds, deletes, or looks up message routes.

SYNOPSIS
       GENERICMESSAGE::route (add | delete | lookup) ((('virtual'
       VIRTUAL_SERVER_OBJ)
								   ('config'
       TRANSPORT_CONFIG)
								   ('pool'
       POOL_OBJ)
								   ('host'
       HOST)
								   ('peer'
       PEER_NAME)
								   ('source'
       SOURCE)
								   ('src'
       SOURCE)
								   ('destination'
       DESTINATION)
								   ('dest'
       DESTINATION)
								   ('dst'
       DESTINATION) )#
								  | 'none')

DESCRIPTION
       The GENERICMESSAGE::route command allows you to add, delete, or lookup
       message routes.

       Syntax

       GENERICMESSAGE::route add [src ] [dst ] peer 
       [peer ]*

	   * Adds a route to the current routing instance that the iRule context is
	     running in. (Note both aXXsrcaXX and aXXsourceaXX are acceptable. Likewise
	     aXXdstaXX, aXXdestaXX and aXXdestinationaXX are acceptable).

       GENERICMESSAGE::route delete [src ] [dst ]

	   * Deletes a route from the current routing instance that the iRule context is
	     running in. (Note both aXXsrcaXX and aXXsourceaXX are acceptable. Likewise
	     aXXdstaXX, aXXdestaXX and aXXdestinationaXX are acceptable).

       GENERICMESSAGE::route lookup [src ] [dst ]

	   * Returns a route matching the specified source address and
	     destination address in the instance that the iRule context is
	     running in. (Note both aXXsrcaXX and aXXsourceaXX are acceptable. Likewise
	     aXXdstaXX, aXXdestaXX and aXXdestinationaXX are acceptable).

RETURN VALUE
VALID DURING
       ANY_EVENT

EXAMPLES
	when CLIENT_ACCEPTED {
	    GENERICMESSAGE::route add dst "client-[IP::remote_addr]" host "[IP::remote_addr]:[TCP::remote_port]"
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-11.5.0 --First introduced the command.



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