
              NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:              Source Routing Files
DOCUMENT ID:        TID014592
DOCUMENT REVISION:  A
DATE:               24JAN94
ALERT STATUS:       Yellow
INFORMATION TYPE:   Symptom Solution
README FOR:         SROUT2.EXE

NOVELL PRODUCT and VERSION:
NetWare Pre 3.11 and 2.2
NetWare 2.2
NetWare 3.11
NetWare 3.12
NetWare 4.01

ABSTRACT:

The files contained are for implementing the ability for Novell servers,
routers, and DOS, Windows, OS2, TCPIP clients to SOURCE ROUTE their frames on
FDDI, Token-Ring, and PCNET networks.  These files include the ability to
handle up to 13 Source Routing Bridge hops as specified in the new IEEE SRT
specification.


DISCLAIMER  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
NOVELL.  NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS
INFORMATION.  HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR
INFORMATION ONLY.  NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY
OF THIS INFORMATION.


SYMPTOM
     Changes/Fixes

     ROUTE.com and ROUTE.nlm parameters have been modified to remain
     consistent with the IEEE 802.1d Source Routing Transparent (SRT)
     Operation Specification and ISO/IEC 8802-2/DAM 5.3 Route Determination
     Entity Specification.

     The following changes have been made:  Added New Parameter (XTX=nn) to
     ROUTE.com and ROUTE.nlm to  allow an extra send count.  ROUTE.com and
     ROUTE.nlm will transmit XTX times after a route is timed out before
     resorting to single route broadcasts.

     Changed the Aging Timer Algorithm for ROUTE.com and ROUTE.nlm so that a
     value of TIME=00 means the route will NEVER time out.

     Changed TIME= parameter's range to TIME=0-3640 for ROUTE.com.

     Changed TIME= parameter's range to TIME=0-65535 for ROUTE.nlm.

     Added NAME=  parameter to ROUTE.nlm so that user can load route by board
     name instead of BOARD=.

     Changed the default RSP value in ROUTE.nlm to RSP=AR.


