home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMPROG / PFIP.ZIP / FIDO.DOC next >
Encoding:
Text File  |  1993-02-17  |  9.1 KB  |  264 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                  Powerboard Fidonet Interfacing Package
  10.                        (C) 1992 by Scott W. Brown
  11.  
  12.  
  13.                    For use with Powerboard BBS 1.20+
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. Introduction
  32. ------------
  33.  
  34. The Fidonet is the oldest and largest IBM-PC based mail network in the world.
  35. Fidonet provides a means for people to talk to each other via electronic
  36. mail (e-mail) from all over the world.  It is also a non-profit network,
  37. with no central person or corperation to pay dues to.  It is a 100%
  38. volunteer network.  This means that the only reason why the network stays
  39. intact is because of System Operators who put their time and effort into
  40. promoting and supporting Fidonet.  Fidonet also does not have one standard
  41. program for the actual mail transfering and tossing, unlike many other
  42. mail networks.  Instead, Fidonet has a Fidonet Technical Standards Committee
  43. which creates standards to be used on all Fido systems.  The Powerboard
  44. FIdonet Interfacing Package (hereafter refered to as PFIP) is designed
  45. to follow these standards as closely as possible.
  46.  
  47.  
  48.  
  49. Theory of Operation
  50. -------------------
  51.  
  52. PFIP is designed in a modular format, with many different programs (drivers)
  53. that work in concert to provide a means of exporting and importing Fidonet
  54. echomail.  This is done to provide for the many different setups that are
  55. in place on Fidonet systems.
  56.  
  57. For exporting mail, PFIP will first make use of the Powerboard QWK mail
  58. system to toss mail out of the Powerboard message base into QWK format
  59. mail.  Next, a third party utility called P-VERT is used to convert mail
  60. from QWK to the Fidonet QWK format.
  61.  
  62. For use with Frontdoor, it is necessary to inform Frontdoor which mail
  63. packet you would like to send out by placing a message in the Frontdoor
  64. netmail folder.  This is done with a program in the PFIP package
  65. called MSG.
  66.  
  67. For importing mail, the first step is to convert mail to QWK format using
  68. the third party program, P-VERT.  Since P-VERT does not retain correct
  69. conference numbers in this conversion, a program in the PFIP package
  70. known as FIDOIZE will insert the appropriate conference numbers for
  71. each message.  Next, mail is converted from the QWK format to Powerboard
  72. message format with the Powerboard QWK mail system.
  73.  
  74.  
  75. Setup
  76. -----
  77.  
  78. The first step in setup for Fidonet mail on your Powerboard BBS is to
  79. get set up with a front-end mailer door program for your BBS.  Next,
  80. inform your local Fidonet coordinator that you would like to join the
  81. network.  After going through the appropriate procedures, you will
  82. be allowed to download the Fidonet nodelist and compile it for use
  83. with your mailer.
  84.  
  85. Refer to the manual/documentation for your front-end mailer door
  86. (such as Frontdoor, Binkley, Seadog, etc) for how to set up the
  87. front-end mailer properly.
  88.  
  89. You will need to tell your Fido mail hub what conferences you would
  90. like to pick up.  This would also be a good time to find out
  91. what your Fidonet node number is, and what the node number will
  92. be for the site that you will call for Fidonet mail.
  93.  
  94. PFIP should probably be placed in a subdirectory off of your
  95. front-end mailer's directory, such as c:\fd\netmail.
  96.  
  97. Once you have the list of conferences, you can proceed to set up
  98. the PFIP.  You will need to know the EXACT names, their spellings
  99. and any punctuation they have in them.  i.e. "Hello there" is
  100. different from "Hello_there".  When you are sure that you have
  101. the correct information, you can begin by modifying the file in
  102. your PFIP directory called "FIDOCNFS.CFG".  The following is the
  103. format for this file:
  104.  
  105. Fidonet conference number
  106. Conference Name
  107. .
  108. .
  109. .
  110.  
  111. Repeating these two lines (but changing them accordingly for the
  112. appropriate conference) for all of the conferences you will be
  113. carrying on Fidonet.  An example FIDOCNFS.CFG might look like this:
  114.  
  115. 1
  116. SENY_SYSOP
  117. 2
  118. SENYNET
  119.  
  120. If you have 2 conferences, the first being "SENY_SYSOP" and the second
  121. being "SENYNET".
  122.  
  123. Next, you will have to create these conferences in Powerboard.  If
  124. your highest conference number in Powerboard is 10 now, and you're
  125. adding 2 Fidonet conferences, you will need to increase this to 12.  To
  126. do this, load the AREACFG program that comes with Powerboard.  Press
  127. the SPACEBAR to add an area.  Make sure that Netmail is enabled for
  128. the area.  Here are the recommended settings for a Fido netmail area:
  129.  
  130. Private=No
  131. Force_Private=No
  132. Force_Public=Yes
  133. Network=Yes
  134. Ignore_Scan=No
  135. Force_Net=Yes
  136.  
  137. Once you have added the conferences, either take note of the conference
  138. numbers while in AREACFG (pressing ESC on a highlighted area will bring
  139. up File Areas under that area and tell you what the number is for
  140. the message area), or by using the "AL.EXE" or "AL2.EXE" Powerboard
  141. utility programs.
  142.  
  143. The next step is to bring these two things together: Powerboard conferences
  144. and remote Fidonet conferences.  To do this, we use the QWKCFG program.
  145. Once in QWKCFG, you will see the following options:
  146.  
  147.  
  148. (L)ist corresponding conferences, (E)dit corresponding conferences or (Q)uit?
  149.  
  150.  
  151. If this is the first time you are using QWKCFG, do not select "L".  Select
  152. "E" to edit.  After you have made this selection, QWKCFG will ask you
  153. first for the Echo conference number.  This will be the number that we
  154. defined previously in the FIDOCNFS.CFG file.  Next, QWKCFG will ask for
  155. the Powerboard conference number.  This is the conference number in Powerboard
  156. that will be the local base for the echoed conference.  After you have
  157. linked all of your areas together, we can move on.
  158.  
  159. The next step is to modify the file called QWKOUT.CFG.  The following
  160. is the format for the file:
  161.  
  162. 1: 3: This means you have 3 lines of text added to the end of the message.
  163.    If you want none added, make this line "No".  If you want only one
  164.    added, make this "Yes", and if you want two added, make this "2".
  165.  
  166. 2: Tagline text, starting with " * Origin:".  This is a Fidonet standard,
  167.    that all messages start with " * Origin:".
  168.  
  169. 3: SEEN-BY line.  This is needed by some Fido systems... if you don't need
  170.    this, make the first line "Yes" (or "2" if you want a .Path line)
  171.  
  172. 4: .Path line.  This is needed by some Fido systems
  173.  
  174. 5: The name of your BBS.
  175.  
  176. 6: The location (City, State) of your BBS.
  177.  
  178. 7: Your BBS' data phone number.
  179.  
  180. 8: Your first name.
  181.  
  182. 9: The first 8 characters for the filename of the packet to be
  183.    created.  **THIS IS IMPORTANT**  The first 5 characters
  184.    are the HEX difference between your Fidonet local network
  185.    number and the local network number of the site which you
  186.    call for mail.  For example, in the Fidonet node number
  187.    "1:272/37", "272" would be the local network number.  The
  188.    HEX numbering system is a base 16 number system instead of
  189.    our usual base 10 number system.  Numbers go from 0 to F.
  190.    0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F are the numbers in the HEX
  191.    system.  So that the decimal number 20 would be "14" in
  192.    HEX numbers.  And HEX 30 would be "1E" in HEX.  The first
  193.    5 characters are usually "00000" because you will probably
  194.    call a site in your local area (your network).  The next
  195.    3 characters in the filename are the difference in node
  196.    numbers.  In the Fidonet address "1:272/37", "37" would
  197.    be the node number.  So that if my mail hub is at node
  198.    "1:272/55", the filename I use would be "00000012".  The
  199.    HEX difference between 55 and 37 is "12" (18 in decimal).
  200.    If you can not figure out what your filename should be,
  201.    contact your Fidonet coordinator and they should be able
  202.    to help you out.
  203.  
  204. 10:This line should be your full name.
  205.  
  206. 11:This should be the first line from FIDOCNFS.CFG.
  207.  
  208. 12:This should be the second line from FIDOCNFS.CFG.
  209.  
  210. The rest of QWKOUT.CFG should be the rest of FIDOCNFS.CFG.
  211.  
  212.  
  213. The following is an example of the QWKOUT.CFG file:
  214.  
  215. 3
  216.  * Origin: Powerboard HQ BBS ■ Larchmont, NY, USA  914-834-7830 (1:272/37)
  217. SEEN-BY: 272/37
  218. .PATH: 272/37
  219. Powerboard HQ BBS
  220. Larchmont, NY
  221. 914-834-7830
  222. Scott
  223. 00000012
  224. Scott Brown
  225. 1
  226. SENY_SYSOP
  227. 2
  228. SENYNET
  229.  
  230.  
  231. The next file to modify is called MSG.SCR.  This is the script file
  232. for the MSG program that is included in PFIP for creating the
  233. .MSG message file to tell your front-end mailer door to send the mail
  234. packet.
  235.  
  236. The following is the format for the MSG.SCR file:
  237.  
  238. 1: Your name.
  239.  
  240. 2: Name of Sysop of BBS that you will call for Fidonet mail.
  241.  
  242. 3: Name and DOS path for file to be sent.  This should be the
  243.    path to PFIP plus the your site's base filename (discussed on
  244.    line 7 of QWKOUT.CFG description), plus the .PKT extension.
  245.  
  246. 4: Node number for BBS you will call for Fidonet mail (i.e. if the
  247.    node is 1:272/55, just include "55").
  248.  
  249. 5: Node number for your BBS (i.e. if your node is 1:272/37, just
  250.    include "37").
  251.  
  252. 6: How much this transfer will cost (usually 0).
  253.  
  254. 7: The network that you are in (i.e. if your node is 1:272/37, this
  255.    will be "272").
  256.  
  257. 8: The network of the site that you will call for Fidonet mail (i.e. if
  258.    their node is 1:272/55, this would be "272").
  259.  
  260.  
  261. PFIP comes with 3 batch files.  OUT.BAT is used to export mail.  NMAIL.BAT
  262. is used when importing mail.  And FDO.BAT is what we use at Powerboard HQ BBS
  263. for Frontdoor and Powerboard.
  264.