CREATE-ROUTE: Create tunnel route

CREATE-ROUTE / CRRT for a tunnel route

ROUTE-NAME = <composed-name 1 .. 8>
,PROCESSOR-NAME = *ROUTE-NAME / <composed-name 1 .. 8> / <c-string 1 .. 8>
,PATH = *VIA-TUNNEL(...)
	*VIA-TUNNEL(...)
		|		TUNNEL-ROUTE-NAME = <composed-name 1..8> / <c-string 1..8>
		|		,L3-PROTOCOL = *IPV6 (...)
		|			*IPV6(...)
		|				|		L4-PROTOCOL = *TCP
		|				|		,IPV6-ADDRESS = *STD / <text 9 .. 45> / <c-string 9 .. 45>
		|				|		,OWN-IPV6-ADDRESS = *STD / <text 9 .. 49> / <c-string 9 .. 49>
		|				|		,AUTO-ROUTE-SWITCHING = *ON / *OFF
		|				|		,ROUTE-RESWITCHING = *OFF / *ON
,ATTRIBUTES = *STD / [*PARAMETERS](...)
	[*PARAMETERS](...)
		|		ROUTE-DOWN = *KEEP-CONNECTION / *DISCONNECT
		|		,ROUTE-SEQUENCE-NUM = 0 / <integer 0 .. 99>

ROUTE-NAME=<composed-name 1..8>
Name of the route that is to be generated.

PROCESSOR-NAME=...
In PROCESSOR-NAME you specify the name of the processor to which the route leads.

PROCESSOR-NAME=*ROUTE-NAME
The name of the route (ROUTE-NAME operand) is used as the processor name.

PROCESSOR-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the processor to which the route leads.

PATH=*VIA-TUNNEL(...)
You want to define a TUNNEL route.

TUNNEL-ROUTE-NAME=<composed-name 1..8> / <c-string 1..8>
In TUNNEL-ROUTE-NAME you specify the name of the associated tunnel router. The tunnel router must have the IP profile.

L3-PROTOCOL=...
In L3-PROTOCOL you specify which Layer 3 protocol is used on the route.

L3-PROTOCOL=*IPV6
The Layer 3 protocol IPv6 is used on the route.

L4-PROTOCOL=...
In L4-PROTOCOL you specify which Layer 4 protocol is used on the route.

L4-PROTOCOL=*TCP
The Layer 4 protocol TCP is used on the route.

IPV6-ADDRESS=...
In IPv6-ADDRESS you specify the partner IPv6 address of the route.

IPV6-ADDRESS=*STD
The IPv6 address assigned to the processor (PROCESSOR-NAME) is used as the IPv6 partner address of the route.

IPV6-ADDRESS=<text 9..45> / <c-string 9..45>
Partner IPv6 address of the route.

OWN-IPV6-ADDRESS=...
In OWN-IPv6-ADDRESS you specify the local IPv6 address of the route.

OWN-IPV6-ADDRESS=*STD
The route line to the tunnel (TUNNEL-ROUTE-NAME) is used as the local IPv6 partner address of the route..

OWN-IPV6-ADDRESS=<text 9..49> / <c-string 9..49>
Local IPv6 address under which the host can be addressed on this LAN. The address must be specified with the IPv6 prefix length.
Syntax: IPv6 address/IPv6 prefix length

AUTO-ROUTE-SWITCHING=...
Defines the AUTO-ROUTE-SWITCHING option.
The AUTO-ROUTE-SWITCHING option specifies whether the route’s path definitions can be changed as a result of routing protocol functions.

AUTO-ROUTE-SWITCHING=*ON
The AUTO-ROUTE-SWITCHING option is activated: the route can be modified.

AUTO-ROUTE-SWITCHING=*OFF
The AUTO-ROUTE-SWITCHING option is deactivated: the route cannot be modified.

ROUTE-RESWITCHING=...
Defines the ROUTE-RESWITCHING option.
The ROUTE-RESWITCHING option specifies whether the route can be switched back to the original path definition in the event of reactivation.

ROUTE-RESWITCHING=*OFF
The ROUTE-RESWITCHING option is deactivated.

ROUTE-RESWITCHING=*ON
The ROUTE-RESWITCHING option is activated.

ATTRIBUTES=...
ATTRIBUTES defines the route’s attributes.

ATTRIBUTES=*STD
The default attributes are defined.

ATTRIBUTES=[*PARAMETERS](...)
Specifies the route’s attributes.

ROUTE-DOWN=...
Specifies whether the allocated transport connections should be shut down if the route fails.

ROUTE-DOWN=*KEEP-CONNECTION
If the route fails, the allocated transport connections are not shut down.

ROUTE-DOWN=*DISCONNECT
If the route fails, the allocated transport connections are shut down.

ROUTE-SEQUENCE-NUM=0 / <integer 0..99>
Route number for route selection.
Determines the sequence of routes during route selection in order to distribute the transport connections (when actively set up) to routes.

Command logging

Positive acknowledgments are supplied in news BCA0676, and negative acknowledgments in news BCA06C6.
A description of the error messages that may be issued during command processing is provided in the table below.

Command return codes

(SC2)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        1	CMD0202	Error in command
0        1	BCA0768	Syntax error in command
0        1	BCA0770	Parameter invalid
0       64	BCA0773	Incorrect data type for ROUTE-NAME
0       64	BCA0775	Address to type... not defined
0       64	BCA07A0	PROCESSOR-NAME not found
0       64	BCA07A1	TUNNEL-ROUTE-NAME not found
0       64	BCA07E1	Name is already being used as ROUTE-NAME
0       64	BCA07ED	Rout is no IP route
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active