home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / telix / turb_bbs.arc / TURBOBBS.DOC < prev    next >
Encoding:
Text File  |  1989-06-18  |  16.7 KB  |  365 lines
  1. TurboBBS v1.00
  2. ==============
  3.  
  4. TurboBBS is in actual fact the latest version of MiniBBS.  We decided to change
  5. the name to TurboBBS, because it has many new features.  We also changed the
  6. name, as this revision was so great, that we decided a new start was in order.
  7.  
  8. TurboBBS is a extremely modified version of host which written by the author
  9. of Telix.  TurboBBS also took some commands from Buzz Host Deluxe.  I believe
  10. that the user definable passwords was not written by Roger, they were written
  11. by the author of host2.  This program was modified by Jonathan Rapoport,
  12. and Matthew Stein.  It is an excellent program to use when your BBS is down,
  13. or you want to communicate with someone easily over the modem.
  14.  
  15. Jonathan Rapoport and Matthew Stein of TurboBBS, and  Colin Sampaleanu of
  16. Telix and Exis Inc. assume no responsibility for the use of this program, and
  17. issue no warranty.  They are not liable for any damages, as a result of the
  18. use of this program.
  19.  
  20. TurboBBS requires that you use TELIX v3.00, and greater.
  21.  
  22. ------------------------------------------------------------------------------
  23.  
  24. TurboBBS was designed, created, and tested on a Lanpar PC Xt compatible, with
  25. 10mhz, and a 1200bps modem and a Sperry PC AT with 8mhz.  Is has been known
  26. to work on most other IBM compatibles, but may not work on others.  If you
  27. have a problem, please leave me a message in the TurboBBS echo area on most
  28. BBS's.
  29.  
  30. To install TurboBBS, you must place all of the files with the extension .SLC
  31. in your script directory from Telix, configured by pressing Alt-O, then
  32. choosing Filenames and Paths.
  33.  
  34. To load this program and run it. First load Telix, then press ALT-G and type
  35. in TURBOBBS then press ENTER, or type in from DOS   TELIX STURBOBBS, then press
  36. ENTER.  n.b. Make sure that there is an s before TURBOBBS, and no spaces.
  37.  
  38. To configure TurboBBS,  you can use the same method as above, but instead of
  39. typing TurboBBS, type TCONFIG.  This should be done first, as the program will
  40. not work properly if the directories do not exist.
  41.  
  42. Please note:  In the configuration program, it prompts you for the path to the
  43.               text files!  This option can be entered, but it is not yet
  44.               implemented fully into TurboBBS, and is still being tested.  I
  45.               hope soon to finish that part!  (Anyone know how?)
  46.  
  47. ------------------------------------------------------------------------------
  48.  
  49. Here are all the files that you can create to make your BBS look nicer, but
  50. that are not necessary.
  51.  
  52. APPLY.MSG    - The file that is displayed when the user A)pplys for access
  53. FIRST.MSG    - The file displayed before asking for user name
  54. BYEBYE.MSG   - File displayed when the user logs off.
  55. BULLETIN.MSG - Bulletin listing.
  56. NEWUSER.MSG  - New user information file.
  57. HELP.MSG     - The file that is called, when the user needs ?Help!
  58. PROTOCOL.MSG - This file is the protocol menu.
  59.  
  60. Here are some of the files that are required to run TurboBBS.  CAUTION - These 
  61. files are necessitating to the program.
  62.  
  63. MENU1.MSG &  - THIS IS THE MAIN MENU. comes with TurboBBS, but can be changed.
  64. MENU2.MSG      If this file does not exist, TurboBBS will work.  All the
  65.                user will see is the line that says "command :  ," and not his 
  66.            options.
  67.  
  68.  
  69. All of above files MUST be the directory in which Telix is run from, otherwise
  70. they will not be displayed.
  71.  
  72. ------------------------------------------------------------------------------
  73.  
  74. Two Batch files needed.
  75.  
  76. ONLINE.BAT  - The file that is called when a user with level 2, or 3 calls the
  77.               online program.  This is your online utility, and will run most
  78.               online programs.  It will also run most online programs that are
  79.               made for Wynn Wagners Opus {tm}, as it makes a Lastuser.Bbs file
  80.               that áis similar.  Please note:  If you do not add gateway (the
  81.               .SYS file by Hans D. Kellner) to this file, when you are in
  82.               local mode, you will see it, but when a user is on only he will
  83.               see it.
  84.  
  85. ONLINE2.BAT - This file is called when the SysOp process the function key that
  86.               edits the user log.  Contains information to tell your editor
  87.               what to do. (Set up for Qedit).
  88.  
  89.  
  90.     NOTE - these files should be in the same directory as the display files.
  91.  
  92. ------------------------------------------------------------------------------
  93.  
  94. What goes on, when a regular caller calls TurboBBS.
  95.  
  96. First TurboBBS displays the file First.Msg, then asks the user his/her name,
  97. and password.  After that is entered, the file Bulletin.Msg is displayed to
  98. the caller.  After the bulletin, the menu is shown, and TurboBBS waits for
  99. input from the caller once again.
  100.  
  101. Here is what the main menu, for regular callers looks like:
  102.  
  103.  
  104.        ╒═╡ TurboBBS v1.00 ╞═════════════════════╡ Press '?' for Help! ╞═╕
  105.        │                                                                │
  106.        │                       │                      │                 │
  107.        │ (T)ype any file       │ (Y)ell for SysOp     │ (V)ersion       │
  108.        │ (F)iles avaliable     │ (C)omment to SysOp   │ (B)ulletin      │
  109.        │ (U)pload (send file)  │ (A)pply for access   │ (S)tatistics    │
  110.        │ (D)ownload (receive)  │ (*) Return to Opus   │ (I)nit welcome  │
  111.        │                       │                      │                 │
  112.        │───────────────────────│──────────────────────│─────────────────│
  113.        │                       │                      │                 │
  114.        │ (R)ead general mail   │ (G)oodbye (Log Off)  │ (E)nter message │
  115.        │                       │                      │                 │
  116.        ╘════════════════════════════════════════════════════════════════╛
  117.  
  118. The menu may be changed by the SysOp, with a simple text editor, by editing
  119. the file called Menu1.Msg.
  120.  
  121.  
  122. Here is a brief description of the commands available to you:
  123.  
  124.  
  125. T)ype any file    - This option displays the contents of a text file over the
  126.                     modem.  If the user has access level 1, then he/she may
  127.                     only view files from the download directory, if they have
  128.                     level 2, and up, they can view files anywhere on your disk.
  129.  
  130. F)iles available  - This option shows the Dos directory of the download area.
  131.                     If the user has access level 2, and above, he/she may
  132.                     tell TurboBBS to display a different area.
  133.  
  134. U)pload a file    - This option first asks the user what protocol they want,
  135.                     then tells the user to start sending the file.  Files
  136.                     that are uploaded, will be put in the upload area that
  137.                     you configured TurboBBS to use, when you ran TCONFIG.
  138.  
  139. D)ownload a file  - This option is similar to upload, but the user receives
  140.                     files instead.  A caller, with the security level of 2,
  141.                     and above may download a file from any subdirectory on
  142.                     your hard disk.  A caller with level 1, may only download
  143.                     files in your Download area that you configured.
  144.  
  145. Y)ell at SysOp    - This is available to anyone.  When the user does this
  146.                     option, bells ring on the local end, and the remote.
  147.                     To answer the page, press the space bar.
  148.  
  149. C)omment to SysOp - This option allows a user to enter you a comment.  comments
  150.                     are put in with the log information, in the file TurboBBS.
  151.                     Log.
  152.  
  153. A)pply for access - This option is an excellent one for your security purposes.
  154.                     Apply asks for the users telephone number etc.  Data that
  155.                     is entered here, are stored in a file called Newusers.Txt.
  156.  
  157. *)Return to Opus  - This feature is a real pain, if you don't have it
  158.                     installed properly.  This feature exits Telix, and drops
  159.                     with an errorlevel of 5.  To disable this feature, make a
  160.                     batch file that loads telix, and TurboBBS, and tells
  161.                     it not to initialize the modem.  Then if errorlevel 5 is
  162.                     dropped, either load another online program, or go to loop,
  163.                     and load TurboBBS again.  This command may not be released
  164.                     with TurboBBS, because if the batch file is not used and set
  165.                     up properly, then if a user selects this option, your system
  166.                     will jump to dos, and stay there.
  167.  
  168.  
  169. V)ersion info.    - This is where I advertise for TurboBBS.
  170.  
  171. B)ulletin         - When the user selects this, the file called Bulletin.Msg
  172.                     is redisplayed.
  173.  
  174. S)tatistics       - This will show the caller his/her name, and security level.
  175.  
  176. I)nitial welcome  - This will show the caller the file called First.Msg again.
  177.  
  178. G)oodbye Log Off  - This will hang up on the user, but first display the file
  179.                     ByeBye.Msg.
  180.  
  181. R)ead gen. mail   - This option will display all public messages to the
  182.                     caller, Saying who the message was from, who it's to, and
  183.                     the subject.
  184.  
  185. E)nter a message  - This allows a user to enter a public message to any user.
  186.  
  187.  
  188. ------------------------------------------------------------------------------
  189.  
  190. What goes on, when a new user logs on.
  191.  
  192. When a user calls for the first time, TurboBBS will know that he/she has
  193. never called the system before, as the users name in not listed in the user
  194. file.
  195.  
  196. TurboBBS will tell the user that, and ask him/her if they would like to
  197. register.  If they type N, for no, TurboBBS will hang up on them.  If they
  198. type Y, then TurboBBS will ask for the password they wish to use, and then
  199. display the file Newuser.Msg.  This file should tell the user that he/she
  200. should A)pply for access at the main menu.  After this, the user may look
  201. around, but the security level that he/she has won't let the user hurt the
  202. system.
  203.  
  204. ------------------------------------------------------------------------------
  205.  
  206. Local SysOp functions:
  207.  
  208. In MiniBBS we had a little bar that is displayed under the menu.  This bar was
  209. only seen on the local monitor.
  210.  
  211. Now TurboBBS has the same functions and a few others.  When a caller is on, or
  212. when you are in local mode, you can view your local options at any time by
  213. pressing the [HOME] key.  The options are no longer displayed under the main
  214. menu.
  215.  
  216. And the local functions are only available to the person on the local side of
  217. the computer.  
  218.  
  219. here is what the menu looks like;
  220.  
  221.          ╒═╡ Local commands ╞════════════════════════════════╕
  222.          │                                                   │
  223.          │ F1: To chat with user    │ F2: To jump to D.O.S.  │
  224.          │ F3: To use DOS functions │ F4: To edit user log   │
  225.          │ F5: To hang up on user   │ F6: To return to Telix │
  226.          │                                                   │
  227.          ├───────────────────────────────────────────────────┤
  228.          │                                                   │
  229.          │  To change users access level, hold down the ALT  │
  230.          │  key, and press the security level you wish the   │
  231.          │  user to have!   ie.  ALT-1 for security level 1. │
  232.          │                                                   │
  233.          ╘═══════════════════════════════════════════════════╛
  234.  
  235. Here is a description of actions that take place when the certain key is
  236. pressed.
  237.  
  238. F1:  Tells the caller that the SysOp is now here, and goes into the chat mode.
  239.  
  240. F2:  Tells the caller that the SysOp has jumped to dos, and the SysOp (local
  241.      end) drops to dos.  (Press EXIT to return to TurboBBS!)
  242.  
  243. F3:  Tells the caller that the SysOp is using DOS functions, and puts the local
  244.      end into Telix's Dos function menu.
  245.  
  246. F4:  Loads the user log editor Turbo-1 (Written by James Rosenzweig)
  247.  
  248. F5:  Hangs up on the caller for this call only.  It does not terminate their
  249.      access.
  250.  
  251. F6:  Exits TurboBBS, and returns to Telix.
  252.  
  253. ALT-1:  Gives the current caller access level 1 for this call only.
  254. ALT-2:  Same as above, but gives the caller access level 2.
  255. ALT-3:  Same as above, but gives the caller access level 3. (SysOp access)
  256.  
  257. ------------------------------------------------------------------------------
  258.  
  259. TurboBBS's user log:
  260.  
  261.         TurboBBS now has a user log called TURBOBBS.USR.  To edit the file,
  262.         use a text editor, or use James Rosenzweig's Turbo-1 user editor.
  263.  
  264.         Here is the format of the user file.
  265.  
  266.         name;password;security_level comment
  267.  
  268.           'name' - The user's name. It must be at least five characters long.
  269.       'password' - The user's personal password, that he/she entered.
  270. 'security_level' - This is a one-digit field, with three values(1-2).
  271.  
  272. Here are the values:
  273.  
  274.                1 - This is the level given to first-time callers by TurboBBS.
  275.                    The caller has access to all general functions, but his/her
  276.                    restrictions are that he may only view, type, and download
  277.                    files from the specified download directory, and he/she may
  278.                    not use the Online program.
  279.  
  280.                2 - The user has access to the general functions and may view,
  281.                    type, and download files in any directory on the drive. He/
  282.                    she may also use the Opus {tm} compatible Online program.
  283.  
  284.                3 - This level is similar to the level 2 access, but the user
  285.                    may also shell to dos, shut down the BBS, read the usage
  286.                    log.  This level should be only given to people you trust,
  287.                    as otherwise, they may ruin your system.
  288.  
  289.  
  290.        'comment' - This can be anything you like it to be. Here, TurboBBS
  291.                    notes the date of the user's first logon.
  292.  
  293.         Note: upper and lowercase do not matter with these parameters.
  294.  
  295. ------------------------------------------------------------------------------
  296.  
  297.  
  298. A reminder, Jonathan Rapoport, Matthew Stein, The author of Telix, and
  299. EXIS inc. assume no responsibility towards this program.
  300.  
  301. This reminder is put here due to wide recommendation by the author of Telix.
  302.  
  303. TurboBBS is very safe to use, but comes with no warranty whatsoever.
  304. There is no added commands that only I know.  So you don't need to worry,
  305. I'm a honest person.
  306.  
  307. ------------------------------------------------------------------------------
  308.  
  309. If you have any problems, please read your Telix manual, or leave Matthew Stein,
  310. or Jonathan Rapoport a message in the TurboBBS echo mail area, or send Them a
  311. net mail message at 7:480/504, or 7:480/506.
  312.  
  313. ->Enjoy!<-
  314.  
  315. ------------------------------------------------------------------------------
  316.  
  317. Special thanks goes to:
  318.  
  319. Mike Carr     - The SysOp of the Avaition BBS!  He is my netmail host, and
  320.                 is the main distributor of TurboBBS, and it's echo area.
  321.  
  322. Iain Grant    - The SysOp of But n' Ben!  he convinced me to keep writing it.
  323.                 He also hosts the TurboBBS echo area.
  324.  
  325. Roger Harkavy - The author of Buzzhost Deluxe!  He gave me the inspiration to
  326.                 keep writing, and convinced me to add user-definable passwords.
  327.  
  328. David Paiva   - The SysOp of the Night Club.  He wrote MESSAGE.EXE the program
  329.                 that fix's TurboBBS's message section.
  330.  
  331. Matthew Stein - The author of this much improved documentation.  He also aided
  332.                 in the writing of TurboBBS.
  333.  
  334.  
  335. If you like this program, pass it on to your friends (free of charge).
  336.  
  337. If you have any suggestions, or comments, please leave me a message, on
  338. But 'n Ben (416)297-7101, Or send me a net mail message to 7:480/504,
  339. 7:480/506, or a message in any TurboBBS echo message area.
  340.  
  341. If you would like to receive the area, leave a message to Jonathan Rapoport,
  342. Matthew Stein or Iain Grant. Leave mail in the TurboBBS echo area.
  343.  
  344. Look for updates soon, or write us and we'll send you the latest version.
  345.  
  346. You can get your latest copy from But 'n Ben, Foxwood, Rosat Enterprises,
  347. Totally Board, Regula-1, Canada Remote System's, Rose Media, Eden Foundation,
  348. Aviation BBS, and many other great BBS systems.
  349.  
  350. TurboBBS is free software, however if you send in $7.00 you will receive the
  351. latest update of TurboBBS, and full online support.  Please specify disk size
  352. (5.25 or 3.5).
  353.  
  354. Print the file REGISTER.DOC, (our order form) and send it in with a check or
  355. money order to:
  356.  
  357.                             TurboBBS, TurboSoft.
  358.                             C/O Matthew Stein
  359.                             9 Forest Heights Blvd.
  360.                             Willowdale, Ontario.
  361.                             M2L 1C1
  362.  
  363. ------------------------------------------------------------------------------
  364.  
  365.