CREATE-ROUTE: Create LAN node route

CREATE-ROUTE / CRRT for a LAN node route

ROUTE-NAME = <composed-name 1 .. 8>
,PROCESSOR-NAME = *ROUTE-NAME / <composed-name 1 .. 8> / <c-string 1 .. 8>
,PATH = *NODE(...)
	*NODE(...)
		|		NODE-NAME = <composed-name 1 .. 8> / <c-string 1 .. 8>
		|		,HOST-NAME = *STD / <composed-name 1 .. 8> / <c-string 1 .. 8>
		|		,LINE-NAME = *STD / <composed-name 1 .. 8> / <c-string 1 .. 8>
		|		,L3-PROTOCOL = *IP (...) / *IPV6(...) / *INTF(...) / *INT0(...)
		|				*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>
		|					|		,LAN-ADDRESS = *DYNAMIC / <x-string 1 .. 12>
		|					|		,AUTO-ROUTE-SWITCHING = *ON / *OFF
		|					|		,ROUTE-RESWITCHING = *OFF / *ON
		|					|		,RARP-REPLIES = * NOT-ALLOWED / *ALLOWED
		|					|		,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>
		|					|		,LAN-ADDRESS = *DYNAMIC / <x-string 1 .. 12>
		|					|		,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>
		|					|		,LAN-ADDRESS = *DYNAMIC / <x-string 1..12>
		|					|		,AUTO-ROUTE-SWITCHING = *ON / *OFF
		|					|		,ROUTE-RESWITCHING = *OFF / *ON
		|				*INT0(...)
		|					|		L4-PROTOCOL = *ISO-4
		|					|		,LAN-ADDRESS = <x-string 1..12>
		|		,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=*NODE(...)
You want to define a LAN route.

NODE-NAME=<composed-name 1..8> / <c-string 1..8>
In NODE-NAME you specify the name of the associated LAN node.

HOST-NAME=...
In HOST-NAME you specify the name of the host from which the route starts.

HOST-NAME=*STD
The name of the default host (host name from the DCSTART or DCOPT command) is used as the host name.

HOST-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the host from which the route starts.

LINE-NAME=...
In LINE-NAME you specify the name of the line via which the route operates.

LINE-NAME=*STD
The name of the only line leading to the node or – if there are multiple lines to the node – the name of the LAN node (NODE-NAME operand) is used as the line name.

LINE-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the line via which the route operates.

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.

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 IP address assigned to the line (LINE-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>.

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

LAN-ADDRESS=*DYNAMIC
The partner Ethernet address of the route is dynamically determined.

LAN-ADDRESS=<x-string 1..12>
Partner Ethernet 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.

RARP-REPLIES=...
In RARP-REPLIES you specify whether RARP is supported, i.e. whether incoming RARP requests can be responded to with the corresponding RARP replies.

RARP-REPLIES=*NOT-ALLOWED
There is no passive RARP support.

RARP-REPLIES=*ALLOWED
There is passive RARP support.

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.

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 IPv6 address assigned to the line (LINE-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

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

LAN-ADDRESS=*DYNAMIC
The partner Ethernet address of the route is dynamically determined.

LAN-ADDRESS=<x-string 1..12>
Partner Ethernet 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.

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 ISO Internet address assigned to the line (LINE-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.

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

LAN-ADDRESS=*DYNAMIC
The partner Ethernet address of the route is dynamically determined.

LAN-ADDRESS=<x-string 1..12>
Partner Ethernet 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.

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

LAN-ADDRESS=<x-string 1..12>
In LAN-ADDRESS you specify the partner Ethernet address of the route.

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 type... undefined
0       64	BCA07A0	PROCESSOR-NAME not found
0       64	BCA07A2	LINE-NAME not found
0       64	BCA07A3	NODE-NAME not found
0       64	BCA07A4	HOST-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