CREATE-ROUTE: Create ROUTER route

CREATE-ROUTE / CRRT for a router route

ROUTE-NAME = <composed-name 1 .. 8>
,PROCESSOR-NAME = *ROUTE-NAME / <composed-name 1 .. 8> / <c-string 1 .. 8>
,PATH = *VIA-ROUTER(...)
	*VIA-ROUTER(...)
		|		ROUTER-ROUTE-NAME = <composed-name 1 .. 8> / <c-string 1 .. 8>
		|		,L3-PROTOCOL = *IP (...) / *IPV6(...) / *INTF(...)
		|			*IP (...)
		|				|		L4-PROTOCOL = *TCP
		|				|		,L3-SUBPROTOCOL = *NONE / *SNAP
		|				|		,IP-ADDRESS = *STD / <text 7 .. 15> / <x-string 7 .. 8>
		|				|		,OWN-IP-ADDRESS = *STD / <text 7 .. 18> / <x-string 7 .. 8>
		|				|		,AUTO-ROUTE-SWITCHING = *ON / *OFF
		|				|		,ROUTE-RESWITCHING = *OFF / *ON
		|				|		,TRANSON-USAGE = *OFF / *ON
		|			*IPV6(...)
		|				|		L4-PROTOCOL = *TCP
		|				|		,L3-SUBPROTOCOL = *NONE / *SNAP
		|				|		,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
		|			*INTF(...)
		|				|		L4-PROTOCOL = *ISO-4
		|				|		,ISO-ADDRESS = *STD / <x-string 1..40>
		|				|		,OWN-ISO-ADDRESS = *STD / <x-string 1..40>
		|				|		,AUTO-ROUTE-SWITCHING = *ON / *OFF
		|				|		,ROUTE-RESWITCHING = *OFF / *ON
		|		,MAX-LPDU-SIZE = *STD / *ETHERNET-STD
,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-ROUTER(...)
You want to define a ROUTER route.

ROUTER-ROUTE-NAME=<composed-name 1..8> / <c-string 1..8>
In ROUTER-ROUTE-NAME you specify the name of the route to the associated router.

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

L3-PROTOCOL=*IP
The Layer 3 protocol IP 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.

L3-SUBPROTOCOL=...
In L3-SUBPROTOCOL you specify which Layer 3 subprotocol is used on the route.
This operand is only valid for routes which pass via a router which is accessed via a LAN node.

L3-SUBPROTOCOL=*NONE
No Layer 3 subprotocol is used on the route.

L3-SUBPROTOCOL=*SNAP
The Layer 3 subprotocol SNAP is used on the route.

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

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

IP-ADDRESS=<text 7..15> / <x-string 7..8>
Partner IP address of the route.

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

OWN-IP-ADDRESS=*STD
The local IP address of the route to the router (ROUTER-ROUTE-NAME) is used as the local IP address of the route. 

OWN-IP-ADDRESS=<text 7..18> / <x-string 7..8>
Local IP address of the route, if required with specification of the prefix length, via which the host can be addressed over a line. If the prefix length is not specified, the default prefix length which matches the IPv4 address is determined.
Address syntax:
<IPv4-address>/<IPv4-prefix-length> or <IPv4-address>.

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.

TRANSON-USAGE=...
You use TRANSON-USAGE to specify whether the route is used to access a TranSON server.

TRANSON-USAGE=*OFF
The route is not used to access a TranSON server.

TRANSON-USAGE=*ON
The route is used to access a TranSON server.

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.

L3-SUBPROTOCOL=...
In L3-SUBPROTOCOL you specify which Layer 3 subprotocol is used on the route.
This operand is only valid for routes which pass via a router which is accessed via a LAN node.

L3-SUBPROTOCOL=*NONE
No Layer 3 subprotocol is used on the route.

L3-SUBPROTOCOL=*SNAP
The Layer 3 subprotocol SNAP 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 local IPv6 address of the route to the router (ROUTER-ROUTE-NAME) is used as the local IPv6 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.

L3-PROTOCOL=*INTF
The Layer 3 protocol ISO8473 Full Internet is used on the route.

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

L4-PROTOCOL=*ISO-4
The Layer 4 protocol ISO8073 Class 4 is used on the route.

ISO-ADDRESS=...
In ISO-ADDRESS you specify the partner ISO Internet address of the route.

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

ISO-ADDRESS=<x-string 1..40>
Partner ISO Internet address of the route.

OWN-ISO-ADDRESS=...
In OWN-ISO-ADDRESS you specify the local ISO Internet address of the route.

OWN-ISO-ADDRESS=*STD
The local ISO Internet address of the route to the router (ROUTER-ROUTE-NAME) is used as the local ISO Internet address of the route.

OWN-ISO-ADDRESS=<x-string 1..40>
Local ISO Internet address of the route.

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.

MAX-LPDU-SIZE=...
In MAX-LPDU-SIZE you specify the maximum data length that can be used on the associated line for the route.

MAX-LPDU-SIZE=*STD
The default length of the associated line is used.

MAX-LPDU-SIZE=*ETHERNET-STD
The default length of an Ethernet LAN is used.

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 of this type not defined
0       64	BCA07A0	PROCESSOR-NAME not found
0       64	BCA07A1	ROUTER-ROUTE-NAME not found
0       64	BCA07E1	Name is already being used as ROUTE-NAME
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active