home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / PBUTI220.ZIP / PBUTI220.DOC < prev    next >
Encoding:
Text File  |  1993-07-12  |  10.6 KB  |  255 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                      Powerboard UTI Driver Package
  10.  
  11.                               Version 2.20
  12.  
  13.                        (C) 1992-93 by Scott W. Brown
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. What is it?
  31. -----------
  32.  
  33. UTI stands for Universal Text Interface.  The UTI is a standard, set forth
  34. by Kip Compton, to allow interface with mail software that he has written
  35. and will write in the future.  To date, these mail software packages
  36. include PCRelay, Postlink and Megamail.  PCRelay is the first BBS message
  37. networking software that Kip wrote.  Postlink is the second.  Megamail is
  38. a mail door that you can set up for your BBS to allow users to download
  39. mail and read it offline, using the Megamail Mail Reader, then upload
  40. replies back to the Megamail Door.
  41.  
  42. PCRelay is currently being used as mail software on many message networks,
  43. including Intelec, Access, and many more.  PCRelay has been the faveorite
  44. mail networking software of hobbyist Sysops for setting up small to medium
  45. sized networks in the past few years.
  46.  
  47. Postlink, the newer package, provides more features than PCRelay.  Postlink
  48. will handle more mail, higher message numbers, works more efficiently and
  49. accurately, handles communications internally, and much more.  Postlink is
  50. now being used by the RIME (Relaynet International Message Exchange) mail
  51. network.
  52.  
  53. If you are interested in any of Kip Compton's software packages, you can
  54. purchase or get more information from Dr. Bonnie Anthony, who can be reached
  55. at her BBS: 301-229-5623 or Voice: 301-229-7244.  She accepts credit card and
  56. mail orders.
  57.  
  58. Kip Compton is currently attending the MIT University, and can be reached
  59. directly at his BBS: 617-494-1366.  He does not process orders himself, but
  60. he can provide you with information on these products.
  61.  
  62.  
  63.  
  64. What are the executable files included?
  65. ---------------------------------------
  66.  
  67. A UTI driver package is made up of 7 executable files, plus the configuration
  68. program.  These programs are:
  69.  
  70.   UTIHIGH.EXE      Reports to the mail software the high message number
  71.                    for a specified message conference.
  72.  
  73.   UTIVER.EXE       Reports to the mail software the current version
  74.                    information for the UTI driver package.  You can
  75.                    use this program for your own information, by typing
  76.                      UTIVER CON  [ENTER]
  77.                    and the version information will appear on your
  78.                    screen.
  79.  
  80.   UTIIMPRT.EXE     Allows the mail software to import, or toss, mail
  81.                    into the Powerboard message database.
  82.  
  83.   UTIEXPRT.EXE     Allows the mail software to retreive mail from the
  84.                    Powerboard message database.
  85.  
  86.   UTILIST.EXE      Provides the mail software with a list of UTI
  87.                    conferences, configured by the Sysop with the
  88.                    UTICFG.EXE (UTI Configurator) program.
  89.  
  90.   UTILSTRD.EXE     Allows the mail software to find out what the
  91.                    last read message is for any BBS user.
  92.  
  93.   UTIDOOR.EXE      Allows for a UTI door to interface with Powerboard.
  94.  
  95.   UTICFG.EXE       UTI Configuration Program.
  96.  
  97.  
  98. How do I set up the UTI driver package?
  99. ---------------------------------------
  100.  
  101. Setup for PBUTI 2.20 is not complicated at all.  The first step, though,
  102. is to install the mail software that you are going to be working with.
  103. However, do not configure the mail software (i.e. run the Tmanage program
  104. for Postlink, or the Setup program for PCRelay). PBUTI is a revision 2
  105. UTI driver package.  You will most likely need to know this for mail
  106. software setup.
  107.  
  108. If you are setting up a mail network, you will need to add what are called
  109. Network conferences.  What you should do is make up a list of the
  110. conferences that you want to add to your system.  Then go into the AreaCfg
  111. program that comes with Powerboard and add those areas.  Make sure that
  112. the areas support Netmail (have the Netmail flag enabled) and allow public
  113. mail.  After you have added all of the conferences that you want to add,
  114. run Powerboard with the "/C" command line paramater:
  115.  
  116.         PBOARD /C  [ENTER]
  117.  
  118. Or with the multinode version:
  119.  
  120.         PBOARD /N1 /C  [ENTER]
  121.  
  122. This should create the physical message databases for the conferences you
  123. just set up (Powerboard will actually say, "Creating Message Area xxx", at
  124. load-up).
  125.  
  126. Next, copy all of the files included with the UTI driver package into the
  127. mail software directory (e.g. c:\postlink, c:\pcrelay, c:\megamail, etc).
  128.  
  129.         CD \POSTLINK  [ENTER]
  130.         COPY C:\UTI\*.*  [ENTER]
  131.  
  132. If your mail software is located on the same drive with your \AUTOEXEC.BAT
  133. file, you won't need to modify anything yourself.  If not, you will need to
  134. modify your \AUTOEXEC.BAT file and add a line at the top of the file that
  135. says:
  136.  
  137.         SET BBSPATH=C:\PB
  138.  
  139. Where C:\PB is your BBS path.  If your BBS is not located there, substitute
  140. "C:\PB" for the correct path, eg. "D:\BBS".
  141.  
  142. Now that you have PB-UTI installed in your mail software's directory, you
  143. will need to configure PB-UTI.  To do this, you will need to load the PB-UTI
  144. Configurator (UTICFG.EXE).  To run UTICFG:
  145.  
  146.         UTICFG  [ENTER]
  147.  
  148. When you load UTICFG for the first time, it will ask you for the full path
  149. to your BBS.  Enter the drive letter, a colon, plus the path for your BBS.
  150. eg. if your BBS directory is called PB and is located on your C: hard disk,
  151. you would enter:
  152.  
  153.         C:\PB  [ENTER]
  154.  
  155. Next, UTICFG will ask you for the path to your mail software.  If you're
  156. using Postlink, this might be:
  157.  
  158.         C:\POSTLINK  [ENTER]
  159.  
  160. Now you should be presented with a list of conferences on your BBS.  If you
  161. do not see this list on your screen, something went wrong; You will need to
  162. exit UTICFG and try again.  UTICFG stores defaults in a file called
  163. UTICFG.INI.  Delete this file if you would like to start over. 
  164.  
  165. If you do see the list, you are doing well!  You can now begin to copy
  166. conferences over from your BBS to the UTI.  To do this, select the
  167. conference you would like to copy over with the arrow keys, and press your
  168. [F2] key.  UTICFG will now ask you for the UTI conference number that this
  169. should be.  If you are _NOT_ running netmail software, this will most likely
  170. be the BBS' conference number (check mail software documentation).  If you
  171. _ARE_ running netmail software, this will be the network conference number.
  172. When you join a mail network, you are provided with a list of conference
  173. names, short names and conference numbers.  At this point, enter the
  174. network conference number.  You will then be asked for the Powerboard
  175. conference number.  You should leave this setting at what it is (unless
  176. your mail software SPECIFICALLY says otherwise).  The next option will be
  177. the Conference Name.  Again, if you are using netmail software, refer to the
  178. list of network conferences that you are provided with.  Enter the long
  179. (descriptive) name for the conference.  Next you will be prompted for the
  180. Short name.  If you are using netmail software, use the Short Name specified
  181. on the list.  When you are done changing your options and are satisified with
  182. the results, press [ENTER] then [ESC] to save and exit.
  183.  
  184. Repeat this process for each conference that you would like to copy over
  185. to UTI.
  186.  
  187. Next, go back into your Mail Software's configuration program and tell it to
  188. update conference settings from the BBS.  You can now edit your conferences
  189. with the mail software and make sure all settings are correct.
  190.  
  191.  
  192. How do I get up and running with network mail?
  193. ----------------------------------------------
  194.  
  195. After you have installed your mail software, you are more than halfway there.
  196. You will need to join a message network.  Dr. Bonnie Anthony, who sells the
  197. Postlink and PCRelay software, is also the CEO of the RIME message network.
  198. She can get you started with RIME for $30 per year.  You should be aware
  199. that there are message networks that are free of charge, but in many cases,
  200. they are not as large or as well run as RIME.  RIME has dedicated conference
  201. hosts for each one of their conferences.  That is not to say that there
  202. aren't any well-run free networks.  Choose the message network that you feel
  203. is best for you and your BBS.
  204.  
  205. After you have joined a network, you will have to find out who your mail hub
  206. will be.  Your mail hub is a BBS that your BBS will call automatically to do
  207. mail transfers.  But you need to know who your mail hub is, and they need to
  208. know who you are.  You will usually connect with the mail hub that is closest
  209. to you.  Contact the Sysop of your mail hub BBS.  Tell him/her that you would
  210. like to connect to them for network mail.  They will need to know your
  211. Postlink ID (you receive this when you purchase Postlink) and your Node ID
  212. (you receive this when you join the network).
  213.  
  214. A mail transfer is acheived by having a communications program automatically
  215. dial out to the hub site, log on as you, and load the Postlink or PCRelay mail
  216. door.  This would be the same thing as if a user logged on to your BBS and
  217. loaded a door program, but this process is done automatically so that you don't
  218. have to be present for the transfer to work.
  219.  
  220. If you are using PCRelay, you will _have_ to use an external communications
  221. program, such as Telix, Telemate or Qmodem.  Bob Browne, currently a member
  222. of the RIME network and a mail hub for the Intelec network, wrote a script
  223. file for Qmodem that will let your system call out using Qmodem
  224. automatically to do the mail transfer.  The current .Zip file for this
  225. script is called Q4RLY43.ZIP.  It is available on many BBS', and Bob's
  226. BBS: SOS, 914-576-6139.
  227.  
  228. If you are using Postlink, you can use it's internal communications program,
  229. or use an external one as with PCRelay.
  230.  
  231. Next, you will need to set up a batch file that will be run for your netmail
  232. transfers.  The purpose of this batch file is to:
  233.  
  234.         1: Run the mail software so that the mail software
  235.            can prepare mail that needs to be sent out to
  236.            your mail hub.
  237.  
  238.         2: Call your mail hub.
  239.  
  240.         3: Run the mail software again to bring in new
  241.            received from your hub.
  242.  
  243. Included with this UTI driver package are batch files for your mail
  244. software.  PCRMAIL.BAT is to be used with PCRELAY and PL.BAT should be
  245. used with Postlink. 
  246.  
  247. The final step is to tell Powerboard to exit and start your mail run.
  248. To do this, you will need to modify your events setup using EVCONFIG.
  249. For more information on using EVCONFIG, consult the Powerboard BBS
  250. manual.
  251.  
  252. For further assistance with installing your mail software, please
  253. read the included documentation that you will find with Postlink
  254. or PCRelay.
  255.