MODIFY-VLAN-ASSIGNMENT / MDVLA: Modify VLAN assignment

You use the MODIFY-VLAN-ASSIGNMENT command to define the IP address or the IP address ranges and IPv6 addresses (with the same IPv6 prefix) for which an unambiguous assignment to a VLAN is to be made by assigning a VLAN ID. If existing assignments are to be canceled it is sufficient if you just refer to the IP address, the IP address range or the IPv6 addresses (using the same IPv6 prefix) without explicitly knowing the VLAN IDs linked to the range.

The alias name MDVLA exists for MODIFY-VLAN-ASSIGNMENT.

The MODIFY-VLAN-ASSIGNMENT command is a subfunction of VLAN support in BCAM and is used to permit unambiguous VLAN assignment for local processor from the inside. This ensures that these processors are addressed using the VLAN protocol. In the event of automatic end system creation (AEC), the command must be specified for the local processors on the node.

BS2000 console	BS2000 SDF command	Command/SOF file	SNMP management	Parameter service
x	x	x

List of valid command sources

MODIFY-VLAN-ASSIGNMENT / MDVLA

IP-ADDRESS-RANGE = *UNCHANGED / *ADD-TO-VLAN(...) / *REMOVE-FROM-VLAN(...) /
*REMOVE-ALL-FROM-VLAN
	*ADD-TO-VLAN(...)
		|		FROM = <composed-name 7 .. 15>
		|		,TO = <composed-name 7 .. 15>
		|		,VLAN-ID = <integer 2 .. 4094>
	*REMOVE-FROM-VLAN(...)
		|		FROM = <composed-name 7 .. 15>
		|		,TO = <composed-name 7 .. 15> -
IPV6-ADDRESS-RANGE = *UNCHANGED / *ADD-TO-VLAN(...) / *REMOVE-FROM-VLAN(...) /
				*REMOVE-ALL-FROM-VLAN
	*ADD-TO-VLAN(...)
		|		IPV6-PREFIX = <text 9 .. 49>
		|		,VLAN-ID = <integer 2 .. 4094>
	*REMOVE-FROM-VLAN(...)
		|		IPV6-PREFIX = <text 9 .. 49>

IP-ADDRESS-RANGE=
The assignment of an IP address range to a VLAN is defined.

IP-ADDRESS-RANGE=*UNCHANGED
The assignments of an IP address or IP address ranges to a VLAN remain unchanged.

IP-ADDRESS-RANGE=*ADD-TO-VLAN(...)
The assignment of an IP address or IP address range to a VLAN via a VLAN ID is defined for a processor. The maximum number of definable IP address ranges is defined in DCSTART/DCOPT using the MAX-VLAN-ASSIGNMENT-ENTRIES operand.
Default: 1024

FROM=<composed-name 7..15>
Lowest IP address of the IP address range that is to be specified.

TO=<composed-name 7..15>
Highest IP address of the IP address range that is to be specified.

VLAN-ID=<integer 2..4094>
VLAN ID of the VLAN for which the assignment is defined.

IP-ADDRESS-RANGE=*REMOVE-FROM-VLAN(...)
Removes an IP address or IP address range and thus the assignment to a VLAN.

FROM=<composed-name 7..15>
Lowest IP address of the IP address range that is to be specified.

TO=<composed-name 7..15>
Highest IP address of the IP address range that is to be specified.

IP-ADDRESS-RANGE=*REMOVE-ALL-FROM-VLAN
All assignments of all previously assigned IP addresses or IP address ranges for a VLAN are canceled.

IPV6-ADDRESS-RANGE=
The assignment of IPv6 addresses to a VLAN is defined.

IPV6-ADDRESS-RANGE=*UNCHANGED
The assignments of IPv6 addresses to a VLAN remain unchanged.

IPV6-ADDRESS-RANGE=*ADD-TO-VLAN(...)
The assignments of IPv6 addresses to a VLAN via a VLAN ID is defined. The maximum number of definable IPv6 prefixes is defined in DCSTART/DCOPT using the MAX-VLAN-ASSIGNMENT-ENTRIES operand in DCSTART/DCOPT.
Default: 1024

Syntax of the IPv6 prefixes: <IPv6-address>/<IPv6-prefix-length>
For further details see the section "IPv6 addresses".
Expressed in characters, the shortest definition of an IPv6 prefix is 9 bytes long. Here you must bear in mind that an IPv6 prefix is only complete when the prefix length is specified. Omitting the IPv6 prefix length results in the prefix length 0 being entered, which for a check corresponds to a prefix length of 128 bits.

IPV6-PREFIX=<text 9..49>
The assignment of IPv6 addresses with the specified IPv6 prefix is defined for a VLAN for a processor via the VLAN ID.

Examples

8765::0/8 Minimum length of prefix with one-character prefix

FE80::0/10 Link-local prefix

FC80::0/10 Site-local prefix

VLAN-ID=<interger 2..4094>
VLAN ID of the VLAN for which the assignment is set up.

IPV6-ADDRESS=*REMOVE-FROM-VLAN(...)
Removes IPv6 addresses. The assignment of IPv6 addresses with the specified IPv6 prefix for a VLAN for a processor is canceled.

IPV6-PREFIX=<text 9..49>
The assignment to a VLAN for a processor with an IPv6 address and this IPv6 prefix is canceled.

IPV6-ADDRESS-RANGE=*REMOVE-ALL-FROM-VLAN
All assignments of all previously assigned IPv6 addresses to any VLAN are canceled.

Command logging

If processing is successful the message BCA0616 appears, if it is negative the message BCA0617.
A desription of the possible error messages 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 (through SDF)
2        0	BCA0617	No modifications made by MODIFY-VLAN-ASSIGNMENT
0        1	BCA0768	Error in command (through command processing)
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active

Examples

1. Assignment to a VLAN via the VLAN ID is permitted for IP addresses within an IP address range:

   /MODIFY-VLAN-ASSIGNMENT IP-ADDRESS-RANGE=   -
/*ADD-TO-VLAN(FROM=153.10.1.10,TO=153.10.1.20,VLAN-ID=1066)

2. Assignment to a VLAN via the VLAN ID is canceled for all IPv6 addresses:

   /MODIFY-VLAN-ASSIGNMENT IPV6-ADDRESS-RANGE=*REMOVE-ALL-FROM-VLAN