openNet Server V21.0B (en)

&pagelevel(3)&pagelevel

You use the MODIFY-ADDRESS-ASSIGNMENT command to administer the networks or subnetworks behind the routers. Your specifications are host-specific or own-addressspecific: you must make the appropriate route definitions and network assignments for each host.

The alias name MDADA exists for the MODIFY-ADDRESS-ASSIGNMENT command in order to provide SNMP support. The SDF alias name is MDADA.

The MODIFY-ADDRESS-ASSIGNMENT command is a subfunction of the MODIFY-ROUTE command.

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

List of valid command sources

MODIFY-ADDRESS-ASSIGNMENT / MDADA

ROUTE-NAME = <composed-name 1 .. 8>(...) / <c-string 1 .. 8>(...) / IP(...) / ISO(...) / *IPV6(...)
	<composed-name 1 .. 8>(...) / <c-string 1 .. 8>(...)
		\|	REMOVE-IP-NET = NONE / UNKNOWN / *IP-RANGE(...) / <composed-name 7 .. 15> /
		\|				<x-string 7 .. 8>
		\|		*IP-RANGE(...)
		\|			\|	FROM = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|			\|	,TO = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|	,ADD-IP-NET = NONE / UNKNOWN / *IP-RANGE(...) / <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|		*IP-RANGE(...)
		\|			\|	FROM = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|			\|	,TO = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|	,REMOVE-IPV6-NET = NONE / UNKNOWN / <text 9 .. 49>/ <c-string 9 .. 49>
		\|	,ADD-IPV6-NET = NONE / UNKNOWN / <text 9 .. 49> / <c-string 9 .. 49>
		\|	,REMOVE-ISO-NET = NONE / UNKNOWN / <x-string 1 .. 40>
		\|	,ADD-ISO-NET = NONE / UNKNOWN / <x-string 1 .. 40>
	*IP(...)
		\|	IP-ADDRESS = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|	,REMOVE-IP-NET = NONE / UNKNOWN / *IP-RANGE(...) / <composed-name 7 .. 15> /
		\|				<x-string 7 .. 8>
		\|		*IP-RANGE(...)
		\|			\|	FROM = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|			\|	,TO = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|	,ADD-IP-NET = NONE / UNKNOWN / *IP-RANGE(...) / <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|		*IP-RANGE(...)
		\|			\|	FROM = <composed-name 7 .. 15> / <x-string 7 .. 8>
		\|			\|	,TO = <composed-name 7 .. 15> / <x-string 7 .. 8>
	*IPV6(...)
		\|	IPV6-ADDRESS = <text 9 .. 45> / <c-string 9 .. 45>
		\|	,REMOVE-IPV6-NET = NONE / UNKNOWN / <text 9 .. 49> / <c-string 9 .. 49>
		\|	,ADD-IPV6-NET = NONE / UNKNOWN / <text 9 .. 49> / <c-string 9 .. 49>
	*ISO(...)
		\|	ISO-ADDRESS = <x-string 1 .. 40>
		\|	,REMOVE-ISO-NET = NONE / UNKNOWN / <x-string 1 .. 40>
		\|	,ADD-ISO-NET = NONE / UNKNOWN / <x-string 1 .. 40>

The first REMOVE operation specified in the command is executed before the following ADD operation.
For example, the operation ADD-IP-NET=*UNKNOWN identifies an IP router via which all the IP addresses are included that have not yet been rendered accessible by means of address ranges or individual addresses. This is an implicitly generated residual subset of the full range of possible addresses minus any definitions that have already been made.

The gateway tables for IPv4 and IPv6 are arranged on a host- and own-addressspecific basis. The SHOW-ADDRESS-ASSIGNMENT command also outputs them in this order.
A route - in particular the route of a router - is determined by the address pair (ownip-address, ip-address) and its implicit assignment of the local address to a host.Consequently one default router can be specified for each own-ip-address or ownipv6-address.

ROUTE-NAME=
Route whose address assignment is to be changed.

ROUTE-NAME=<composed-name 1..8>(...) / <c-string 1..8>(...)
Name of the route whose address assignment is to be changed.

REMOVE-IP-NET=
In REMOVE-IP-NET you specify which IP address or IP address range can no longer be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IP.

REMOVE-IP-NET=*NONE
The definition of the IP addresses that can be accessed via this route is not changed.

REMOVE-IP-NET=*UNKNOWN
No non-generated IP addresses can be accessed via this route.

REMOVE-IP-NET=<composed-name 7..15> / <x-string 7..8>
Specifies which IP addresses can no longer be accessed via this route.

REMOVE-IP-NET=*IP-RANGE(...)
Range of IP addresses that can no longer be accessed via this route.

FROM=<composed-name 7..15> / <x-string 7..8>
Lowest IP address of the range accessed via this route.

TO=<composed-name 7..15> / <x-string 7..8>
Highest IP address of the range accessed via this route.

ADD-IP-NET=
In ADD-IP-NET you specify which further IP address or which IP address range can be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN susing the Layer 3 protocol IP.

ADD-IP-NET=*NONE
The definition of the IP addresses that can be accessed via this route is not changed.

