home *** CD-ROM | disk | FTP | other *** search
- ╔════════════════════════════════════════════════════════════════════════╗
- ║ DWARZ Routing Documentation Version 2.00 ║
- ║ SoftSpot SoftWare Inc. C. 1991 Bruce Ruona ║
- ║ FEBRUARY 10th, 1991 ║
- ╚════════════════════════════════════════════════════════════════════════╝
-
- Effective with versions 2.00 and later, it is now possible to have both
- DWARZ and DWARZNET automatically and internally route data files for one
- node through a second intermediate node. This file explains and details
- the necessary set-up if you wish to implement this feature. Thus Data
- packets for one node may now be packed up under an archive and sent to
- a different node then intended for, which presumably will then unpack
- and repack transient data packets for the intended nodes or even route
- them further yet!
-
- To set-up a ROUTING file for each league you may be running in, simply
- load up your favorite ASCII TEXT editor and create a file for each league
- titled 'ROUTEnn.INF' in your MAIN dwarz directory where the 'nn' matches the
- number of the league you've assigned that league. For example, if you are
- running under two leagues, one National (LEAGUE0) and the other Local
- (LEAGUE1) you'd create two route files titled 'ROUTE0.INF' and 'ROUTE1.INF'
- in your main DWARZ Directory.
-
- In these files, lines with the first Non-Space character being a Semi-Colon
- are considered Comment Lines and are ignored, as are blank lines.
-
- throughout the file, you may use the GLOBAL term 'ALL' to designate ALL
- Zone, Nets, or nodes in a net, except for the VIA Statement which must be
- a SPECIFIC node (It's kinda hard to route data via ALL nodes!), thus to
- designate ALL nodes here in zone 1, net 2280, I simply enter the
- 'node address' 1:2280/all. The Term 'ALL' by itself designates ALL
- Zones:nets/nodes--In other words EVERYBODY.
-
- Specific Routing verbs "understood" by DWARZ include the following:
- ROUTE and FLAG(S). Please note that the DIRECT verb found in dwarz v1.11
- is no longer supported or necessary!!
-
- ROUTING VERBS:
- -------------- =====
- ROUTE
- =====
-
- The general format for this verb is:
- ROUTE ALL|[zone:][Net/]Node]... VIA [zone:][Net/]Node
- [EXCEPT [zone:][Net/]Node]...]
-
-
- NOTE: ALL nodes initially default to a "direct" send, ie, data is packed/
- sent directly to that node, so for these you do not need a routing
- statment!
-
- When entering multiple node address' you must seperate each node
- by either a space or a comma.
-
- EXAMPLE: Suppose we have the following situtation for League0:
-
- NODES: How we wish these nodes to be routed:
- ------------- -------------------------------------
- 1:2280/1 {thats us!}
- 2280/2 direct
- 2280/3 direct
- 110/255 direct
- 110/257 110/255
- 3625/454 direct
- 3625/455 3625/454
- 187/19 3625/454
- 187/234 3625/454
- 2:512/1 direct
- 3:700/1 2:512/1
- 600/1 2:512/1
- 400/1 direct
-
- then our routing statement(s) would look something like the following:
-
- ; ROUTE file, LEAGUE0 for Bytes -r- Us, 1:2280/1
- ; this routes all nodes in Zone 1, net 110 via 110/257:
- ROUTE 110/ALL via 110/257
-
- ;this routes all zone 2 and 3 via 2:512/1 except for 3:400/1:
- ROUTE 2:all 3:all via 2:512/1 Except 3:400/1
-
- ;finally route nodes via 3625/454:
- ROUTE 3625/ALL 187/19 234 via 3625/454
- ; end of routing file statements
-
-
- of course for those nodes that wish to Route ALL their data via a specific
- node the routing statement becomes the most basic of all:
- ROUTE ALL via 1:2280/1
-
- You should note that EACH routing statement defaults to YOUR ZONE:NET data,
- so you do not have to enter these unless different zones/nets are being
- entered.
-
- when Using Multiple entries for either the routed nodes or except nodes,
- the following node will use the same ZONE:NET as the previous entry, thus
- in the third line of the routing statement above, to route both 187/19 and
- 187/234, I only had to enter the node number for 234 since the zone:net had
- already been set by the entry 187/234.
-
- ======
- FLAG(S)
- ======
-
- Version 2.xx and above of DWARZ now allows you to define mail 'Flags' for
- specific nodes, that will determine how you mailer/front end will handle
- the messages created by DWARZ. These are actually TOGGLES for any GLOBAL
- mail flags you may have defined in the INSTALL program, so if you have set
- the IMM mail flag in there and then define a number of nodes as IMMediate
- in your routing filem these nodes will actually NOT be sent Immediately!...
- thus you may wish to not define ANY Mail flags in the install program, and
- simply designate the appropriate flags in your routing file instead.
-
- The general format for this statment is:
- Flags ALL|[zone:][Net/]Node [HOLD][CRASH][IMM][DIR]
-
- Note that Multiple node address' are NOT supported in this statement, although
- the global 'ALL' is fully supported.
-
- HOLD: All mail is marked 'HOLD for pickup by address',
- ----- (DBRIDGE Users: Sorry, haven't figured out how to apply this to
- the DBridge QUEUE entry yet!)
-
- CRASH: All mail is marked CRASH to be sent as soon as your front end will
- ------ allow.
-
- IMM: All mail is marked for IMMEDIATE sending by your Front End.
- ----
-
- DIR: All mail is marked SEND DIRECT to address, non routable by your normal
- ---- front end routing parameters.
-
- GENERAL:
-
- Please note that ALL Routing statements are limited to 255 character or
- less!! Exceeding this will cause NASTY problems (most likely!!). Case is
- ignored, you may use either lower or upper case at your own liking...
-
- Multiple addresses are limited to 25 per line for routed nodes and except
- nodes. If you need more then this, simply enter more then one line.
-
- There is only VERY Limited built in Routing Error determination! Thus
- You must be VERY carefull in designing your statements otherwise Loops
- could occur that may drive the program right up the wall!! For example,
- STAY AWAY from the following type of routing:
- ROUTE ALL Via 1:2202/7
- Route 1:2202/7 via 1:128/74
- This would attempt to route all thorough 7, but then tries to route 7
- through 128/74 which has been routed through 7, Thus creating a Loop!
-
-