home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / packet / bb211 / fwd.doc < prev    next >
Text File  |  1991-02-09  |  9KB  |  248 lines
  1.  
  2. To forward to a station, that station must now be designated a BBS or a
  3. personal BBS.  Use the EU command and set the proper flag.
  4.  
  5.      B flag -- Old BBS programs that don't have the [xxx] info
  6.      A flag -- Advanced BBS that does send [xxx].  When in doubt,
  7.                use this flag
  8.      P flag -- Personal BBS.
  9.  
  10. Rather than the current way of having a list of destinations for each
  11. route, a list of routes for each destination is used.  The data has been
  12. broken into two pieces.  How to connect with a distant mailbox is in the
  13. PATH file while the information on what to send is in the ROUTE file.
  14.  
  15. The ROUTE File
  16. --------------
  17.  
  18. A line from the ROUTE file is organized as:
  19.  
  20.     W3IWI W0RLI WB6ASR 80 KE6BX
  21.  
  22. This says to send mail for W3IWI mailbox down the path named either
  23. W0RLI, WB6ASR, and then KE6BX.  The forwarding will be performed in that
  24. order.  W0RLI will be tried first and then WB6ASR.  If a message is
  25. more than 80 hours old, KE6BX will be used.
  26.  
  27. Wildcards are supported.   For full details on these, see WILDCARD.DOC.
  28. Just more than * is supported.
  29.  
  30. Once a message (or a member of a distribution list has been selected, it
  31. cannot be selected for another route.
  32.  
  33.         95020   AA4RE
  34.         95*     W0RLI
  35.  
  36. A message with a route code of 95020 will go to AA4RE.  All others go to
  37. W0RLI. 95020 will not since it was selected for the AA4RE route already.
  38.  
  39. The ROUTE files also allows ALIASES.  These are of the form
  40.  
  41.        SOCAL = K6IYK W6PW
  42.  
  43. Anywhere SOCAL appears in a route, K6IYK W6PW will be substituted.  So
  44. if the ROUTE file says
  45.  
  46.        WB6YMH SOCAL
  47.  
  48. this is the same as
  49.  
  50.        WB6YMH K6IYK W6PW
  51.  
  52. Aliases only affect the path to use.  Aliases must be listed before they
  53. can be used.
  54.  
  55. >>> Special cases:
  56.  
  57.    If you send something to LEAVE then it will stay on the BBS and not
  58.    be forwarded.  This is handy to prevent just certain messages to stay.
  59.    Example:
  60.  
  61.        95020 LEAVE
  62.        95*   KE6BX
  63.  
  64.        A message to 95020 will stay but all other 95anything will go to
  65.        KE6BX.
  66.  
  67.    If the special @BLANK is used, this will match any message where
  68.    the @BBS field is blank.  Combining LEAVE and BLANK make some
  69.    route tables easy:
  70.  
  71.        AA4RE  LEAVE
  72.        @BLANK LEAVE
  73.        *      WB6ZVW
  74.  
  75.        Any message addressed to @AA4RE stays.  Any message addressed to
  76.        anycall without @ will stay.  All others will go to WB6ZVW.  This
  77.        is very handy for a small BBS where everything but local calls go
  78.        to one other BBS.
  79.  
  80.    If you send something to ? then it will stay on the BBS and not
  81.    be forwarded.  It will show up if you execute the L? command.
  82.    Example:
  83.  
  84.        USA   ?
  85.  
  86.        A message to USA will be marked with the ? flag
  87.  
  88. The PATH File
  89. -------------
  90.  
  91. The PATH file has the entries that describe how to connect to a
  92. mailbox we want to forward to.   A typical entry:
  93.  
  94.  
  95. PATH W0RLI  B W0RLI
  96. O TA
  97. T 0000 0600
  98. T 1000 1600 1 5
  99. T 2200 2359
  100. C W6AMT-10
  101. PF 12
  102. SC #SFO3
  103. R* to *
  104. SC SNTCRZ
  105. R* to *
  106. SC W0RLI
  107. R* to *
  108.  
  109.     PATH pathname port callsign force
  110.  
  111.            "pathname" is the name of this path.  Any arbitrary 12
  112.            characters will do.  This matches the entry in the
  113.            ROUTE file.
  114.  
  115.            "port" is the letter of the port to use to connect to this
  116.            mailbox on.  If this is a DRSI card, you must also code the
  117.            port on the C(onnect) statement.
  118.  
  119.           "callsign" is used to set certain parameters found in the USER file
  120.           (like MAXPAC etc).  Any call can be used here as long as the USER
  121.           file contains the information.  This call is also used for REVERSE
  122.           FORWARDING.
  123.  
  124.          "FORCE" -- If the actual word FORCE appears after the
  125.          callsign, connect via this path even if no messages.
  126.  
  127.     C(onnect) callsign
  128.  
  129.            This is the actual connect command to be used.   For the
  130.            DRSI card, don't forget to include port.  Example:
  131.                  C 1:AA4RE
  132.  
  133.     P(ort) cmd
  134.  
  135.            This is a command to be issued to this port.  Can be
  136.            used to change all sorts of things.  Be careful to affect
  137.            only this "channel".  See the documentation for your TNC
  138.            as to what is allowed.
  139.  
  140.     S(end) text
  141.  
  142.            Send the text of this line to the distant station.
  143.  
  144.     R(ecieve) pattern
  145.  
  146.            If the next line received from the distant station does not
  147.            match this line disconnect.  Full pattern matching can be used.
  148.            "R* to *" is great for the NETROM response.  Be careful when
  149.            constructing your own pattern.  It starts immediately after the
  150.            "R" without an intervening blank.
  151.  
  152.     O(Order) order_info
  153.  
  154.            This controls how messages are ordered before forwarding.
  155.            order_info can have up to three characters:
  156.  
  157.               A -- Order by age with oldest first
  158.               T -- Order by type.  T before P before B.  This is
  159.                    actually an alphabetical sort.  Special case
  160.                    of "P" with distribution list is same as "B"
  161.               S -- Order by size.  Smallest first
  162.               D -- Order by day.  Similar to A but only the day matters
  163.                    and not the time.  Oldest first.
  164.               R -- Reverse of D.  Latest is first.
  165.  
  166.            If you code the letters TA then the messages will be sent
  167.            by type then age within type.  Thus the first message sent
  168.            will be the oldest "T" message.  The order will look
  169.            like this:
  170.  
  171.                 oldest "T" message
  172.                 .
  173.                 newest "T" message
  174.                 oldest "P" message
  175.                 .
  176.                 newest "P" message
  177.                 oldest "B" message
  178.                 .
  179.                 newest "B" message
  180.  
  181.            Note that using "A" as a parameter except as the last letter
  182.            is kinda useless.  If you gave "AT" then messages would be
  183.            ordered by AGE then type.  The probability of two messages
  184.            being the same AGE (down to the second) is very very small.
  185.            This is why the "D" is given.  "DT" would order by DAY and
  186.            then TYPE within DAY.
  187.  
  188.            Note 1:  The "O" statement must be before any "C" statements
  189.            Note 2:  There is a DEFAULT_FORWARD_ORDER parameter that
  190.                     applies on a port basis in PARMS.BB
  191.  
  192.     T(ime) start_time end_time start_day_of_week end_day_of_week ...options...
  193.  
  194.            Use this path during certain times.
  195.               start_time = start time we can use path.  HHMM format
  196.               stop_time  = stop time we can use path.  If not given then
  197.                            we can forward anytime after start time.
  198.               start_day_of_week = Day of week we can use this path.
  199.                            Sunday = 0, Monday = 1, etc.  If omitted, can
  200.                            use any day.  If no end_day_of_week given then
  201.                            path can be used this day ONLY.
  202.               end_day_of_week = Last day path can be used.
  203.               options = options for more control.
  204.                            HOUR x/y    If the hour divided by x has a
  205.                                        remainder of y then forward.
  206.                                        Examples:
  207.                                           HOUR 2/0   Only even hours
  208.                                           HOUR 2/1   Only odd hours
  209.                                           HOUR 3/1   Every 3 hrs (0100 is ok)
  210.                            ORDER ccc   Same as "O" but only for this time
  211.                                        period.  Must be last thing on line.
  212.                            SIZE nnn    Max size to forward in this time period
  213.  
  214.  
  215.            Note 1:  All start/end are INCLUSIVE.
  216.            Note 2:  You can have many "T" statements.  If ANY of them
  217.                     is true, you can forward.
  218.            Note 3:  The "T" statement must be before any "C" statements
  219.            Note 4:  The ORDER operand will be wiped out by an "O" statement
  220.                     so put "O" statements before "T"
  221.  
  222.            Examples
  223.  
  224.               T 0900 2300                 Use this path from 0900 to 2300
  225.               T 0000 2359 1 5             Use this path from Mon to Fri
  226.               T 0000 2359 0 6 HOUR 2/0    Any day but only even hours
  227.               T 0000 0800 6 6 HOUR 2/1    Odd hours between midnight and
  228.                                           eight AM on saturday only
  229.               T 1200 2359 0 6 ORDER DT    Forward between noon and midnight
  230.                                           on any day with order sequence DT
  231.               T 1200 2200 0 6 SIZE 100    Forward between noon and 10 PM
  232.                                           on any day but only messages of 100
  233.                                           bytes or less
  234.               T 1200 2359 0 6 ORDER DT SIZE 100
  235.                                           Forward between noon and midnight
  236.                                           on any day with order sequence DT
  237.                                           but only messages of 100 bytes or
  238.                                           less
  239.  
  240.  
  241.  
  242. ***** NOTE *****
  243.  
  244. To ensure proper operation, execute the GF command after updating
  245. ROUTE.BB
  246.  
  247.  
  248.