ROUTE Loadable Module Why use ROUTE? Use ROUTE to allow NetWare to pass frames (packets) through IBM bridges on a Token-Ring cabling system. You must load the TOKEN LAN driver before you load ROUTE. All NetWare workstations must use the new Token-Ring workstation driver. The following tasks are described in this section. Set up the file server for source routing Change a source routing parameter Command format LOAD [path]ROUTE [parameter...] Command parameters Replace path with a full directory path to the directory containing the module; begin with a DOS drive letter or a NetWare volume name. If you do not specify a path and the SYS volume is mounted, the operating system assumes that the module is located in the SYS:SYSTEM directory. (Use SEARCH to set up additional paths for automatic searching.) Replace parameter with one or more of the following: BOARD = number REMOVE = number CLEAR RSP = value DEF TIME = number GBR UNLOAD MBR Each parameter is described below. Parameters All the parameters described on the following pages are optional. ROUTE can be loaded re-entrantly (a second time) with a specified parameter to change ROUTE's configuration. Most of the parameters have default values that should work with simple configurations for IBM bridges. If you have installed parallel IBM bridges, you can change some of the parameters to reduce traffic on some of the paths. For more information about source routing and broadcast frames, see the IBM Token-Ring Network Architecture Reference produced by IBM. BOARD = number Use this parameter if the Token-Ring driver is not the first driver loaded. The operating system numbers the boards, starting with the first driver loaded. That board is board number one. (Check the order in the AUTOEXEC.NCF file if you have loaded more than one driver.) Use this parameter to specify which board you want to change parameters on or load ROUTE for. CLEAR Use this parameter to manually clear the Source Routing table. This parameter will force a dynamic rebuilding of the table by sending a default frame to each specific node in the network. Use this parameter when an IBM bridge on the network has gone down and an alternate route is available. DEF Use this parameter to prevent frames that have unknown (DEFault) destination addresses from being sent across Single Route IBM bridges. If this parameter is specified, all frames that have addresses not currently in the file server's Source Routing table will be forwarded as All Routes Broadcast frames. If this parameter is not specified, all frames that have addresses not currently in the file server's Source Routing table will be forwarded as Single Route Broadcast frames. If ROUTE has already been loaded with the DEF parameter, reloading ROUTE with this parameter broadcasts all subsequent Single Route Broadcast frames as All Routes Broadcast frames. GBR Use this parameter to specify that all General BRoadcast frames are to be sent as All Routes Broadcast frames. If this parameter is not specified when ROUTE is loaded, all General BRoadcast frames are broadcast as Single Route Broadcast frames. If ROUTE has already been loaded with the GBR parameter, reloading ROUTE with this parameter broadcasts all subsequent General BRoadcast frames as All Routes Broadcast frames. MBR Use this parameter to specify that all Multicast BRoadcast frames are to be sent as All Routes Broadcast frames. If the parameter is not specified when ROUTE is loaded, all Multicast BRoadcast frames are broadcast as Single Route Broadcast frames. If ROUTE has already been loaded with the MBR parameter, reloading ROUTE with this parameter broadcasts all subsequent Multicast BRoadcast frames as All Routes Broadcast frames. REMOVE = number Use this parameter to remove a specified node address from the file server's Source Routing table. Use the parameter when a bridge has gone down. When you remove the node from the Source Routing table, you force the file server to determine an alternate route. Replace number with a 12-digit (06-byte) hexadecimal number. If less than 9 digits are entered, ROUTE prefixes the address with 4000h. For example, REMOVE=2 is interpreted as REMOVE=400000000002 RSP = value Use this parameter to specify how the file server should ReSPond to a broadcast request. Replace value with one of the following. NR Specifies that all Broadcast Requests are to be responded to directly; a Broadcast Response is Not Required. This is the default value. AR Specifies that all Broadcast Requests are to be responded to with an All Routes Broadcast frame. SR Specifies that all Broadcast Requests are to be responded to with a Single Route Broadcast frame. TIME = number Use this parameter to specify how often the Source Routing table should be updated. This parameter forces the table to be updated with a new route if the current route has not been used during the specified time period. This parameter enables ROUTE to dynamically determine alternate routes when an IBM bridge goes down. Replace number with a value from 03 to 255 seconds. The default is 03 seconds. UNLOAD Use this parameter after the board parameter to specify which board you want to remove source routing from. To unload ROUTE.NLM from the file server, use UNLOAD ROUTE. Additional information As frames pass through an IBM bridge, source routing information is added to the frame header at the Media Access Control (MAC) layer. NetWare's bridging is done above this layer. ROUTE.NLM enables NetWare To keep track of the source routing information in the frames; To configure the source routing information in the frames according to the parameters that ROUTE is loaded with. ROUTE can be loaded re-entrantly. If you have two Token-Ring boards in the file server, ROUTE should be loaded twice. The second time it is loaded, you must use the BOARD parameter to specify a board number. If you need to change the configuration, load ROUTE with the parameter that needs to be changed. Set up the file server for source routing To set up the file server for source routing, complete the following steps. Load the TOKEN.NLM LAN driver. Load ROUTE. Type LOAD ROUTE Change a source routing parameter To change a parameter in ROUTE after ROUTE has been loaded, select the example that fits your situation. One Token-Ring network board To clear the Source Routing table when only one driver has been loaded, type LOAD ROUTE CLEAR Two Token-Ring network boards To change a parameter when more than one driver has been loaded, complete the following steps. This example shows how to change the update time for the Source Routing table from the default of 3 seconds to 10 seconds. To change the TIME parameter for the first driver loaded, type LOAD ROUTE BOARD=01 TIME=10 To change the TIME parameter for the second driver, type LOAD ROUTE BOARD=02 TIME=10