home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / v / vbbs60-2.zip / VFIDO.DOC < prev    next >
Text File  |  1993-03-07  |  21KB  |  504 lines

  1. VBBS / Fido Gateway Version 5.60.09
  2. ===================================
  3.  
  4. Copyright Neil J Marshall 1st March 1993
  5.     TransAtlanticBBS (+44-689-890937)
  6.         1 @ 440 VirtualNET
  7.         Neil J Marshall @ 2:440/211 Fido
  8.  
  9.  
  10. Contents
  11. ========
  12.  
  13. Introduction
  14. Initial Configuration Of VFIDO To Give E-Mail Functionality
  15. Configuration Of VFIDO To Add Conference Functionality
  16. Configuration Of VFIDO To Add Interface To FrontDoor
  17. Creation Of A Fido Network List For Use By VBBS
  18. Summary Of VFIDO Command Syntax
  19. Technical Information
  20. Development History
  21.  
  22.  
  23. Introduction
  24. ============
  25.  
  26. This program is designed to create an interface between the VBBS
  27. software written by Roland De Graaf and any Fido-compatible
  28. network. FidoNET itself is the largest hobbyist network in the
  29. world, with over 14,000 BBS as members, and there are literally
  30. thousands of smaller Fido-compatible networks worldwide.
  31.  
  32. This version of the interface program allows the exchange of
  33. private mail and public message areas between VBBS and Fido. It
  34. no longer requires the use of FrontDoor to handle the calls to and
  35. from other Fido BBS, although you can continue to use FrontDoor if
  36. you so desire.
  37.  
  38.  
  39. Initial Configuration Of VFIDO To Give E-Mail Functionality
  40. ===========================================================
  41.  
  42. Place the VFIDO.EXE program in your VBBS directory.
  43.  
  44. Run VCONFIG.EXE, and select Network Configuration for the Fido
  45. (type 4) network you are configuring.
  46.  
  47. 1. Fido Address:       2:440/211
  48.     Your Fido network primary address in Zone:Net/Node.Point format)
  49. 2. NetMail Directory:  C:\VBBS\NETMAIL
  50.     Where Fido netmail will be stored - must be the same for all your
  51.     Fido networks
  52. 3. OutBound Directory: C:\VBBS\OUTBOUND
  53.     Where Fido EchoMail will be stored - must be the same for all your
  54.     Fido networks
  55. 4. Archiver:           PAK
  56.     Compression method for outgoing EchoMail - PAK, LHA, ZIP, ARJ
  57. 5. UnArchiver:         PAK
  58.     Compression method for incoming EchoMail - PAK, LHA, ZIP, ARJ
  59. 6. FIDO Front-End:     Standalone
  60.     Standalone or FrontDoor are only valid options at this stage
  61. 7. Nodelist Name:      NODELIST
  62.     The name of the nodelist for the network
  63. 8. Zones:              1-7
  64.     The range of Zones that belong to that network (ie the Domain)
  65.  
  66. D. Dial List
  67.     1. System Address:         2:440/59
  68.         Fido address of node to call
  69.     2. Phone Number:           0689-824890
  70.         Full phone number to dial
  71.     3. Poll Priority:          Hold
  72.         Hold means never call, Priority is call as soon as mail is
  73.         waiting, once a day is the final option
  74.     4. Preferred Session Type: EMSI (FSC-0056) w/Zmodem (DSZ)
  75.         EMSI or TSYNCH handshaking selection
  76.     5. Session Password:       FRED
  77.         The password to use in the EMSI session with the other BBS,
  78.         which may be blank
  79.  
  80. R. Routing
  81.     1: 2:440/59 2:440/59
  82.         Fido address of server and routing mask including wildcards. The
  83.         routing logic works top to bottom through this list so you can't
  84.         add anything meaningful after the last line with the *:*/* on it.
  85.     2: 1:1/1 1:*/*
  86.     3: 2:440/6 *:*/*
  87.    A)dd Lines E)dit Lines D)elete Empty Lines Q)uit:
  88.  
  89. A. AKAs
  90.     1: 2:440/59.3
  91.         Alternative address for the board - must be same Zone
  92.     2: 2:440/0
  93.    A)dd Lines E)dit Lines D)elete Empty Lines Q)uit:
  94.  
  95. Once this configuration is completed, go to the main VBBS directory
  96. and run:
  97.  
  98. VFIDO /C NETWORKID=#
  99.  
  100. You must rerun this every time you change the above configuration
  101. information.
  102.  
  103. You will also need set up a file containing phone prefix aliases
  104. called VFIDO.FON in your DATA subdirectory. This is used to ensure
  105. that the phone numbers listed in the nodelist are converted to a
  106. format that can be dialed from your BBS. This is used for removing
  107. your country code for national calls and area code for local calls.
  108. VFIDO needs the correct phone numbers listed so it can call any BBS
  109. in the nodelist when Crash Mail, File Attaches or File Requests are
  110. sent.
  111.  
  112. An example of this file for the USA would be:
  113.  
  114. 011-            The prefix for dialing international phone numbers
  115. 1-616-399- 399- Sets up the toll free codes for your area code
  116. 1-616- 1-       Makes all other calls in your area code long distance
  117. 1- 1-           Ensures all US phone numbers are not made international
  118.  
  119. This example would convert a phone number listed as 1-616-399-4818 to
  120. 399-4818, or convert 1-616-772-0482 to 1-772-0482, or 44-689-890937 to
  121. 011-44-689-90937
  122.  
  123. and for Europe:
  124.  
  125. 010-            The prefix for international calls
  126. 44-689-         Strip the country and area code for local calls
  127. 44- 0-          Add a 0 prefix for national calls
  128.  
  129. As an example, the above would convert an international phone number
  130. listed in the nodelist as 1-616-399-4818 to 010-1-616-399-4818, or a
  131. national number in the nodelist as 44-689-890937 to 0-689-890937.
  132.  
  133. Place the unarchived nodelist into the C:\VBBS\NETMAIL directory and
  134. run:
  135.  
  136. VFIDO /A NETWORKID=#
  137.  
  138. You will need to rerun this every time you receive a new NODELIST or
  139. you change the VFIDO.FON.
  140.  
  141.  
  142. Sending E-Mail Using VFIDO
  143. ==========================
  144.  
  145. To send an E-Mail message from VBBS to any Fido-type network, invoke
  146. the E-Mail routine as normal. The User Network Address field should be
  147. completed in the format User Name@Fido Address, so to send E-Mail to me
  148. use Neil J Marshall@2:440/211.
  149.  
  150. If you want to send Crash Mail, that is where the E-Mail is sent
  151. directly to the addressee's BBS, ignoring the routing logic, then
  152. add a " +c" after the addressee's name, so to send Crash Mail to me use
  153. Neil J Marshall +c@2:440/211.
  154.  
  155. In Fido-type networks it is policy that messages with files attached
  156. must go directly to the addressee's BBS and ignore the routing logic,
  157. so if you attach a file to a message it will be held on your board
  158. awaiting a call from the addressee's BBS unless you send it Crash Mail
  159. or the addressee is one of the BBSs in your dialing list that you call.
  160.  
  161.  
  162. File Requests Using VFIDO
  163. =========================
  164.  
  165. If you want to send a File Request to another Fido-type BBS invoke the
  166. e-mail routine as normal. The User Network Address field should be
  167. completed in the format Sysop +f@Fido Address, where the " +f" is the
  168. switch to indicate this is a File Request. The Filename requested is
  169. put in the Title field of the message. All File Requests are sent direct
  170. to the addressee's BBS and ignore routing. If the addressee's BBS is not
  171. one that you have set up in your dialing list, then you must also use
  172. the +c switch to make the File Request a Crash E-Mail. To request the
  173. latest version of VFIDO from me, you would invoke the E-Mail function
  174. and address it to Sysop +f +c@2:440/211, then make the Title of the
  175. message VFIDO.
  176.  
  177. VFIDO also supports incoming File Requests. When a File Request is
  178. received, VFIDO searches each of the File Areas that you have set up in
  179. VCONFIG and sends the file back if it is found. VFIDO also supports
  180. "Magic Names" for File Requests - this is where a pseudonym is
  181. associated with an actual file for ease of access by calling systems.
  182. Magic Names should be set up in the file VFIDO.MAG in your DATA
  183. directory. The format of this file is one entry per line, giving the
  184. "Magic Name" followed by the full path and filename of the file to
  185. associate with the Magic Name, for example
  186.     VBBS C:\VBBS\FILES\SYSOP\VBBS560.ZIP
  187.     FILES C:\VBBS\MASTLIST.TXT
  188.     VFIDO C:\VBBS\FILES\SYSOP\VFIDO560.ZIP
  189. might be some of the most common ones.
  190.  
  191. If you want a "standard letter" sent in response to each file request,
  192. create this letter in a file called FILEREQ.TXT in your TEXT path.
  193. Generally a Fido Sysop should use this to list the Magic Names
  194. applicable to their BBS.
  195.  
  196.  
  197. Configuration Of VFIDO To Add Conference Functionality
  198. ======================================================
  199.  
  200. If you want to access public message areas in Fido, you will
  201. need to know the AREA name that uniquely identifies each Fido
  202. conference. Supposing for example you wished to set up VBBS to
  203. participate in a Fido conference whose AREA name was HARPOON:
  204.  
  205. Run VCONFIG.EXE and select Database Configuration, Message Bases,
  206. the relevant Group and Database. Then select Networks Configuration,
  207. A for add, select the network, and on the line for the Network
  208. Conference Identifier, put the AREA name of the Echomail conference
  209. in the network, then a space, then the Fido address of the EchoMail
  210. server from whom you receive the conference. If you are acting as a
  211. local hub, also add, separated by a space, the Fido addresses of the
  212. nodes to whom you directly circulate the conference. You are currently
  213. limited to 80 characters in VCONFIG although you can manually edit
  214. the file to create longer subscription lists.
  215.  
  216. The line will look like this:
  217.  
  218. Network Conference Identifier: HARPOON 2:440/59 1:2/3 1:3/4
  219.                                ^       ^        ^
  220.                                *       *        *
  221.                                *       *        These are the addresses 
  222.                                *       *        of BBS whom you pass the
  223.                                *       *        conference on to when
  224.                                *       *        you are a local hub
  225.                                *       *
  226.                                *  This is the Fido address of the
  227.                                *  EchoMail server from whom you
  228.                                *  collect the conference
  229.                                *
  230.                    This is the AREA name of the Fido
  231.                    conference
  232.  
  233. After you have set up all your conferences, you must run VCONFIG,
  234. Database Configuration, Compile Network Configuration - and you
  235. will have to rerun this every time you change the network configuration
  236. of a database.
  237.  
  238. With these simple steps taken, every message posted on that
  239. conference will be echoed to Fido, and every message from Fido
  240. on that conference will be fed into VBBS.
  241.  
  242.  
  243. Using AreaFix To Request Conferences
  244. ====================================
  245.  
  246. You can add or remove your BBS to the subscription list for conferences
  247. on other Fido BBS using AreaFix.
  248.  
  249. All you have to do is to send a NetMail to AreaFix at the BBS address
  250. with your AreaFix password as the title (the AreaFix password is agreed
  251. in advance by yourself and the other Sysop) and a content that lists,
  252. line by line, the Area name of a conference, preceded by a - for remove.
  253.  
  254. For example, a message whose content read:
  255.  
  256. VFIDO_SUPPORT
  257. -GAMES_DISCUSSION
  258.  
  259. would add your BBS to the VFIDO_SUPPORT conference and remove it from
  260. the GAMES_DISCUSSION conference.
  261.  
  262. VFIDO supports incoming AreaFix requests as well. However, there is no
  263. facility for implementing an AreaFix password, so the title of the
  264. NetMail can be anything. 
  265.  
  266.  
  267. Summary Of VFIDO Command Syntax
  268. ===============================
  269.  
  270. VFIDO {channel number} {option} NETWORKID=#
  271.  
  272. # is the network identifier as specified in the NET.0 file for
  273. the network you are connecting to.
  274.  
  275. {channel number} is only necessary with /DIAL, /HOST and /POLL options.
  276.  
  277. {option} is one of:
  278.  
  279. /A      Build network list from nodelist
  280. /C      Compile initial Fido information
  281. /DIAL   Make a call to another Fido address, specifying the address
  282.         right after the switch like /DIAL2:440/211
  283. /HOST   Answer an incoming Fido call
  284. /POLL   Call all systems for whom Crash Mail is pending
  285. /U      Scan VBBS mail and toss to Fido
  286. /T      Scan Fido mail and toss to VBBS
  287.  
  288.  
  289. Technical Information
  290. =====================
  291.  
  292. VFIDO creates FTS-0001 packets for NetMail with FSC-0039 extensions for
  293. Zone and Point 4D addressing, FTS-0004 ARCmail packets for EchoMail,
  294. and FTS-0006 WaZOO-format File Requests.
  295.  
  296. Connections can be using FTS-0001 (TSynch) using XMODEM or
  297. FSC-0056 (EMSI) using ZModem.
  298.  
  299. Outgoing Crash Mail to addresses not listed in the dialing list is only
  300. supported using EMSI.
  301.  
  302.  
  303. Release Notes
  304. =============
  305.  
  306. 5.60.09 Modified EchoMail archive packet naming for points
  307. 5.60.09 Corrected bug in incoming file request handler
  308.  
  309. 5.60.08 NetMail no longer carries a tear and origin line
  310. 5.60.08 Outgoing file requests and crash mail can only be sent by
  311.         the Sysop account
  312. 5.60.08 Modified EMSI checksum routine to ensure 4 digit checksums
  313. 5.60.08 Removed reliance on DOS DIR command
  314. 5.60.08 Added support for LocalNET slots configured as Fido type
  315. 5.60.08 Modified file request code to support CD ROM drives and to
  316.         ignore wildcard file requests
  317. 5.60.08 Improved analysis of results of a call to ensure sent packets
  318.         are deleted even if the receive fails
  319.  
  320. 5.60.07 Modified incoming mail user name recognition to cope with
  321.         names with the first character missing
  322. 5.60.07 Overhauled the FTS-0001 packet exchange section to get better
  323.         results with Binkley connects
  324.  
  325. 5.60.06 Modified packet creation routine to make the packet show
  326.         the address in the correct network as the origin
  327. 5.60.06 Corrected a bug caused by the switch to 60 byte null
  328.         packets in 5.60.05 which caused outgoing mail to be
  329.         ignored or two bytes out of phase
  330.  
  331. 5.60.05 Modified the /c and /f email switches to +c and +f
  332.         because of conflict with MultiMail function
  333. 5.60.05 Modified null packet length to the correct 60 bytes
  334. 5.60.05 Modified EchoMail processing to detect NetMail containg
  335.         AREA: in the text as NetMail instead of EchoMail
  336. 5.60.05 Introduced a quick return to Waiting For Call where call
  337.         was unsuccessful
  338. 5.60.05 Modified incoming and outgoing call routines to improve
  339.         success rate with VFIDO, FrontDoor and Binkley connects
  340. 5.60.05 VFIDO now remembers the telephone numbers of Crash Mailed
  341.         systems so the nodelist does not need to be searched again
  342.         if further Crash Mail is sent or redials are needed
  343. 5.60.05 Modified routine that processes EMSI caller's address
  344.         information to handle 5D addressing and spurious .0
  345.         point addresses
  346.  
  347. 5.60.04 Modified telephone answering routine to handle incoming
  348.         Binkley 2.56 calls using EMSI or FTS-0001
  349. 5.60.04 Modified incoming file request processor to take account
  350.         of comments and directory names
  351. 5.60.04 Improved the incoming EMSI handshake performance
  352. 5.60.04 Modified the EMSI handshake routine to detect carrier
  353.         dropped right at the start of the handshake
  354. 5.60.04 Modified the routine to detect nodelists in VFIDO /A
  355.         so that it runs a bit faster
  356.  
  357. 5.60.03 Corrected bug in Crash Mail introduced in 5.60.02
  358. 5.60.03 Incoming EchoMail is now forced to appear from the same
  359.         network as it is addressed to, preventing reflection
  360. 5.60.03 Added even more code to remove junk in incoming MSGID,
  361.         REPLY and Origin fields
  362.  
  363. 5.60.02 Corrected bug in receive EMSI handshaking that was
  364.         causing an infinite loop
  365. 5.60.02 Corrected a bug causing a crash if you sent crash mail
  366.         to the same address more than once then made a connect
  367. 5.60.02 Modified incoming mail processor to add a /c to crash
  368.         mail to allow the reply to be sent as crash mail
  369.         automatically
  370. 5.60.02 Changed MSGID, REPLY and * Origin routines to detect
  371.         where Zone is 0 and default the network to FidoNET
  372. 5.60.02 Completely rewrote inbound EchoMail processor to allow
  373.         for situations when the from and to addresses are in
  374.         completely different networks
  375. 5.60.02 Corrected origin network processing for mail whose
  376.         origin line indicates an invalid Zone
  377. 5.60.02 Corrected incoming File Request processing routine
  378. 5.60.02 Suppressed sending of null packets during EMSI session
  379. 5.60.02 Enabled routing to #:#/0 addresses
  380. 5.60.02 Corrected routine that takes modem off hook during
  381.         tossing to use correct COM: port and only activate if
  382.         VCONFIG is set to Idle Modem
  383. 5.60.02 Checks VCONFIG file request flag to see if file areas
  384.         are FREQ'able or not
  385. 5.60.02 Added code to recover from invalid addresses in the 
  386.         REPLY field from other Fido mailers
  387. 5.60.02 Added some strategically placed pauses to allow screen 
  388.         to be read to assist debugging
  389. 5.60.02 Spacebar now aborts the whole redial sequence for a node
  390. 5.60.02 Checks for null packets received during a TSynch session
  391.         to prevent attempting to apck mail for 0:0/0
  392.  
  393. 5.60.01 Modified the /POLL routine to only poll within the
  394.         specified NETWORKID
  395. 5.60.01 Added display of EchoMail From Address during tossing
  396.         to assist correct configuration of EchoMail processor.
  397. 5.60.01 Corrected TSYNCH handshake to cope with empty incoming
  398.         packets
  399. 5.60.01 Corrected the AreaFix message format to follow the Fido
  400.         standard for add requests
  401. 5.60.01 Modified the initial handshake after CONNECT to support
  402.         mailers that generate a single Escape character
  403. 5.60.01 Added code to mask out REPLY lines reading 0:0/0
  404. 5.60.01 Added code to mask out invalid MSGID lines from Xenolink
  405. 5.60.01 Added support for Session Passwords
  406. 5.60.01 Updated processing of Origin information in EchoMail to
  407.         handle invalid formats of the Origin without crashing
  408. 5.60.01 Corrected incoming EchoMail processing logic to handle mail
  409.         from multiple networks simultaneously
  410. 5.60.01 Takes phone off hook during mail tossing
  411. 5.60.01 Modified call to DSZ to handle duplicate incoming file names
  412. 5.60.01 Added abort by spacebar in dialouts
  413. 5.60.01 Added pause between redials
  414. 5.60.01 Corrected processing of nodelists with sub-100 extensions
  415. 5.60.01 Added Carrier Detect functions to detect loss of connection
  416.         in incoming and outgoing calls
  417.  
  418. 5.60.00 Added incoming AreaFix functionality
  419. 5.60.00 Added incoming & outgoing Crash Mail functionality
  420. 5.60.00 Added incoming & outgoing File Attach functionality
  421. 5.60.00 Added incoming & outgoing File Request functionality
  422. 5.60.00 Integrated the FrontDoor telephone handling functionality
  423. 5.60.00 Introduced support for Domains
  424. 5.60.00 Upgraded routing to give unlimited routing flexibility
  425. 5.60.00 Introduced support for Aliases
  426. 5.60.00 Introduced support for simultaneous multiple Fido-type networks
  427. 5.60.00 Reintroduced the PATH statement in EchoMail
  428. 5.60.00 Introduced support for unarchived EchoMail
  429. 5.60.00 Improved the detection of origin information on incoming EchoMail
  430. 5.60.00 Added processing to correct Private EchoMail and Public Netmail
  431. 5.60.00 Added support for To: field in EchoMail
  432. 5.60.00 Upgraded to support VBBS 5.60
  433.  
  434. 5.52.04 Corrected the problem that was preventing messages from Fido being
  435.         gated out to VirtualNET clients and servers
  436. 5.52.04 Improved the detail provided on-screen as messages are being
  437.         processed (to give you something to read as the program chugs
  438.         slowly along!)
  439. 5.52.04 Cured the problem of VFIDO "reflecting" EchoMail back to the
  440.         original sender thereby causing duplicates
  441. 5.52.04 Corrected the display of the From address for incoming EchoMail so
  442.         that it no longer always shows the Server's address
  443. 5.52.04 Removes the AREA and SEEN-BY lines from incoming EchoMail before
  444.         posting it to VBBS
  445. 5.52.04 Introduced an automatic word-wrap on incoming messages to cater for
  446.         those annoying Fido mailers that fail to word-wrap their messages as
  447.         they are entered
  448.  
  449. 5.52.03 Corrected another bug in the usa of LHA for archiving
  450.  
  451. 5.52.02 Corrected a bug that was making the VBBS mail tosser skip messages
  452.  
  453. 5.52.01 Corrected the use of LHA as an archiving and unarchiving protocol
  454.         since it was making VFIDO crash
  455.  
  456. 5.52.00 Completely rewrote echomail handling for multiple clients (the
  457.         last version was my first attempt and was not too good!)
  458. 5.52.00 Added recognition of soft carriage returns in message text
  459. 5.52.00 Corrected SEEN-BY line on echomail to show NET/NODE only
  460. 5.52.00 Forced e-mail to use real name
  461. 5.52.00 Corrected FLAGS for file-attached archived message packets
  462. 5.52.00 Corrected expected name of NODELIST files
  463. 5.52.00 Added a VFIDO.LOG file that records file access attempts to help
  464.         debug obscure file problems
  465.  
  466. 5.51.00 Added support for VBBS 5.51
  467.  
  468. 5.50.06 Added support for multiple servers and multiple EchoMail clients
  469.         (this was a MAJOR job, let me tell you!)
  470. 5.50.06 Corrected bug causing crashes if subdirectories under NETMAIL
  471. 5.50.06 Fixed crash caused by blank lines in NET.0
  472. 5.50.06 Fixed crash caused by archived NODELIST in VFIDO /A
  473.  
  474. 5.50.05 Fixed ARCmail file attach message bug
  475. 5.50.05 Fixed INTL addressing bug
  476.  
  477. 5.50.04 Fixed horrendous bug in the 5.50.03 EchoMail processor
  478.  
  479. 5.50.03 Rewrite of mail processor to handle large messages
  480.  
  481. 5.50.02 Fido mail addressed to SysOp is routed to #1 account
  482. 5.50.02 Origin line now has only 1 leading space
  483. 5.50.02 SEEN-BY and PATH now in correct order on Conference mail
  484.  
  485. 5.50.01 Failure to toss Fido Conference mail to VBBS message areas
  486.  
  487. 2.2     Fixed bug in showing Fido node in VBBS
  488.  
  489. 2.1     Fixed bug in Fido echomail to VBBS conversion
  490.  
  491. 2.0     First Public Release
  492.  
  493. 1.5     Beta
  494.  
  495. 1.4     Beta
  496.  
  497. 1.3     Beta
  498.  
  499. 1.2     Beta
  500.  
  501. 1.1     Beta
  502.  
  503. 1.0     Beta
  504.