SOLUTION

     Apply SROUT2.EXE.

     Self-Extracting File Name:  SROUT2.EXE     Revision:  A

     Files Included     Size     Date      Time

     \
       SROUT2.TXT         (This File)
        ROUTE.COM       4903   12-01-93   11:53a     v2.20
        ROUTE.NLM       5013   12-01-93   12:01p     v4.10
        ROUTE.SYS      45440   08-12-93   10:58a     v4.11
        ROUTE.VP0       3896   11-04-93   10:50a     v1.10
     SRCONFIG.COM       5396   07-08-92    2:21p     v2.00


     Installation Instructions:

     ROUTE.COM - NetWare Source Routing Driver v2.20 for DOS.  All command
     line parameters (for AUTOEXEC.BAT) are described below:

     ROUTE   
                    U,BOARD=dd,CLEAR,DEF,GBR,HOPS=dd,MBR,NODES=dd,TIME=ss,TRA=d
                    d,TRO=dd,XTX=nn

     ?         Gives a help display of all ROUTE.COM syntax if ROUTE.COM has
               not been loaded.  If ROUTE.COM has already been loaded, the
               source routing table is dumped to the screen or can be
               redirected to a file.

     U         Unload a previously installed Source Router (ROUTE.COM) from
               memory.

     BOARD=dd  A DECIMAL board number as assigned by ODI.  This parameter is
               only for use with ODI drivers.  Do not use this parameter if
               you are using dedicated IPX Drivers.

     CLEAR     CLEAR ALL Nodes from a previously loaded Source Router.  This
               clears an existing source routing table of all entries.

     DEF       Send DEFault (Unknown) Node Addresses ALL ROUTES Broadcast.  If
               this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     GBR       Send Broadcast (FFFF FFFF FFFF) Addresses ALL  ROUTES
               Broadcast.  If this parameter is not entered, SINGLE ROUTE
               Broadcast is assumed.

     HOPS=dd   A DECIMAL number specifying the number of bridge hops to
               configure.  The DEFAULT is 07, and the MAXIMUM is 13; the
               minimum is 01.  This parameter adjusts the size of the source
               routing table to allow up to 13 source routing bridge hops per
               table entry.  If "0" is specified, the default of 07 is used. 
               To conserve memory, this number should be set as low as
               possible while still allowing for the maximum number of bridge
               hops possible on the network.

     MBR       Send MultiCast (C000 xxxx xxxx) Addresses ALL ROUTES Broadcast.
               If this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     NODES=dd  A DECIMAL number of NODE Addresses to support.  The DEFAULT is
               16, and the MAXIMUM is 1000.  If the value is less than 08,
               then 08 is used.

     TIME=ss   A DECIMAL number specifying the number of seconds to wait
               before a known route is timed out.  The  DEFAULT is 10, and the
               MAXIMUM is 3640.  On receives, a timed out route will be
               updated.  On transmits, a timed out route will not be used;
               instead, the frame will be all-routes or single-routes
               broadcast according to the "DEF" parameter.  The full range of
               ss = 0-3640.  If ss=0, time-outs are disabled and routes will
               NEVER be timed out.  ss=0 is not recommended where alternate
               bridge routes have been incorporated into the design of the
               network.

     XTX=nn    A DECIMAL number specifying the number of extra transmits on a
               route that has been timed-out by the TIME= setting.  This
               allows the route to be timed-back-in before SR or AR broadcasts
               are sent out (per the "DEF" parameter).  The default is XTX=1,
               and the full range is XTX = 0 - 255.

     TRA=dd    A DECIMAL number specifying a THIS RING ALTERNATE count for
               Broadcasts.  The Source Router will alternate between SOURCE
               ROUTED and NON-SOURCE ROUTED broadcasts.  The DEFAULT is 00,
               and the MAXIMUM is 255.

     Example:  If TRA=2 is used, and the IPX Retry Count is 20, then the first
               two retries would not be source routed.  If no response to
               these broadcasts is received, the next two retries would be
               source routed.  Each pair of retries alternates back and forth
               from non-source-routed to source routed until all IPX Retries
               are exhausted.  Note:  The TRA value must be less than the IPX
               retry count.

     TRO=dd    A DECIMAL number specifying a THIS RING ONLY count for
               Broadcasts.  The DEFAULT is 00, and the MAXIMUM is 255.

     All of the above ROUTE.COM parameters are optional, are not case
     sensitive, and may be entered in any order.  They may be used to SET the
     source router (ROUTE.COM) that is being loaded, or CHANGE the
     configuration of a previously loaded source router (ROUTE.COM).  All of
     these parameter defaults may be changed by SRCONFIG.COM.

     ROUTE.VP0 - Novell 286 OS Source Routing VAP 1.10 (931104).  Use
     SRCONFIG.COM to configure the source routing VAP.  Each route table entry
     supports up to 13 source routing bridge hops by default.  There is a
     maximum of 250 table entries.  NetWare console commands for ROUTE.VP0
     appear below:

     ROUTE     BOARD=n,CLEAR,DEF,GBR,MBR,REMOVE=xxxxxxxxxxxx,RSP=rr,TIME=ss

     BOARD=n   n is the LAN Driver Board: A, B, C, or D.  If NOT entered,
               BOARD=A is ASSUMED.

     CLEAR     CLEAR ALL Nodes from a previously loaded Source Router.

     DEF       Send DEFault (Unknown) Node Addresses ALL ROUTES Broadcast.  If
               this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     GBR       Send Broadcast (FFFF FFFF FFFF) Addresses ALL ROUTES Broadcast.
               If this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     MBR       Send MultiCast (C000 xxxx xxxx) Addresses ALL ROUTES Broadcast.
               If this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     REMOVE=xx xx is A HEXADECIMAL NODE Address to REMOVE from a previously
               loaded Source Router.  If less than 09 hexadecimal digits are
               entered, then 4000 xxxx xxxx is assumed.  Example: ROUTE
               REMOVE=10005A123456 will delete node 10005A123456 from the
               source routing table maintained by ROUTE.VP0.

     RSP=AR    Respond to Broadcast Requests through ALL ROUTES Broadcast.

     RSP=SR    Respond to Broadcast Requests through SINGLE ROUTE Broadcast.

     RSP=NR    Respond DIRECTLY to a Broadcast Request.  This is the DEFAULT.

     TIME=ss   ss is the number of SECONDS that the Source Router should wait
               before updating its Source Routing Table.  The DEFAULT is 03
               seconds.

     All parameters are separated by commas or blanks, are optional, are not
     case sensitive, and may be entered in any order at the 286 console
     prompt.  All parameter defaults may be changed by SRCONFIG.COM.

     SRCONFIG.COM - Novell Source Routing Configuration Utility 2.00 (920708)
     has been updated to configure the new features in ROUTE.COM. 
     SRCONFIG.COM will change the default parameters of ROUTE.VP0 and
     ROUTE.COM only.

     ROUTE.NLM - Novell Source Routing NLM 4.10.  It works with NetWare 3.x
     and 4.x file servers and routers and bridges.  It has been updated to
     comply with the new SRT Bridging standard where up to 13 SRT bridge hops
     can take place on a network.  The source routing table built and
     maintained by route.nlm is now increased from 18 bytes to 30 bytes per
     table entry.  This is not configurable.  There is no limit to the number
     of route table entries that can be maintained by ROUTE.NLM.  The number
     of table entries is limited only by the amount of RAM installed in the
     NetWare 386 file server.

     Valid parameters for ROUTE.NLM 4.10 are the following:

     LOAD      [d:]ROUTE
               BOARD=dd,NAME=yy,CLEAR,DEF,GBR,MBR,REMOVE=xxxxxxxxxxxx,RSP=rr,TI
               ME=ss,XTX=nn

     BOARD=dd  dd is a DECIMAL board number as assigned by the System.  If
               this parameter is not entered, BOARD=1 is ASSUMED.

     NAME=yy   Cyy is an alphanumeric name that was given to the lan board
               when the lan driver was loaded.  The NAME= parameter allows the
               user to load route by board name instead of BOARD=.

     CLEAR     CLEAR ALL Nodes from a previously loaded Source Router.

     DEF       Send DEFault (Unknown) Node Addresses ALL ROUTES Broadcast.  If
               this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     GBR       Send Broadcast (FFFF FFFF FFFF) Addresses ALL ROUTES Broadcast.
               If this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     MBR       Send MultiCast (C000 xxxx xxxx) Addresses ALL ROUTE Broadcast. 
               If this parameter is not entered, SINGLE ROUTE Broadcast is
               assumed.

     REMOVE=xx xx is a HEXADECIMAL NODE Address to REMOVE from a previously
               loaded Source Router.  If less than 09 hexadecimal digits are
               entered, then 4000 xxxx xxxx is assumed.

     RSP=AR    Respond to Broadcast Requests through ALL ROUTES Broadcast. 
               This is the DEFAULT for the RSP parameter.

     RSP=SR    Respond to Broadcast Requests through SINGLE ROUTE Broadcast.

     RSP=NR    Respond DIRECTLY to a Broadcast Request. 

     TIME=ss   A DECIMAL number specifying the number of seconds to wait
               before a known route is timed out.  The  DEFAULT is 10, and the
               MAXIMUM is 65535.  On receives, a timed out route will be
               updated.  On transmits, the timed out route will not be used;
               however, the frame will be all-routes or single-routes
               broadcast according to the "DEF" parameter. The full range of
               ss = 0-65535.  If ss=0, time-outs are disabled and routes will
               NEVER be timed out.  ss=0 is not recommended for where
               alternate bridge routes have been incorporated into the design
               of the network.

     XTX=xx    A DECIMAL number specifying the number of extra transmits on a
               timed-out route (see TIME=ss parameter). This allows the route
               to be timed-back-in before any single-routes or all-routes
               broadcasts are used according to the "DEF" parameter.  The
               default is XTX=1, and the full range is:   XTX = 0-255.

     All ROUTE.NLM parameters are optional, are not case sensitive, and may be
     entered in any order. They may be used to SET the Source Router that is
     being loaded, or CHANGE the configuration of a previously loaded source
     router.


     ROUTE.SYS - NetWare for OS/2  4.11 (930812) Source Routing Support
     driver.  The syntax for ROUTE.SYS must appear in the NET.CFG file.  The
     syntax is as follows:

          protocol route
               source route def gbr mbr nodes n board n

     def       When def is specified, frames with an unknown destination node
               address are sent "all routes."  If def is not specified, the
               default is "single routes."

     gbr       When gbr is specified, broadcast frames are sent "all routes." 
               If gbr is not specified, then broadcast frames are sent "single
               routes," which is the default.

     mbr       When mbr is specified, multicast (or functional) frames are
               sent "all routes."  If mbr is not specified, then multicast
               (functional) frames are sent "single routes."

     nodes n   n specifies the number of route table entries allowed in the
               route table maintained by ROUTE.SYS.  n is a decimal number
               from 8 to 255.  The default is 16.

     board n   n is the logical board number of the board performing the
               source routing.


