You use the MODIFY-LINE command for the dynamic modification of line-specific options and/or attributes.
The alias name MDLN exists for MODIFY-LINE in order to provide SNMP support.
BS2000 console | BS2000 SDF command | Command/SOF file | SNMP management | Parameter service |
x | x | x | x |
List of valid command sources
MODIFY-LINE / MDLN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LINE-NAME=<composed-name 1..8> / <c-string 1..8>
Previous name of the line that is to be modified.
NEW-LINE-NAME=...
New name of the line.
The line-name can only be changed if the line is deactivated.
NEW-LINE-NAME=*SAME
The name of the line is unchanged.
NEW-LINE-NAME=<composed-name 1..8>
New name of the line.
WRITE-DEVICE=...
Changes the device definition for the line’s write device.
The device definition can only be changed if the line is deactivated.
WRITE-DEVICE=*UNCHANGED
The device definition for the line’s write device is unchanged.
WRITE-DEVICE=<alphanum-name 2..2> / <x-text 4..4> / <alphanum-name 4..4> / <x-text 8..8>
Mnemonic device name for the line’s write device.
READ-DEVICE=...
Changes the device definition for the line’s read device.
The device definition can only be changed if the line is deactivated.
READ-DEVICE=*UNCHANGED
The device definition for the line’s read device is unchanged.
READ-DEVICE=<alphanum-name 2..2> / <x-text 4..4> / <alphanum-name 4..4> / <x-text 8..8>
Mnemonic device name for the line’s read device.
SLOW-POLL=...
Changes the SLOW-POLL option.
This option cannot be changed unless a LAN protocol (CSMACD) is used on the line.
SLOW-POLL=*UNCHANGED
The setting of the SLOW-POLL option is unchanged.
SLOW-POLL=*ON
The SLOW-POLL option is activated.
SLOW-POLL=*OFF
The SLOW-POLL option is deactivated.
BROADCAST=...
Changes the BROADCAST option.
This option cannot be changed unless a LAN protocol (CSMACD) is used on the line.
BROADCAST=*UNCHANGED
The setting of the BROADCAST option is unchanged.
BROADCAST=*ON
The BROADCAST option is activated.
BROADCAST=*OFF
The BROADCAST option is deactivated.
MULTICAST=...
Changes the MULTICAST option.
This option cannot be changed unless a LAN protocol (CSMACD) is used on the line.
MULTICAST=*UNCHANGED
The setting of the MULTICAST option is unchanged.
MULTICAST=*ON
The MULTICAST option is activated.
MULTICAST=*OFF
The MULTICAST option is deactivated.
AUTO-ROUTE-SWITCHING=...
Changes the AUTO-ROUTE-SWITCHING option.
This option cannot be changed unless a LAN protocol (CSMACD) is used on the line.
AUTO-ROUTE-SWITCHING=*UNCHANGED
The setting of the AUTO-ROUTE-SWITCHING option is unchanged
AUTO-ROUTE-SWITCHING=*ON
The AUTO-ROUTE-SWITCHING option is activated.
AUTO-ROUTE-SWITCHING=*OFF
The AUTO-ROUTE-SWITCHING option is deactivated.
ROUTE-RESWITCHING=...
Changes the ROUTE-RESWITCHING option.
This option cannot be changed unless a LAN protocol (CSMACD) is used on the line.
ROUTE-RESWITCHING=*UNCHANGED
The setting of the ROUTE-RESWITCHING option remains unchanged.
ROUTE-RESWITCHING=*ON
The ROUTE-RESWITCHING option is activated.
ROUTE-RESWITCHING=*OFF
The ROUTE-RESWITCHING option is deactivated.
IPV6-AUTO-CONFIG=...
Changes the IPV6-AUTO-CONFIG option.
This option cannot be changed unless a LAN protocol (CSMACD) is used on the line.
IPV6-AUTO-CONFIG=*UNCHANGED
The setting of the IPV6-AUTO-CONFIG option remains unchanged.
IPV6-AUTO-CONFIG=*ON
The IPV6-AUTO-CONFIG is activated.
IPV6-AUTO-CONFIG=*OFF
The IPV6-AUTO-CONFIG is deactivated.
DUP-ADDR-DETECTION=...
This parameter is used to set Duplicate Address Detection on a line-specific basis.Comment:
If this line is in a redundant relationship with other lines, the settings for Duplicate Address Detection for IPv6 are also adjusted accordingly for these lines.
DUP-ADDR-DETECTION= * UNCHANGED
The previous setting remains unchanged.
Default: Duplicate Address Detection is performed, and the Transmit number is 3.
DUP-ADDR-DETECTION=*ON(...)
Duplicate Address Detection is performed.
TRANSMIT-NUMBER=<integer 1..10>
The number of Transmits is set.
TRANSMIT-NUMBER=*STD
The number of Transmits is set to the default value 3.
DUP-ADDR-DETECTION=*OFF
Duplicate Address Detection is not performed.
DUP-ADDR-DETECTION=*STD
Duplicate Address Detection is performed using the default setting.
ADDR-CONFLICT-DETECT=...
This parameter is used to set IP Address Conflict Detection on a line-specific basis.
If this line is in a redundant relationship with other lines, the settings for Duplicate Address Detection for IP are also adjusted accordingly for these lines.
ADDR-CONFLICT-DETECT= * UNCHANGED
The current setting is not changed.
Default: IP Address Conflict Detection is performed and the transmit number is 1.
ADDR-CONFLICT-DETECT=*ON(...)
IP Address Conflict Detection is performed.
TRANSMIT-NUMBER=<integer 1..10>
The number of transmits is set.
TRANSMIT-NUMBER=*STD
The number of transmits is set to the default value 1.
ADDR-CONFLICT-DETECT=*OFF
IP Address Conflict Detection is not performed.
ADDR-CONFLICT-DETECT=*STD
IP Address Conflict Detection is performed with the default setting.
CHECKSUM=...
The setting for calculating the CHECKSUM option is changed.
A prerequisite is that the device supports the TCP/IP checksum calculation.
CHECKSUM=*UNCHANGED
The setting for the CHECKSUM option remains unchanged.
CHECKSUM=*BY-BCAM
The CHECKSUM calculation is performed in BCAM.
CHECKSUM=*BY-DEVICE
The CHECKSUM calculation is performed in the device.
TIMEOUT-PROCESSING=...
Specifies whether a line is maintained or deactivated following a timeout on this line when line supervision is active (LINE-SUPERVISION in the BCOPTION/ MODIFY-BCAM-OPTIONS command).
You cannot change this option unless a LAN protocol (CSMACD) is running on the line.
TIMEOUT-PROCESSING=*UNCHANGED
The setting of the TIMEOUT-PROCESSING option remains unchanged.
Default: *KEEP-LINE
TIMEOUT-PROCESSING=*KEEP-LINE
The line is maintained on a timeout if line supervision is set.
TIMEOUT-PROCESSING=*DEACTIVATE-LINE
The line is deactivated on a timeout if line supervision is set.
MAX-LPDU-SIZE=...
Changes the MAX-LPDU-SIZE attribute.
Modifying the MAX-LPDU-SIZE attribute prerequisites that you use the L2 profile ETHERNET on the line.
The device definition can only be changed if the line is deactivated.
MAX-LPDU-SIZE=*UNCHANGED
The MAX-LPDU-SIZE attribute is unchanged.
MAX-LPDU-SIZE=*ETHERNET-STD
The LPDU length is changed to the ETHERNET value (1514 bytes).
MAX-LPDU-SIZE=*BY-DEVICE
The LPDU length is changed to the value read by the device.
MAX-LPDU-SIZE=*STD
The LPDU length is changed to the default value for the defined LAN line.
MAX-LPDU-SIZE=<integer 1514..65535>
The LPDU length is changed to the specified value (in bytes).
Command logging
Positive acknowledgments are supplied in news BCA0663, and negative acknowledgments in news BCA06B3 followed by the message NBR0740. If processing is positive then the messages BCA07D0, BCA07D1, BCA07D6 and BCA07D7 may also appear.
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 |
| BCA06B4 | MODIFY-LINE command cancelled |
| BCA07D5 | Line not deactivated |
| BCA07A2 | LINE-NAME not found |
| BCA07D5 | Line not deactivated |
| BCA07D9 | Invalid BS2000 version |
| BCA07E2 | NEW-LINE-NAME already exists |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |
Examples
Change line option
/MODIFY-LINE LINE-NAME=LAN1#6,SLOW-POLL=*ONChange device definition for a line
/MODIFY-LINE LINE-NAME=LAN1#6,WRITE-DEVICE=W6,READ-DEVICE=R6