You use the MODIFY-ROUTE command for the dynamic modification of the route-specific options. In addition, targeted route switching can be carried out with MODIFY-ROUTE. You can also perform route definitions for the automatic end system creation. The respective router definitions are host-specific in accordance with the route definition: the corresponding route definitions and network assignments must be made for each host.
In order to support SNMP management, MODIFY-ROUTE has the alias MDROUTE.
The values that can be set with MODIFY-ROUTE are partly protocol timers. The setting of these protocol timers must be uniform throughout the network and requires a sound knowledge of the relevant standards and networks.
BS2000 console | BS2000 SDF command | Command/SOF file | SNMP management | Parameter service |
x | x | x |
List of valid command sources
MODIFY-ROUTE / MDROUTE Changing route characteristics | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The ADD and REMOVE operations cannot be specified in one command simultaneously.
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.
ROUTES=...
Routes to be changed.
ROUTES=*ALL
All routes are changed. The actual number of routes changed is logged in the message BCA07C1.
TIMER=...
Timers that are changed.
TIMER=*UNCHANGED
The values for the timers remain unchanged.
TIMER=PERIODS(...)
Timer time intervals are changed.
WINDOW=...
The time interval of the window timer is changed.
If nothing was sent on a connection during the time interval, an acknowledgment element (AK-TPDU) is sent.
The value is rounded up to a multiple of 2 seconds. The timer has a precision of 2 seconds. Values which are greater than 180 are changed to 180.
If the value for WINDOW is changed, the maximum for the RETRANSMISSION value (one fifth of the WINDOW value) is also changed.
WINDOW=*UNCHANGED
The time interval of the window timer remains unchanged.
WINDOW=*STD
The time interval of the window timer is changed to the default value (60 seconds).
WINDOW=<integer 2..180>
The time interval of the window timer is changed to the specified value (in seconds).
RETRANSMISSION=...
The time interval of the retransmission timer is changed.
A protocol element which must be acknowledged is retransmitted if it was not acknowledged by the partner transport control during the time interval.
The value is rounded up to a multiple of 2 seconds. The timer has a precision of 2 seconds.
The retransmission timer is only to be changed where absolutely essential.The timer has major effects on the loading of the system and the LAN. It should be noted that changes to WINDOW values also affect RETRANSMISSION.
For WINDOW=*STD, the RETRANSMISSION value is 10.
RETRANSMISSION=*UNCHANGED
The time interval of the retransmission timer remains unchanged.
RETRANSMISSION=*STD
The time interval of the retransmission timer is changed to the default value (10 seconds).
RETRANSMISSION=<integer 2..36>
The time interval of the retransmission timer is changed to the specified value (in seconds).
OPTIONS=...
Options to be changed.
OPTIONS=*UNCHANGED
No options are changed.
OPTIONS=ROUTING(...)
Routing options are changed.
ARP=...
Specifies if, and how, ARP is used.
The basic preferences are set under BCOPTION / MODIFY-BCAM-OPTIONS.
ARP=*UNCHANGED
The use of ARP is not changed.
ARP=QUIET
ARP is used every 2 seconds when a route is used for the first time. Every 300 seconds, there is a check – set via BCTIMES – to determine whether data transmission has taken place within the elapsed time interval. If this is not the case, and if communication associations exist over the route, an ARP request is sent.
ARP=ON
ARP is to be used during route activation (every 2 seconds), and ARP requests – set via BCTIMES – are to be sent periodically (every 300 seconds).
ARP=OFF
ARP is not used.
RARP=...
Specifies whether RARP is used passively.
RARP=*UNCHANGED
The passive use of RARP is not changed.
RARP=ON
RARP is used passively.
RARP=OFF
RARP is not used passively.
NSDU-LENGTH-MAXIMUM=...
Changes the maximum NSDU length.
For changes to the NSDU length, the route must be in the “EXCLUDED” status.
To do this you may need to use BCOUT to shut the route down.
NSDU-LENGTH-MAXIMUM=*UNCHANGED
The maximum NSDU length is not changed.
NSDU-LENGTH-MAXIMUM=<integer 512..65530>
The maximum NSDU length is changed to the specified value (in bytes)
AUTO-ROUTE-SWITCHING=...
This operand sets the option "Routing change due to routing protocols for IP".
AUTO-ROUTE-SWITCHING=*UNCHANGED
The previous setting is retained.
AUTO-ROUTE-SWITCHING=*ON
Routing changes due to routing protocols for IP are performed.
AUTO-ROUTE-SWITCHING=*OFF
No routing changes due to routing protocols for IP are performed.AUTO-ROUTE-SWITCHING prevents an IP route switched using MODIFY-ROUTE from being switched to a router other than the one specified by the IP routing protocol functions. The same functionality is provided by BCOPTION / MODIFY-BCAM-OPTIONS AUTO-ROUTE-SWITCHING=OFF. However, in this case the setting applies to all the IP routes.
CHECKSUM=...
Specifies whether or not checksum verification is performed for the route when a segment is received. The checksum for the segments for transmission is always calculated and entered in the protocol. This option can be used to improve reception performances.
This specification only applies to routes with the transport profile TCP.
This option should only be used on routes on which there is no risk of data corruption.
The machine-internal connection between BS2000 guest machines on a VM2000 system, for example, is suitable for this.
CHECKSUM=*UNCHANGED
The previous setting is unchanged.
CHECKSUM=*ON
Checksum verification is performed.
CHECKSUM=*OFF
Checksum verification is not performed.
ROUTES=NAME(...)
Routes defined by their names are changed. Modification of each individual route is logged with the message BCA07C2. If several routes lead to the specified processor, the number of routes changed is logged with the message BCA07C1. In this case only the operands TIMER and OPTIONS are permitted.
ROUTE-NAME=<rout-name 1..8>
Name of the route for modification.
PROCESSOR-NAME=<processor-name 1..8>
Name of the processor whose routes are changed.
ROUTES=ADDRESS(...)
Routes defined by their addresses are changed. Modification of each individual route is logged with the message BCA07C2. If several routes lead to the specified processor, the number of routes changed is logged with the message BCA07C1. In this case only the operands TIMER and OPTIONS are permitted.
IP-ADDRESS=
Specifies the IP address of the route or the IP address range of the routes for modification.
IP-ADDRESS=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
IP address of the route for modification
IP-ADDRESS=*RANGE(...)
IP address range of the routes for modification. Specification of *RANGE is only useful in conjunction with PATH since it serves to switch the IP address range defined with *RANGE to the router specified with PATH.
FROM=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Lowest IP address of the range to be changed.
TO=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Highest IP address of the range to be changed.
LAN-ADDRESS=<x-string 1..12>
LAN address of the INT0 route for modification
ISO-ADDRESS=<x-string 1..40>
ISO Internet address of the route for modification
I6-ADDRESS=<c-string 1..45>
IPv6 of the route for modification.
TIMER=...
Timers changed for the route named using ROUTE-NAME or IP-ADDRESS.
TIMER=*UNCHANGED
The value for the timers remain unchanged.
TIMER=*PERIODS(...)
Timer time intervals are changed.
WINDOW=...
The time interval of the window timer is changed.
If nothing was sent on a connection during the time interval, an acknowledgment element (AK-TPDU) is sent.
The value is rounded up to a multiple of 2 seconds. The timer has a precision of 2 seconds. Values which are greater than 180 are changed to 180.
If the value for WINDOW is changed, the maximum for the RETRANSMISSION value (one fifth of the WINDOW value) is also changed.
WINDOW=*UNCHANGED
The time interval of the window timer remains unchanged.
WINDOW=*STD
The time interval of the window timer is changed to the default value (60 seconds).
WINDOW=<integer 2..180>
The time interval of the window timer is changed to the specified value (in seconds).
RETRANSMISSION=...
The time interval of the retransmission timer is changed.
A protocol element which must be acknowledged is retransmitted if it was not acknowledged by the partner transport control during the time interval.
The value is rounded up to a multiple of 2 seconds. The timer has a precision of 2 seconds.
The retransmission timer is only to be changed where absolutely essential. The timer has major effects on the loading of the system and the LAN. It should be noted that changes to WINDOW values also affect RETRANSMISSION.
For WINDOW=*STD, the RETRANSMISSION value is 10.
RETRANSMISSION=*UNCHANGED
The time interval of the retransmission timer remains unchanged.
RETRANSMISSION=*STD
The time interval of the retransmission timer is changed to the default value (10 seconds).
RETRANSMISSION=<integer 2..36>
The time interval of the retransmission timer is changed to the specified value (in seconds).
OPTIONS=...
Options for modification.
OPTIONS=*UNCHANGED
No options are changed.
OPTIONS=ROUTING(...)
Routing options are changed.
ARP=...
Specifies if, and how, ARP is used.
ARP=*UNCHANGED
The use of ARP is not changed.
ARP=QUIET
ARP is used every 2 seconds when a route is used for the first time.
Every 300 seconds, there is a check – set via BCTIMES -to determine whether data transmission has taken place within the elapsed time interval. If this is not the case, and if communication associations exist via the route, an ARP request is sent.
ARP=ON
ARP is used during route activation (every 2 seconds), and ARP requests – set via BCTIMES – are to be sent periodically (every 300 seconds).
ARP=OFF
ARP is not used.
RARP=...
Specifies whether RARP is used passively.
RARP= *UNCHANGED
The passive use of RARP is not changed.
RARP=ON
RARP is used passively.
RARP=OFF
RARP is not used passively.
NSDU-LENGTH-MAXIMUM=...
The maximum NSDU length is changed.
NSDU-LENGTH-MAXIMUM=*UNCHANGED
The maximum NSDU length is not changed.
NSDU-LENGTH-MAXIMUM=<integer 512..65530>
The maximum NSDU length is changed to the specified value (in bytes).
AUTO-ROUTE-SWITCHING=...
This operand sets the option "Routing change due to routing protocols for IP".
AUTO-ROUTE-SWITCHING=*UNCHANGED
The previous setting is retained.
AUTO-ROUTE-SWITCHING=*ON
Routing changes due to routing protocols for IP are performed.
AUTO-ROUTE-SWITCHING=*OFF
No routing changes due to routing protocols for IP are performed.AUTO-ROUTE-SWITCHING prevents an IP route switched using MODIFY-ROUTE from being switched to a router other than the one specified by the IP routing protocol functions. The same functionality is provided by BCOPTION / MODIFY-BCAM-OPTIONS AUTO-ROUTE-SWITCHING=OFF. However, in this case the setting applies to all the IP routes.
CHECKSUM=...
Specifies whether or not checksum verification is performed for the route when a segment is received. The checksum for the segments for transmission is always calculated and entered in the protocol. This option can sometimes be used to improve reception performances.
This specification only applies to routes with the transport profile TCP.
This option should only be used on routes on which there is no risk of data corruption.
The machine-internal connection between BS2000 guest machines on a VM2000 system, for example, is suitable for this.
CHECKSUM=*UNCHANGED
The previous setting is unchanged.
CHECKSUM=*ON
Checksum verification is performed.
CHECKSUM=*OFF
Checksum verification is not performed.
ADD-IP-NET=...
With ADD-IP-NET, you specify which additional IP address or which additional range of IP addresses can be accessed via the route specified in the ROUTES operand No IP address range may be specified in the ROUTES operand.
This parameter can only be specified locally via LAN.
ADD-IP-NET=*UNCHANGED
The definition indicating which IP addresses can be accessed via this route is not changed.
ADD-IP-NET=*UNKNOWN
All non-generated IP addresses are accessed via this route.
ADD-IP-NET=<composed-name 7..15> /x-string 1..8> / list-poss (4): <integer 1..255>
Specifies which IP addresses are accessed via this route. If another route is already assigned to these addresses, the command is not carried out.
ADD-IP-NET=*RANGE(...)
Range of IP addresses accessed via this route.
FROM=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Lowest IP address of the range which can be accessed via this route.
TO=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Highest IP address of the range which can be accessed via this route.
REMOVE-IP-NET=...
Specifies which IP address or range of IP addresses can no longer be accessed via the route specified in the ROUTES operand. No IP address range may be specified in the ROUTES operand.
REMOVE-IP-NET=*UNCHANGED
The definition indicating which IP addresses are accessed via this route is not changed.
REMOVE-IP-NET=*UNKNOWN
All non-generated IP addresses are no longer accessed via this route.
REMOVE-IP-NET=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Specifies which IP addresses are no longer accessed via this route.
REMOVE-IP-NET=*RANGE(...)
Range of IP addresses which is no longer accessed via this route.
FROM=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Lowest IP address of the range which is no longer to be accessed via this route.
TO=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Highest IP address of the range which is no longer to be accessed via this route.
ADD-ISO-NET=...
Specifies which Internet addresses are accessible via the route specified in the ROUTES operand. It is not possible to specify a range of IP addresses in the ROUTES operand.
This parameter can only be specified locally via LAN.
ADD-ISO-NET=*UNCHANGED
The definition indicating which Internet addresses are accessed via this route is not changed.
ADD-ISO-NET=*UNKNOWN
All non-generated Internet addresses are accessed via this route.
ADD-ISO-NET=<x-string 1..40>
Specifies which Internet address is accessed via this route. If another route is already assigned to this Internet address, the command is not carried out.
REMOVE-ISO-NET=...
Specifies which Internet addresses are no longer accessed via the route specified in the ROUTES operand. It is not possible to specify a range of IP addresses in the ROUTES operand.
REMOVE-ISO-NET=*UNCHANGED
The definition indicating which Internet addresses are accessed via this route is not changed.
REMOVE-ISO-NET=*UNKNOWN
All non-generated Internet addresses are no longer accessed via this route.
REMOVE-ISO-NET=<x-string 1..40>
Specifies which Internet address is no longer 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 locally via LAN.
ADD-IPV6-NET=*UNCHANGED
The definition of the IPv6 addresses that can be accessed via this route is not changed.
ADD-IPV6-NET=*UNKNOWN
All non-generated IPv6 addresses can be accessed via this route.
ADD-IPV6-NET=<c-string 1..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-IPV6-NET=...
Uses the IPv6 prefix/length to specify which IPv6 addresses can no longer be accessed via this route.
REMOVE-IPV6-NET=*UNCHANGED
The definition of the IPv6 addresses that can be accessed via this route is not changed.
REMOVE-IPV6-NET=*UNKNOWN
All non-generated IPv6 addresses can no longer be accessed via this route.
REMOVE-IPV6-NET=<c-string 1..49>
Specifies which IPv6 addresses can no longer be accessed via this route.
The principle for defining default routers and address ranges is illustrated in the section "Principle of default router and address range definition" (MODIFY-ADDRESS-ASSIGNMENT / MDADA: Modify address assignment) with an example.
MODIFY-ROUTE / MDROUTE Modify route path | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ROUTES=NAME(...)
Routes defined by their names are changed. Modification of each individual route is logged with the message BCA07C2. If several routes lead to the specified processor, the number of routes changed is logged with the message BCA07C1.
ROUTE-NAME=<rout-name 1..8>
Name of the route which is changed.
PROCESSOR-NAME=<processor-name 1..8>
Name of the processor whose routes are changed.
ROUTES=ADDRESS(...)
Routes defined by their addresses are changed. Modification of each individual route is logged with the message BCA07C2. If several routes lead to the specified processor, the number of routes changed is logged with the message BCA07C1.
IP-ADDRESS=
Specifies the IP address of the route or the IP address range of the routes for modification.
IP-ADDRESS=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
IP address of the route to be changed.
IP-ADDRESS=*RANGE(...)
IP address range of the routes for modification. Specification of *RANGE is only useful in conjunction with PATH since it serves to switch the IP address range defined with *RANGE to the router specified with PATH.
FROM=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Lowest IP address of the range to be changed.
TO=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
Highest IP address of the range to be changed.
PATH=...
Specifies the path change of the route. This specification is only possible in the LAN for routes defined with the Layer 3 profile IP.
When PATH is used, no other operands may be specified.
PATH=*UNCHANGED
The path of the route is not changed.
PATH=*VIA-ROUTE(...)
The route is operated via a router.
ROUTE-NAME = <rout-name 1..8>
Name of the route to the router, which acts as the first segment of the new path of the route.
IP-ADDRESS=<composed-name 7..15> / <x-string 1..8> / list-poss (4): <integer 0..255>
IP address of the route to which the route defined with ADDRESS or NAME is switched.
Command logging
For reasons of compatibility, the processing acknowledgment is supplied in news BCA0763 if it is positive and in news BCA0762 if it is negative.
In addition, for positive acknowledgments, the messages BCA07B0, BCA07C1, BCA07C2, and BCA07C3 may also appear. For positive and negative acknowledgments, the message BCA07C4 may appear.
A description of the error messages that can be issued during command processing is provided in the table below.
Command return codes
(SC2) | Maincode | Meaning |
| CMD0001 | Command successfully processed |
| BCA0768 | Syntax error in command |
| BCA0770 | Parameter incorrect |
| BCA07B1 | Route is no longer used as router |
| BCA07B4 | Route is no longer used as IP router |
| BCA07B6 | Route is no longer used as IPv6 router |
| BCA07C0 | No route changed |
| BCA07A0 | Processor is unknown |
| BCA07A1 | Route is unknown |
| BCA07A9 | Route is not excluded |
| BCA07EE | Command is being executed |
| BCA079F | Address not known |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |
Examples
Modification of a route’s attributes
/MODIFY-ROUTE ROUTES=*NAME(ROUTE-NAME=ROUTOTTO), -
/ OPTIONS=*ROUTING(ARP=*QUIET)
/MODIFY-ROUTE ROUTES=*NAME(ROUTE-NAME=ROUTOTTO), -
/ CHECKSUM=*ONRouter definition for a non-defined IP network 189.44.00.00.
/MODIFY-ROUTE ROUTES=*NAME(ROUTE-NAME=RO70#2), -
/ ADD-IP-NET=(189,44,0,0)or
/MODIFY-ROUTE ROUTES=*NAME(ROUTE-NAME=RO70#2), -
/ ADD-IP-NET=x‘BD2C0000‘Router definition for a default router
/MODIFY-ROUTE ROUTES=*NAME(ROUTE-NAME=RO75#1), -
/ ADD-IP-NET=*UNKNOWNRouter definition for the IP address range intervals (0.0.0.1,0.0.0.20) (0.0.0.40,0.0.0.10) with subsequent deletion of intervals.
/MOD-ROUTE ROUTE=NAME(ROUTE-NAME=ROUTER), -
/ ADD-IP-NET=*RANGE(FROM=0.0.0.1,TO=0.0.0.100)
/MOD-ROUTE ROUTE=NAME(ROUTE-NAME=ROUTER), -
/ REMOVE-IP-NET=*RANGE(FROM=0.0.0.21,TO=0.0.0.39)
/MOD-ROUTE ROUTE=NAME(ROUTE-NAME=ROUTER), -
/ REMOVE-IP-NET=*RANGE(FROM=0.0.0.1,TO=0.0.0.100)