home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / main / BBS / TICWIN32.ZIP / SYSOP.DOC < prev    next >
Encoding:
Text File  |  2000-07-06  |  7.2 KB  |  183 lines
  1. TinyTic v0.0.5 beta
  2. Release date: 19 June 2000
  3. Written by Mike Dillon and Sean Dennis
  4. (C) 2000 Mike Dillon and Sean Dennis
  5. All rights reserved.
  6.  
  7. Documentation written by Sean Dennis
  8.  
  9. *** EXTREMELY IMPORTANT ***
  10. READ THE README.NOW FILE!  This file contains changes
  11. that are NOT covered in this documentation.
  12.  
  13. Special notes for certain versions:
  14.  
  15. OS/2 VERSION requires EMX 0.9d to run.
  16.  
  17. LINUX VERSION was compiled using GCC/EGCS-2.91.66
  18.  
  19.  
  20. Legal Stuff
  21. ===========
  22. TinyTIC is not guarenteed to work on your system... there is no warranty, 
  23. expressed or implied, with this program or any of its associated files.  
  24. The only thing we can safely say it will do is take up a wee bit of 
  25. space on your hard drive.  The author, Mike Dillon, nor Sean Dennis 
  26. are responsible for any damage done to your system by improper setup, 
  27. configuration or use of TinyTIC.
  28.  
  29. This program is released as freeware.  This archive may be freely 
  30. distributed, as long as the original archive is unaltered.  No 
  31. charge may be made for the use of TinyTIC.
  32.  
  33. What is TinyTIC?
  34. ================
  35. TinyTIC was written in response for a need for a small, simple TIC
  36. processor that will work with Synchronet BBS software.  This is primarily 
  37. designed for the Synchronet sysop in mind, but can be used with any BBS 
  38. software that will allow importation of text message into its message base 
  39. format, such as Syncrhonet does.
  40.  
  41. The need for this arouse out of having to process TIC files without all the 
  42. bloat that certain TIC processors (namely AllFix) contains.  I didn't need 
  43. all the fancy features and stuff-just something that will move the files to 
  44. the directory that I tell it to and make new files announcements in text 
  45. format... and so TinyTIC was written.
  46.  
  47.  
  48. How does TinyTIC work?
  49. ======================
  50. Basically, after setting up TinyTIC's configuration file, TinyTIC will 
  51. simply look in your mailer's inbound directory for any TIC files.  TinyTIC 
  52. will then look in the TIC files and match the magic name to what it has in 
  53. its configuration file.  If the name exists and has a corresponding 
  54. directory, TinyTIC will move the file into the directory and add it to the 
  55. new files announcement text message.  That's ALL TinyTIC does, nothing 
  56. else.
  57.  
  58. There are three command line options:
  59.  
  60. -c<configfile> : Allows for an alternate config file
  61. -d<configfile> : Allows for alternate datafile location and storage
  62. -l<logfile>    : Allows for alternate logfile location and storage
  63. -h or -?       : Commandline help
  64.  
  65. The example batch file included in the documentation is designed to be used
  66. with a Synchronet BBS.  Synchronet has two utilities, ALLFILES and SMBUTIL,
  67. with it that will allow the adding of files and importing of the text-based
  68. new files announcements into the Synchronet Message Base format (a proprietary 
  69. format).  However, if you are running a BBS software that will import via 
  70. text files into its message base and are using TinyTIC to do that, please 
  71. let us know and we will add your information to this file.
  72.  
  73. How do I set it up for Synchronet?
  74. ==================================
  75. Extremely simple:
  76.  
  77. 1) Put TinyTIC where you want it (I prefer \SBBS\EXEC) along with its    
  78.    configuration file.  If you're going to add headers and footers to the new 
  79.    files announcements, put them in the same directory.
  80.  
  81. 2) Configure TinyTIC's CFG file (TINYTIC.CFG) to your system's needs.
  82.  
  83. 3) Put a call to TinyTIC in where your mailer exits to process mail.  
  84.    I call this batch file from BinkleyTerm (it's called MAILPROC.BAT):
  85.  
  86. <begin batch file>
  87.  
  88. @echo off
  89. cd d:\sbbs\exec
  90.  
  91. rem Process inbound mail
  92. sbbsecho /lesy
  93.  
  94. rem Process TIC files
  95. tinytic
  96.  
  97. rem Adds files to the message base
  98. addfiles * /s /z
  99.  
  100. rem Puts the new files announcements into the message bases
  101.  
  102. rem Put header-announcement-footer together
  103. copy header.txt+newfiles.txt+footer.txt announce.txt
  104.  
  105. rem Place message into message base.  (NOTE: This is
  106. rem all on ONE line-it's been line wrapped for the
  107. rem documentation!)
  108. smbutil id:\sbbs\exec\newfiles.txt d:\sbbs\data\fidoreq.shd < d:\sbbs\exec\fido.hdr
  109.  
  110. rem Process outbound mail (to include file announcements)
  111. sbbsecho /linf
  112.  
  113. <end batch file>
  114.  
  115. ** Make sure that the filearea directories exist and that you have set them up 
  116. in SCFG before you run TinyTIC and call ADDFILES.  It'd be hard for SBBS to 
  117. import files that it doesn't think that exist.
  118.  
  119. Bet you're wondering just what that SMBUTIL line is... :)  Here's the 
  120. breakdown: if you've every used SMBUTIL's "import" function, you know it asks you 
  121. three questions: who the message is from, who it's being sent to and what the 
  122. subject is.  In order to automate the processing of messages, you can make a 
  123. simple text header file to do that.  Here's my FIDO.HDR:
  124.  
  125. Sean Dennis
  126. All File Fanatics
  127. New Files from AfterHours/2 BBS
  128.  
  129. That's it.  Save it in a convienent place.
  130.  
  131. Now, here's the not-so-fun part.  You need to tell SMBUTIL _exactly_ 
  132. which base you want it to post in, so check on your system for the SHD 
  133. file you want to use.
  134.  
  135. (NOTE: SHD is the default compression that Synchronet uses on a Fidonet- 
  136. style message base system.  It's different for the other network types.    
  137. CONSULT YOUR SYNCHRONET DOCUMENTATION!)
  138.  
  139. So, you're asking what's the < for in the command line?  Well, that will 
  140. cause SMBUTIL to read FIDO.HDR to answer the questions it asks, therefore 
  141. forcing SMBUTIL to post just where you want it.
  142.  
  143. It sounds a LOT more difficult than it actually is.  I use the above 
  144. routine to automate my moderator echo rules postings (I'm currently 
  145. the moderator of BBS_CARNIVAL in Fidonet and other echos in other networks) 
  146. and it works like a charm.
  147.  
  148. For Other BBS Sysops
  149. ====================
  150. If you get TinyTIC to work with your BBS software, please let us know?  
  151. Contact me, Sean, via one of the ways below.  If it works well for ya, 
  152. we'll put it in the documentation to help other sysops.
  153.  
  154. Contacting the Authors
  155. ======================
  156. Mike Dillon is really the author of TinyTIC and he put a lot of time into 
  157. developing TinyTIC for me.  He did this for free and would probably 
  158. appreciate it if you dropped him a line to let him know that you appreciate 
  159. his hard work and are enjoying using TinyTIC.  His email address is 
  160. gsvalore@arn.net and his web site is http://members.darktech.org/gsvalore/.
  161.  
  162. Myself... well, I wrote the docs and the batch file for use with the 
  163. Synchronet BBS software.  You can reach me at hausmaus@darktech.org or 
  164. see my web site at http://ah2.darktech.org.
  165.  
  166. You can catch both of us on the BlackNet IRC network at irc.bwcomp.net in 
  167. channel #bbs.  For more information on BlackNet, check out http://blacknet.bwcomp.net
  168.  
  169. Thanks
  170. ======
  171. My personal thanks goes out to Mike for helping me do this.  I couldn't have 
  172. done this without his help!  I'd also like to thank Rob Swindell for rekindling his 
  173. interest in developing Synchronet BBS software for the 21st century.  You can see 
  174. what Sync's all about at http://www.synchro.net.  Of course, the usual crew on 
  175. BlackNet's #bbs for listening and giving ideas!
  176.  
  177. May BBSing live on for our grandchildren's grandchildren! :)
  178.  
  179. Thanks for using TinyTIC,
  180. Sean Dennis and Mike Dillon
  181.  
  182. <EOF>
  183.