ADD-IP-NET=*UNKNOWN
All non-generated IP addresses can be accessed via this route.

ADD-IP-NET=<composed-name 7..15> / <x-string 7..8>
Specifies the IP address that can be accessed via this route. If this IP address is already assigned to another route then the command is not executed.

ADD-IP-NET=*IP-RANGE(...)
Range of IP addresses that are accessed via this route.

FROM=<composed-name 7..15> / <x-string 7..8>
Lowest IP address of the range accessed via this route.

TO=<composed-name 7..15> / <x-string 7..8>
Highest IP address of the range accessed via this route.

REMOVE-IPV6-NET=...
Uses the IPv6 prefix/length to specify which IPv6 addresses can no longer be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IPv6.

REMOVE-IPV6-NET=*NONE
The setting specifying which IPv6 addresses can be accessed via this route remains unchanged.

REMOVE-IPV6-NET=*UNKNOWN
No non-generated IPv6 addresses can be accessed via this route.

REMOVE-IPV6-NET=<text 9..49> / <c-string 9..49>
Specifies which IPv6 addresses can no longer be accessed via this route.

ADD-IPV6-NET=...
Uses the IPv6 prefix/length to specify which IPv6 addresses can be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IPv6.

ADD-IPV6-NET=*NONE
The setting specifying which IPv6 addresses can be accessed via this route remains unchanged.

ADD-IPV6-NET=*UNKNOWN
All non-generated IPv6 addresses can be accessed via this route.

ADD-IPV6-NET=<text 9..49> / <c-string 9..49>
Specifies which IPv6 addresses can be accessed via this route.
If another route is already assigned to these IPv6 addresses then the command is not executed.

REMOVE-ISO-NET=...
Specifies which ISO Internet addresses can no longer be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol INTF.

REMOVE-ISO-NET=*NONE
The setting specifying which ISO Internet addresses can be accessed via this route remains unchanged.

REMOVE-ISO-NET=*UNKNOWN
No non-generated ISO Internet addresses can be accessed via this route.

REMOVE-ISO-NET=<x-string 1..40>
Specifies which ISO Internet addresses can no longer be accessed via this route.

ADD-ISO-NET=...
Specifies which ISO Internet addresses can be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol INTF.

ADD-ISO-NET=*NONE
The setting specifying which ISO Internet addresses can be accessed via this route remains unchanged.

ADD-ISO-NET=*UNKNOWN
All non-generated ISO Internet addresses can be accessed via this route

ADD-ISO-NET=<x-string 1..40>
Specifies which ISO Internet addresses can be accessed via this route.
If another route is already assigned to these ISO Internet addresses then the command is not executed.

ROUTE-NAME=*IP(...)
IP address of the route whose address assignment is modified.

IP-ADDRESS=<composed-name 7..15> / <x-string 7..8>
IP address of the route whose address assignment is modified.

REMOVE-IP-NET=...
In REMOVE-IP-NET you specify the IP address or IP address range that can no longer be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IP.

REMOVE-IP-NET=*NONE
The setting specifying which IP addresses can be accessed via this route remains unchanged.

REMOVE-IP-NET=*UNKNOWN
No non-generated IP addresses can be accessed via this route.

REMOVE-IP-NET=<composed-name 7..15> / <x-string 7..8>
Specifies which IP addresses can no longer be accessed via this route.

REMOVE-IP-NET=*IP-RANGE(...)
Range of IP addresses that can no longer be accessed via this route.

FROM=<composed-name 7..15> / <x-string 7..8>
Lowest IP address of the range to be accessed via this route.

TO=<composed-name 7..15> / <x-string 7..8>
Highest IP address of the range to be accessed via this route.

ADD-IP-NET=...
In ADD-IP-NET you specify which further IP address or which IP address range can be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IP.

ADD-IP-NET=*NONE
The setting specifying which IP addresses can be accessed via this route remains unchanged.

ADD-IP-NET=*UNKNOWN
All non-generated IP addresses can be accessed via this route.

ADD-IP-NET=<composed-name 7..15> / <x-string 7..8>
Specifies which IP address can be accessed via this route. If another route is already assigned to this IP address then the command is not executed.

ADD-IP-NET=*IP-RANGE(...)
Range of IP addresses that can be accessed via this route.

FROM=<composed-name 7..15> / <x-string 7..8>
Lowest IP address of the range to be accessed via this route.

TO= <composed-name 7..15> / <x-string 7..8>
Highest IP address of the range to be accessed via this route.

ROUTE-NAME=*IPV6(...)
IPv6 address of the route whose address assignment is modified.

IPV6-ADDRESS=<text 9..45> / <c-string 9..45>
IPv6 address of the route whose address assignment is modified.

REMOVE-IPV6-NET=...
Uses the IPv6 prefix/length to specify which IPv6 addresses can no longer be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IPv6

REMOVE-IPV6-NET=*NONE
The setting specifying which IPv6 addresses can be accessed via this route remains unchanged.

REMOVE-IPV6-NET=*UNKNOWN
No non-generated IPv6 addresses can be accessed via this route.

