You use the CREATE-LINE command to create a line. If the CREATE-LINE command is executed successfully, the line has the status INCLUDED.
The alias name CRLN also exists for CREATE-LINE in order to provide SNMP support LINE-NAME=<composed-name 1..8> / <c-string 1..8>
BS2000 console | BS2000 SDF command | Command/ SOF file | SNMP management | Parameter service |
x | x | x | x |
List of valid command sources
CREATE-LINE / CRLN | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LINE-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the line to be created.
HOST-NAME=...
In HOST-NAME you specify the name of the host to which the line is to be connected.
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 to which the line is connected
IP-ADDRESS=...
In IPADR you specify the local IP address at which the host can be addressed via the line.
IP-ADDRESS=*NONE
No local IP address at which the host can be addressed via the line is defined.
IP-ADDRESS=<text 7..18> / <x-string 7..8>
Local IP address, if required with specification of the prefix length, via which the host can be addressed over the 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>.
IPV6-ADDRESS=...
In IPV6-ADDRESS you specify the local IPv6 address at which the host can be addressed via the line together with the IPv6 prefix length.
IPV6-ADDRESS=*NONE
No local IPv6 address at which the host can be addressed via the line is defined.
IPV6-ADDRESS<text 9..49> / <c-string 9..49>
In IPV6-ADDRESS you specify the local IPv6 address at which the host can be addressed via the line together with the IPv6 prefix length.
(Address syntax: <IPv6 address>/<IPv6 prefix length>)
ISO-ADDRESS=...
In ISO-ADDRESS you specify the local ISO Internet address at which the host can be addressed via the line.
ISO-ADDRESS=*NONE
No local ISO Internet address at which the host can be addressed via the line is defined.
ISO-ADDRESS=<x-string 1..40>
In ISO-ADDRESS you specify the local ISO Internet address at which the host can be addressed via the line.
L2-PROTOCOL=*CSMACD(...)
The Layer 2 protocol CSMACD is used on the line to a LAN.
NODE-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the associated LAN node.
REDUNDANT-LINE=...
You use REDUNDANT-LINE to assign the line to a group of redundant lines.
REDUNDANT-LINE=*STD
The line is to be redundant for all lines which belong to the standard group. The standard group consists of all the lines of a node which have the same profile and are defined with *STD. Specification of a subgroup has no effect for the standard group.
REDUNDANT-LINE=*NONE
The line is to be redundant for no group of lines of the assigned node. Consequently it plays no part in redundancy.
REDUNDANT-LINE=*FIRST
The line defines the “first” line of a group of redundant lines. The group name is the same as the name of this line (LINE-NAME= operand). All lines in which the name of the line is subsequently specified in REDUNDANT-LINE= are assigned to this group.
REDUNDANT-LINE=<composed-name 1..8>
The line is assigned to the group with this name. Before this is done, this group must have been configured with REDUNDANT-LINE=*FIRST.
REDUNDANT-SUBGROUP=...
A subgroup is specified to enable a preferred line switchover for lines which are explicitly defined as redundant. When a line switchover occurs, this ensures that first of all a line with the same subgroup ID is switched to. If this is not possible, an alternate line is searched for among the lines defined in the REDUNDANT-LINE entry.
REDUNDANT-SUBGROUP=*NONE
The line does not belong to a subgroup.
REDUNDANT-SUBGROUP=<text 1..1> / <c-string 1..1>
Name of the subgroup.
WRITE-DEVICE=<alphanum-name 2..2> / <x-text 4..4> / <alphanum-name 4 .. 4> / <x-text 8 .. 8>
Mnemonic device name of the write device.
READ-DEVICE=<alphanum-name 2..2> / <x-text 4..4> / <alphanum-name 4 .. 4> / <x-text 8 .. 8>
Mnemonic device name of the read device.
SLOW-POLL=...
Defines the SLOW-POLL behavior for the line.
SLOW-POLL=*STD
The general SLOW-POLL default setting (BCOPT command / MODIFY-BCAM-OPTIONS command) is used.
SLOW-POLL=*ON
Causes automatic reactivation following a line failure. This reactivation is attempted every 15 seconds until it succeeds or until a DEACTIVATE-LINE command is issued.
SLOW-POLL=*OFF
No reactivation following a line failure.
BROADCAST=...
Defines the BROADCAST option.
BROADCAST=*STD
The general BROADCAST default setting (BCOPTION command /MODIFY-BCAM-OPTIONS command) is used.
BROADCAST=*ON
The BROADCAST option is activated.
BROADCAST=*OFF
The BROADCAST option is deactivated.
MULTICAST=...
Defines the MULTICAST option.
MULTICAST=*STD
The general MULTICAST default setting (BCOPTION command /MODIFY-BCAM-OPTIONS command) is used.
MULTICAST=*ON
The MULTICAST option is activated.
MULTICAST=*OFF
The MULTICAST option is deactivated.
AUTO-ROUTE-SWITCHING=...
Defines the AUTO-ROUTE-SWITCHING option. This specifies whether IP, IPv6 and INTF routes can be switched to a replacement route (on the same LAN) in the event of a line failure.
AUTO-ROUTE-SWITCHING=*ON
The AUTO-ROUTE-SWITCHING option is activated: routes can be switched.
AUTO-ROUTE-SWITCHING=*OFF
The AUTO-ROUTE-SWITCHING option is deactivated: routes cannot be switched.
ROUTE-RESWITCHING=...
Defines the ROUTE-RESWITCHING option.
The ROUTE-RESWITCHING option specifies whether IP, IPV6 and INTF routes can be switched back to the original path definition, i.e. to this line, 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=...
MAX-LPDU-SIZE specifies the maximum data length on the line.
MAX-LPDU-SIZE=*STD
The LPDU length will be set to the Ethernet default.
MAX-LPDU-SIZE=*BY-DEVICE
The LPDU length will be set to the value read by the device.
LAN-ADDRESS=...
In LAN-ADDRESS you specify the Ethernet address at which the line is connected to the LAN.
The LAN address must be specified if you wish to operate a partner system with profile (ISO4,INT0) via this line consnection.
LAN-ADDRESS=*DYNAMIC
The Ethernet address for line connection is determined dynamically (by BCAM).
LAN-ADDRESS=<x-string 1..12>
Ethernet address of the line connection.
Command logging
Positive acknowledgments are supplied in news BCA0674, and negative acknowledgments in news BCA06C4.
A description of the error messages that may be issued during command processing is provided in the table below.
Command return codes
(SC2) | Maincode | Meaning |
| CMD0001 | Command successfully processed |
| CMD0202 | Error in command |
| BCA0768 | Syntax error in command |
| BCA0770 | Parameter <> is incorrect < > |
| BCA0601 | line <> does not have the same profile as line <> |
| BCA0602 | line <> does not have the same redundancy as line <> |
| BCA0773 | Incorrect data type for LINE-NAME |
| BCA07A3 | NODE-NAME not found |
| BCA07A4 | HOST-NAME not found |
| BCA07AE | Node is a VLAN node |
| BCA07E2 | LINE-NAME already exists |
| BCA0836 | Maximum number of possible lines reached |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |
Example
Create LAN line:
[ /CREATE-NODE NODE-NAME=LAN ]
/CREATE-LINE LINE-NAME=L#LAN#1 ,IP-ADDRESS=139.25.24.52, -
/ L2-PROTOCOL=*CSMACD(NODE-NAME=LAN,WRITE-DEVICE=Y6, -
/ READ-DEVICE=Y7)