CL Command Reference - ADDTCPRTE

CL Command List > ADDTCPRTE Reference

Description:

The Add TCP/IP Route (ADDTCPRTE) command is used to identify a route to a remote network or a route to a remote destination system in the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration.

Five parameter values uniquely define a route. These values are the route destination (RTEDEST) the subnet mask (SUBNETMASK), the type of service (TOS), the internet address of the next system on the route (NEXTHOP), and the preferred binding interface (BINDIFC).

Restrictions:

. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.

. A route cannot be added unless the internet address specified by the NEXTHOP parameter can be reached directly through a network associated with a previously defined TCP/IP interface. An interface can be added using the ADDTCPIFC command.

. A route destination value of 127.nnn.nnn.nnn (where nnn is any value from 0 to 255) is not allowed. It is a reserved value for *LOOPBACK.


Examples:

Example 1: Adding a Route

ADDTCPRTE RTEDEST(กฏ132.65.8.0กฏ) SUBNETMASK(กฏ255.255.255.0กฏ)
TOS(*MINDELAY) NEXTHOP(กฏ148.92.6.40กฏ) MTU(*IFC)

This command specifies the following for this route:
. A route destination of a class B network.
. Subnetting through the third octet.
. A minimum delay type of service for the interface.
. This route is connected to or can be reached by going through a gateway identified as 148.92.6.40.
. The maximum transmission unit (MTU) is to be calculated based on the interface associated with the next hop for this route.


Example 2: Adding a Route with a Specific MTU

ADDTCPRTE RTEDEST(กฏ9.10.45.0กฏ) SUBNETMASK(กฏ255.255.255.0กฏ)
TOS(*MAXRLB) NEXTHOP(กฏ9.5.11.128กฏ) MTU(1994)

This command specifies the following for this route:
. A route destination of a class A network.
. Subnetting through the third octet.
. A maximum reliability type of service for the interface.
. This route is connected to or can be reached by going through a gateway identified as 9.5.11.128.
. A maximum transmission unit (MTU) of 1994.


Example 3: Adding a Default Route

ADDTCPRTE RTEDEST(*DFTROUTE) SUBNETMASK(*NONE) TOS(*MINCOST)
NEXTHOP(กฏ186.49.126.108กฏ) MTU(*IFC)

ADDTCPRTE RTEDEST(*DFTROUTE) SUBNETMASK(*NONE) TOS(*NORMAL)
NEXTHOP(กฏ129.65.34.98กฏ) MTU(576)

These commands specify that:
. Two default routes are used for this host.
. Data may be routed over either default route
. Processing will use the first *DFTROUTE specified that also has the same type of service requested by the application.
. Minimum cost (*MINCOST) type of service is used for the first route and normal (*NORMAL) type of service is used for the second route.
. A maximum transmission unit (MTU) of *IFC is used for the first route and 576 for the second route.

Note: You cannot specify a subnetmask on a default route entry. It must equal *NONE.