REMOVE-IPV6-NET=<text 9..49> / <c-string 9..49>
Specifies the IPv6 addresses that can no longer be accessed via this route.

ADD-IPV6-NET=...
Uses the IPv6 prefix/length to specify which IPv6 addresses can be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol IPv6.

ADD-IPV6-NET=*NONE
The setting specifying which IPv6 addresses can be accessed via this route remains unchanged.

ADD-IPV6-NET=*UNKNOWN
All non-generated IPv6 addresses can be accessed via this route.

ADD-IPV6-NET=<text 9..49> / <c-string 9..49>
Specifies which IPv6 addresses can be accessed via this route. If another route is already assigned to these IPv6 addresses then the command is not executed.

ROUTE-NAME=*ISO(...)
ISO Internet address of the route whose address assignment is modified.

ISO-ADDRESS=<x-string 1..40>
ISO Internet address of the route whose address assignment is modified.

REMOVE-ISO-NET=...
Specifies the ISO Internet address that can no longer be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol INTF.

REMOVE-ISO-NET=*NONE
The setting specifying which ISO Internet addresses can be accessed via this route remains unchanged.

REMOVE-ISO-NET=*UNKNOWN
All non-generated ISO Internet addresses can no longer be accessed via this route.

REMOVE-ISO-NET=<x-string 1..40>
Specifies which ISO Internet addresses can no longer be accessed via this route.

ADD-ISO-NET=...
Specifies which ISO Internet addresses can be accessed via this route.

This parameter can only be specified for routers that can be accessed locally via LAN using the Layer 3 protocol INTF.

ADD-ISO-NET=*NONE
The setting specifying which ISO Internet addresses can be accessed via this route remains unchanged.

ADD-ISO-NET=*UNKNOWN
All non-generated ISO Internet addresses can be accessed via this route.

ADD-ISO-NET=<x-string 1..40>
Specifies which ISO Internet addresses can be accessed via this route.
If another route is already assigned to these ISO Internet addresses then the command is not executed.

Command logging

Positive acknowledgments are supplied in news BCA0667, and negative acknowledgments in news BCA06B7 followed by the message NBR0740. If processing is positive then message BCA07B0 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) SC1	Maincode	Meaning
0 0	CMD0001	Command successfully processed
0 1	CMD0202	Error in command
2 0	BCA06B7	MODIFY-ADDRESS-ASSIGNMENT cancelled
2 0	BCA07B1	Route is no longer used as router
2 0	BCA07B4	Route is no longer used as IP router
2 0	BCA07B6	Route is no longer used as IPv6 router
2 0	BCA07C0	No route modified
0 1	BCA0768	Syntax error in command
0 1	BCA0770	Parameter incorrect
0 64	BCA07A1	Route unknown
0 64	BCA07EE	Command is being executed
0 64	BCA079F	Address unknown
0 128	BCA0814	BCAM is being terminated abnormally
0 128	BCA0816	BCAM is terminating
0 130	BCA0766	BCAM is not active

Principle of default router and address range definition

The IP addresses follow a natural sequence. They can be represented as discrete points – the natural numbers – over a restricted interval [2E+31]. Because of RFC-related limitations, not all the discrete points within the interval are permitted.

The following example demonstrates the functioning of the command:

No routes have so far been defined (basic state).

a1, a2, a3,...	IP addresses
ROUTER	Router
DFTRTROi	Default router to own-address-i, i=1,2

Example of the functioning of MODIFY-ADDRESS-ASSIGNMENT

Examples

Router definition for a default router to own-address-i with the name DFTRTOi, i=1,2:
/MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME=DFTRTRO1(ADD-IP-NET=*UNKNOWN) /MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME=DFTRTRO2(ADD-IP-NET=*UNKNOWN)
Comments:
The definition of the default router is specified last and covers the intervals which have not yet been recorded.
DFTRTR01 and DFTRTR02 are default routers for different addresses (see above). You cannot define two routes which have the same own IP address as the default router for *UNKNOWN. In this case the second definition would reset the first definition.
Router definition for the router with the name ROUTER for an undefined IP network 189.44.0.0
/MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME=ROUTER(ADD-IP-NET=189.44.0.0)
or
/MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME=ROUTER(ADD-IP-NET=x’BD2C0000’)
Withdrawal of router definition for a default-Router with the name DFRTRO1:
/MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME=DFTRTRO1(REM-IP-NET=*UNKNOWN)
Router definition for the IP address range intervals (173.15.10.1,173.15.10.20) (173.15.10.40,173.15.10.100) and subsequent deletion of the intervals
/MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME= - / ROUTER(ADD-IP-NET=*RANGE(FROM=173.15.10.1,TO=173.15.10.100)) /MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME= - / ROUTER(REMOVE-IP-NET=*RANGE(FROM=173.15.10.21,TO=173.15.10.39)) /MODIFY-ADDRESS-ASSIGNMENT ROUTE-NAME= - / ROUTER(REMOVE-IP-NET=*RANGE(FROM=173.15.10.1,TO=173.15.10.100))

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

MODIFY-ADDRESS-ASSIGNMENT / MDADA: Modify address assignment

Command logging

Command return codes

Principle of default router and address range definition