home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / INET.ZIP / INET.DOC < prev    next >
Encoding:
Text File  |  1995-11-04  |  9.3 KB  |  216 lines
  1.                        Omega Software Presents
  2.  
  3.                        The Internet Connection!
  4.  
  5.              Easy Fido to Internet interface for ANY BBS!
  6.  
  7.                   Copyright (c) 1994 Mark Williamson
  8.  
  9.   ╓────────────────────────────────────────────────────────────────────╖
  10.   ║ INTRODUCTION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ║
  11.   ╙────────────────────────────────────────────────────────────────────╜
  12.  
  13. This program is a variation of several programs that also transform
  14. fidonet netmail into UUCP style messages to be sent to a fido/internet
  15. gateway.
  16.  
  17. My thanks goes out to Bob Lopinski for giving me the idea for this
  18. program and walking me through the process of writing Internet
  19. messages from RemoteAccess.  Thanks Bob!  Hope this one is a Hit!
  20.  
  21. Until now, sending Internet e-mail through Fidonet systems has been tricky.
  22. The host bbs must have some method of getting around the 35 character TO:
  23. line limitation that is inherent in almost all BBS systems, mailers and the
  24. Fidonet specification.  With the Internet Connection, your TO: line is now
  25. a maximum of 70 characters, plenty of room for even the longest internet
  26. address.  Plus, you don't have to fuss with having to tell the user to
  27. write 'TO: <internet address>' in the first line of the message that is
  28. destined for your UUCP gateway.  Internet Connection takes care of all this
  29. for you, and at the same time giving the impression that the program is
  30. part of your system!
  31.  
  32. The Internet Connection runs from any menu command line, uses an external
  33. editor of your choice, and will write a Fido *.msg addressed to UUCP,
  34. addressed to the destination address you specify in INET.CFG.
  35.  
  36. Previously, to properly format a message to be sent through the Internet,
  37. you had to specify UUCP on the TO line of the message.  You also had to
  38. specify the destination Fido address as that of your Internet gate, or the
  39. system that is transmitting your Internet mail to an Internet host.  After
  40. these two fields were filled in, you had to specify the actual Internet
  41. address on the first line of the message, so the UUCP host could process
  42. the message correctly.  All this is troublesome and clumsy.
  43.  
  44.  -=-=-=-=-=-=-=-=  Make room for the Internet Connection! =-=-=-=-=-=-=-=-
  45.  
  46.   ╓────────────────────────────────────────────────────────────────────╖
  47.   ║ INSTALLATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ║
  48.   ╙────────────────────────────────────────────────────────────────────╜
  49.  
  50. To install, create a directory called INET in your RemoteAccess system
  51. directory.  (You don't have to use RemoteAccess, any BBS will do.)
  52.  
  53. Our example below is from RemoteAccess 2.02.  Follow along even if you
  54. don't use RemoteAccess, and you may see what you need to do for your
  55. particular BBS:
  56.  
  57.  
  58.          1         2         3         4         5
  59. 1234567890123456789012345678901234567890123456789012
  60. Post (I)nternet message                              << Message display line
  61.  
  62. C:\RA\INET\INET.EXE /POST C:\RA\ICE\ICEEDIT.EXE /D:C:\RA *M   << Command Line
  63.  
  64. Action   Execute sub-program (Type 7)
  65. Display
  66. OptData
  67. HotKey   I
  68. AutoExec No
  69. Colour   Colour example
  70.  
  71. MinSec   0                  TimeUsed 0
  72. MaxSec   0                  TimeLeft 0
  73. A flags  --------           Age      0
  74. B flags  --------           MinSpeed 0
  75. C flags  --------           MaxSpeed 0
  76. D flags  --------           Credit   0
  77.  
  78. Notice the command line.  First is the full path and filename of INET.EXE.
  79. The command line switch /POST tells Inet that it is posting a new message.
  80. The full path and filename of your external editor should follow,
  81. specifying any options that your editor requires. The INET.CFG file must
  82. reside in the same path as INET.EXE.
  83.  
  84. NOTE: Some BBS' and editors work differently. Some require the command line
  85. be proceeded by calling command.com first. In RemoteAccess, this is done by
  86.  
  87.      *c /c d:\path\program.exe  (see menu type 7 for more info).
  88.  
  89. Be sure your editor is set to read the drop files of your BBS type. This has 
  90. been tested with many popular external BBS editors, you MUST test this on-
  91. line as well as local to be sure that it's type is set properly.
  92.  
  93.   ╓────────────────────────────────────────────────────────────────────╖
  94.   ║ OPERATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ║
  95.   ╙────────────────────────────────────────────────────────────────────╜
  96.  
  97. Using this setup, when the user wants to write an Internet message,
  98. they will press 'I' from your message menu.  This program will then
  99. load and ask them for the Internet address and the subject (just like
  100. the BBS does).  Then, the external editor will be loaded.  If the user
  101. saves their message (i.e. does not abort it), Inet will reformat the
  102. message and write the Fido style netmail message in your outbound
  103. netmail directory.
  104.  
  105. Notice we didn't mention your tosser?  Your tosser will never come in
  106. contact with these message because Inet posts them directly to your
  107. netmail directory, in the form of a *.MSG file.
  108.  
  109. Inet will uses the following parameters to control its operation:
  110.  
  111.     /POST  Tells Inet that it should post the message, asking for a To: and
  112.            Subj: field.
  113.  
  114.     /SCAN  Tells Inet that it should scan existing netmail messages for an
  115.            Internet style address, (i.e. those with an '@' symbol in the
  116.            To: line) and reformat them into a UUCP style message.
  117.  
  118.    /LOCAL  Specifies that no comm output will take place, and that no door
  119.            files are available.
  120.  
  121. If the /SCAN parameter is used, INET can be run after your net mail is
  122. exported from your BBS message base after a caller posted a message. If an
  123. "@" symbol is found in the TO: field, it is assumed to be an internet
  124. message, and is then reformatted to the UUCP format with the address (to the
  125. gateway), and the flags in the INET.CFG file.
  126.  
  127. The program can also be used in the /POST mode, and called from a menu
  128. option on your BBS. It will say From: (your name), then prompt you for an
  129. Internet address.  Using this method, the 35 character fidonet field limit
  130. is by-passed, and Inet "shells" to the specified editor.  The message is
  131. written directly to your netmail directory, not to your message base. If
  132. the "kill" flag is NOT set in INET.CFG, your message tosser may import the
  133. message to your BBS message database after it is sent.
  134.  
  135. You must remember to specify your desired message editor on the command
  136. line with Inet.
  137.  
  138. Inet has been successfully tested with the following editors:
  139.  
  140.   IceEdit
  141.   TopEd
  142.   RAEdit *
  143.   Gedit *
  144.  
  145. * Although Inet has been tested with RAedit/Gedit, there are some problems
  146. which Chris Patterson will have to fix.  It seems that during the testing
  147. phases, we could not get Gedit to load in remote mode (comm output) unless
  148. the environment variable GEDIT=BBS:DORINFO was set.  It also appears that
  149. RAedit cannot use this environment variable.  Given that each system is
  150. different, you will have to play around with the different options and
  151. editors to find one that you like and one that will work correctly from
  152. Inet.
  153.  
  154.   ╓────────────────────────────────────────────────────────────────────╖
  155.   ║ CONFIGURATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ║
  156.   ╙────────────────────────────────────────────────────────────────────╜
  157.  
  158. Configuration is easy.  Below is a copy of the Inet.cfg file, which is
  159. read upon startup.  The INET.CFG file must reside in the same directory as
  160. the INET.EXE program.
  161.  
  162. ; This is the initialization file for I-Net.  Each line beginning with
  163. ; a space or semi-colon is a comment.
  164. ;
  165.  
  166. ; 'Sysop' is your name
  167.  
  168. Sysop     Mark Williamson
  169.  
  170. ; 'Origin' is your fidonet address
  171.  
  172. Origin    1:202/750
  173.  
  174. ; 'Gate' is the destination, where the UUCP messages are sent.
  175.  
  176. Gate      1:202/701
  177.  
  178. ; 'Outbound' is where your outgoing netmail messages are stored.
  179.  
  180. Outbound  C:\RA\MAIL
  181.  
  182. ; 'Flags' are the attributes to assigned to each message.
  183. ;
  184. ; They can any one of:  Kill Crash Hold Private
  185.  
  186. Flags Crash Private Kill
  187.  
  188.   ╓────────────────────────────────────────────────────────────────────╖
  189.   ║ CUSTOMIZATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ║
  190.   ╙────────────────────────────────────────────────────────────────────╜
  191.  
  192. Included in your INET archive, you will find an INETHELP.ASC and
  193. INETHELP.ASC file.  These are the help screens that are displayed when the
  194. user types in 'HELP' or '?' on the To: field of the message.  These files
  195. will explain the proper format of an Internet address.  You can customize
  196. these files to suite your taste.  They must reside in the same directory as
  197. INET.EXE.
  198.  
  199.   ╓────────────────────────────────────────────────────────────────────╖
  200.   ║ WARRANTY AND REGISTRATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ║
  201.   ╙────────────────────────────────────────────────────────────────────╜
  202.  
  203. Although I'd really like to, I can not guarantee this program will
  204. function on your system.  If you encounter problems or wish to make
  205. suggestions, please feel free to netmail me at my Fido net address below.
  206.  
  207. There is only one requirement for registering the Internet Connection.
  208. Send me netmail telling me if you like the program and find it useful.
  209. Other than that, this program is free.
  210.  
  211.  
  212.                               Mark Williamson
  213.                                Omega Software
  214.                             1:202/750 (Fidonet)
  215.  
  216.