home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / packet / mbl514.arc / EXTFWD.DOC < prev    next >
Text File  |  1988-05-15  |  8KB  |  213 lines
  1.  
  2.                      EXTFWD.COM
  3.                      By WA4ONG
  4.                     May 15, 1988
  5.  
  6. EXTFWD is an addon program to the WA7MBL Version 4.31/3.31
  7. OR 5.xx BBS program, BE SURE YOU RUN THE CORRECT VERSION for
  8. your BBS!  Read the sign-on banner to be sure.  EXTFWD is
  9. intended to extend the forwarding system to help with long
  10. distance forwarding.  In addition, EXTFWD allows some
  11. enhancments to the SWAP.BBS function.  EXTFWD can work with
  12. the SWAP.BBS function, or completely replace it.
  13.  
  14. EXTFWD works by using the first part of the message title as 
  15. a forwarding extension field.  The format of this extension
  16. field is:
  17.  
  18. !w3iwi!wa4ong#New BBS FEATURE!!
  19.  
  20. Note that the field MUST start in the first column with a !
  21. char, and that ! chars seperate the calls.  The field ends
  22. at the # char, (or a space char).
  23.  
  24. What's it for?
  25.  
  26. Suspose you lived in Austrailia, and wanted to send a
  27. message to WD4IDJ @ WA4ONG in Richmond, VA.  It's pretty
  28. certian that your local BBS never heard of WA4ONG.  Now you
  29. could harass all the BBS's on the way to add WA4ONG, OR you
  30. could use the extended fwd field!.  Simply send the message
  31. to WD4IDJ@AH6GJ, which all Austrailia BBS's should know, and
  32. in the message title field put:
  33.  
  34. !WB6ASR!W3IWI!WA4ONG#Hello from Austrailia!
  35.  
  36. When the message arrives at AH6GJ, EXTFWD will replace AH6GJ
  37. (or the blank @BBS field if swap.bbs is active) with WB6ASR,
  38. and shift the message title field left so it reads as:
  39.  
  40. !W3IWI!WA4ONG#Hello from Austrailia!
  41.  
  42. When it arrives at WB6ASR, the @BBS is changed to @W3IWI by
  43. EXTFWD.  The title is now:
  44.  
  45. !WA4ONG#Hello from Austrailia!
  46.  
  47. When W3IWI gets it, EXTFWD changes the @BBS to WA4ONG, and
  48. the title now is:
  49.  
  50. Hello from Austrailia!
  51.  
  52. Note that the # (or blank) char at the end was removed, and
  53. the title now appears normal to the final destination. 
  54. Remember that the message title is limited to 70 chars, and
  55. this will be shared by both the extended forwarding field,
  56. and the actual message title.
  57.  
  58. This example assumes that all BBS's in the extended
  59. forwarding field are running EXTFWD in thier fwd files
  60. before forwarding any mail each hour.  This includes the
  61. first @BBS, AH6GJ.
  62.  
  63. If all 'major' worldwide BBS's run EXTFUN, then long
  64. distance forwarding can become much more reliable, as the
  65. person entering the message can determine the routing and
  66. enter it without relying on the BBS sysops to add a new BBS
  67. to thier fwd files.  SYSOPS can also setup EXTFWD to
  68. automatically add the extended forwarding field to certian
  69. mail, releving the user of the task.
  70.  
  71.  
  72.                     SETUP
  73.  
  74. Besides copying the EXTFWD.COM file to your BBS directory,
  75. and adding an entry to your fwd file to run it every hour
  76. BEFORE any forwarding entries, you must also copy extfwd.cnf
  77. to the bbs directory and modify it for your needs.  Also, 
  78. please copy your .btr files to a safe place in case a
  79. problem comes up while installing EXTFWD.
  80.  
  81. The first entry in it is the FULL DOS path and name of your
  82. BBSMAIL.BTR file.  Next are the actual EXTFWD commands.
  83.  
  84. Each EXTFWD command consists of three parts. The to: call,
  85. the @ call, and the actual funtion to be performed.
  86. For each message that BOTH the TO: and the @ part match, the
  87. requested function is performed on that message, and then
  88. the scan continues until all messages have been scanned. 
  89. Then the next command is selected and the process starts
  90. again.  This is repeated until all commands have been
  91. attempted.  Besides the normal to: and @ call formats, the
  92. special call '*' means match any, and 'nocall' means match
  93. all blanks.  Thus '*@nocall' would match any message without
  94. an @BBS call.   This is the ONLY type of wildcard supported
  95. at present.  Only a single astrick in the first column.
  96. 'NTS*' will not match 'NTSVA'.
  97.  
  98. There are only three functions, but they are powerful.  They
  99. start with either '!', '@', or '#'.
  100.  
  101. # -    move the next BBS in the extended forwarding field (if
  102.     one exisits) to the @BBS field, and shift the extended
  103.     forwarding field so the next bbs is in line.
  104.  
  105. ! -  Put the entire function field ahead of the message
  106.     title, thus inserting an extended forwarding field into
  107.     message.
  108.  
  109. @ -    SWAP.BBS type function.  puts the call after the @ in
  110.     the @BBS field.  No spaces allowed between the @ and
  111.     the new call.  If only a '@' is found, the @BBS field]
  112.     is blanked.  If a command has no function entered, it
  113.     operates like an '@' function without a call.
  114.  
  115. Some example commands:
  116.  
  117. * @ nocall #
  118.  
  119. Scans all messages with no @BBS call for an extended
  120. forwarding field, and if one is found, a new @BBS is
  121. extracted.
  122.  
  123. wa4xyz @ * @wa4ong
  124.  
  125. Scans all mail to wa4xyz and sets the @BBS to WA4ONG.
  126.  
  127. wa4xyz @ nocall @wa4ong
  128.  
  129. Same as above, except only if no @BBS currently exisits.
  130.  
  131. * @ wa4ong !wb6asr!w3iwi!wa4ong#
  132.  
  133. Adds extended forwarding field to all mail @ wa4ong. It
  134. MUST end with a #.  No check is make to see if the extended
  135. field already exists.
  136. NOTE: the @BBS field is NOT changed by this command, so 
  137. normally this command should be followed by :
  138.  
  139. * @ wa4ong #
  140.  
  141. which in this example will cause the @BBS to be changed to
  142. WB6ASR, with W3IWI next in the extended forwarding field.
  143. FAILURE to do these two commands in sequence will cause the
  144. EXTFWD field to keep adding the same extended forwarding
  145. field over and over.  The title will get lost and the
  146. extended forwarding will not work correctly!
  147. Alternately, you could follow it by :
  148.  
  149. * @ wa4ong @ah6gj    (assuming ah6gj is on the way to 
  150.                     wb6asr!)
  151.  
  152. or anything that will keep the same command from operating
  153. every hour!
  154.  
  155.  
  156. If all 'major' BBS's start to use EXTFWD, and the extended
  157. forwarding field, then all BBSs could benefit from running
  158. it.  For example, if a local user wants to send mail to a
  159. friend (x1zzy) in a distant country at z1zzz bbs, and the
  160. sysop knows that AH6GJ can route to z1zzz, but it is
  161. unlikely that any closer bbs knows of z1zzz then the local
  162. BBS (WA4ONG) can add the following to his extfwd.cnf file:
  163.  
  164. * @ z1zzz !w3iwi!wb6asr!ah6gj!z1zzz#
  165. * @ z1zzz #
  166.  
  167. The first entry adds the extended forwarding field to all
  168. mail @z1zzz.  the next entry 'bumps' w3iwi into the @BBS
  169. field, and off it goes!
  170.  
  171. Another use, though it should be used carefully, is to post
  172. a bulletin at a distant bbs in a different 'flood' bulletin
  173. scheme.  Suspose AH6GJ wanted to post a flood bulletin in
  174. the MDCBBS net on the east coast.  He could type in:
  175. >
  176. sb all @ wb6asr $
  177. enter message title:
  178. !w3iwi!mdcbbs#Bulletin to the east coast!
  179. ....
  180.  
  181. The problem is that the BID will be spread across the world
  182. on the way to MDCBBS.  This will pose no problem in the
  183. example given, but if some standardized BID were used, I.E.
  184. the ARRL ones, and AH6GJ tried to post an ARRL bulletin to
  185. the east coast net with this method, the BBSs on the way
  186. would have the BID on file, and would refuse the 'real'
  187. local ARRL bulletin.
  188.  
  189. Also, route timming can be tested.  AH6GJ can post a
  190. message:
  191.  
  192. >
  193. SP AH6GJ @ WB6ASR
  194. enter message title:
  195. !w3iwi!wa4ong!w3iwi!wb6asr!ah6gj#loop back timming test!
  196. ....
  197.  
  198. After a while, the message will have traveled to WA4ONG BBS
  199. and back to AH6GJ with out any action on the part of any
  200. sysop.  Jon can then see the actual routing and times, and
  201. help to work out or around any 'trouble' paths.
  202.  
  203. Comments or suggestions will be welcome.  No major work will
  204. be done to this version, I just got a beta of MBL504, and
  205. will port this to that version!
  206.  
  207. 73s Jim WA4ONG
  208.  
  209. Jim De Arras
  210. 3928 Margate Drive
  211. Richmond, VA 23235 USA
  212.  
  213.