home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / gotcha14 / gotcha.txt < prev    next >
Text File  |  1994-04-05  |  12KB  |  369 lines
  1.         ooooooo   ooooo  oooooo  ooooo   o    o    ooo      oo
  2.        o         o    o    o    o       o    o   o    o    oo
  3.       o   oooo  o    o    o    o       oooooo   oooooo    oo
  4.      o     o   o    o    o    o       o    o   o    o
  5.      ooooo     ooooo    o    oooooo  o    o   o    o    oo
  6.  
  7.                          Written By Paul Seed
  8.  
  9.                          (c)1994 PMT-SOFTWARE
  10.  
  11.                      Support BBS +44(0)772 794633
  12.  
  13.                 PMT-BBS 6pm-9am Weekdays/24hr Weekends
  14.  
  15.          NeST 90:100/109  AtariNet 51:6/9  FidoNet 2:250/155
  16.  
  17.               FishNet 777:400/5    MercuryNet 240:300/17
  18.  
  19.            Supporting Speeds up to v32bis and V42bis/MNP2-5
  20.  
  21.  
  22.  
  23. I have tested GOTCHA! very  thoroughly  but  there  are no doubt a few
  24. bugs in  the  code.  If  you  think  you  have  found  a  bug  in  the
  25. program,please write to me at the address  at  the end of this doc, or
  26. Netmail on any of the above addresses.
  27.  
  28. Gotcha! V1.13 is distributed as  Shareware.  If  you like the program,
  29. and use it regularly, please  register  the software. Registering will
  30. allow you to receive future upgrades of the program, and also you will
  31. receive any utilities and  extras  with  a  personal  ID for your BBS.
  32. Registration of Gotcha! is 5 UKP. Please  read  the info at the end of
  33. the doc for more information.
  34.  
  35. Support for Gotcha! and ant other PMT-Software titles is given to both
  36. registered and unregistered users.
  37.  
  38.  
  39. Disclaimer.
  40. ===========
  41.  
  42. Gotcha! changes data in  your  USERS.BBS  file.  It  also uses several
  43. other files to control the  action  of  the  program. I cannot be held
  44. responsible for any damage done to any files on your HD. I have tested
  45. the program many times  on  my  system,  and  not trashed my USERS.BBS
  46. file. Basically, you use  the  program  at  your  own risk. You should
  47. really back up your USERS.BBS file every couple of days anyway <grin>.
  48.  
  49. This version of  Gotcha!  (Vers.   1.13b)   may  be  distributed  free
  50. of charge, as long as you keep the following files in the archive...
  51.  
  52.  
  53. Future releases of Gotcha! may include :
  54.  
  55. o The ability to ask  the  user  for  a  reason  to why he/she dropped
  56. carrier at logon...
  57.  
  58. o Creation of a text file with Bad Logoffs etc for each user/day etc.
  59.  
  60. o Creation of a text file for  users  to view with names of people who
  61. have dropped carrier too many times.
  62.  
  63. o Unlimited  actions  instead  of  one  delete  flag  ,one message,one
  64. security and one set flag.
  65.  
  66.  
  67. o Full GEM Config and Editor program.
  68.  
  69. o Exclusion list to stop people having modem trouble/new users keep
  70.   getting demoted by Gotcha.
  71.  
  72. o Anything else anyone can think up!
  73.  
  74.  
  75. Future versions may only be available to registered users...
  76.  
  77. Registration Details.
  78. =====================
  79.  
  80. To register your copy, send 5 UK Pounds to :
  81.  
  82. Paul Seed
  83. 2,Glenluce Drive
  84. Farringdon Park,
  85. Preston. Lancs.
  86.  
  87. and please  use  the  registration  form  provided  in  this  archive.
  88. Alternatively, contact me on the support BBS, and email or yell!...
  89.  
  90. Registered users will receive  the  current  version  of Gotcha! along
  91. with any other updates, and copies  of any other demos of PMT-SOFTWARE
  92. products.
  93.  
  94.             GOTCHA! by Paul Seed (c) 1994 PMT-Software...
  95.  
  96.                           Archive Contents.
  97.                           -=-=-=-=-=-=-=-=-
  98.  
  99. You should have the following files in the Gotcha Archive.
  100.  
  101. GOT_113.PRG  - The actual GOTCHA program
  102. EDITOR12.PRG - Gotcha User Editor.
  103. DONTDOIT.PRG - Optional program to bypass Gotcha.
  104. KILL_MSG.PRG - Message Deleter for Gotcha.
  105. GOTCHA.TXT   - This documentation
  106. MESSAGE.TXT  - Example Gotcha Message Text
  107. GOTCHA.CFG   - Configuration Template (DO NOT ALTER THE ORDER!)
  108. UPDATES.TXT  - History of Gotcha Version.
  109. REGISTER.TXT - Registration Form.
  110.  
  111. If any of the above files are missing, please contact the support BBS.
  112.  
  113.  
  114. Installation.
  115. -=-=-=-=-=-=-
  116.  
  117. Gotcha! needs to be setup properly before anything is run. The first
  118. thing to do is to copy the GOT_113.PRG ,EDITOR12.PRG,GOTCHA.CFG and
  119. KILL_MSG files into the same folder. This ideally should be in the
  120. main QBBS directory, but it is possible to have them elsewhere.
  121.  
  122. Gotcha! also keeps a logfile in the directory that GOTCHA is run from.
  123. It's called GOTCHA.LOG (suprisingly enough!)
  124.  
  125. You must then edit GOTCHA.CFG with a normal ASCII editor. YOU MUST NOT
  126. change the order of the config file. You can delete the lines starting
  127. with a ';' if you wish, but DO NOT change the actual ordering of the
  128. statements.
  129.  
  130. The config file is pretty straight forward :
  131.  
  132.  
  133. The following specify path names required by GOTCH. All must end in a
  134. backslash. The path for GOTCHA data files SHOULD BE EMPTY.
  135.  
  136. D:\QBBS\        <<<<<<<<<< Path to main BBS folder.
  137. D:\QBBS\TEXT\   <<<<<<<<<< Path to the QBBS Text File Folder.
  138. D:\QBBS\GOTCHA\ <<<<<<<<<< Leads to a path for the GOTCHA data files.
  139.  
  140. The next few lines in the gotcha file specify the actions that Gotcha
  141. takes after a number of time a user drops carrier.
  142.  
  143. They look like this...
  144.  
  145. REDUCE_SECURITY,10,3,D:\QBBS\SECURITY.TXT
  146.  
  147. SET_FLAG,A1,5,D:\QBBS\SET_TEXT.TXT
  148.  
  149. DEL_FLAG,A3,6,D:\QBBS\DEL_TXT.TXT
  150.  
  151. WRITE_NOTE,1,D:\QBBS\MESSAGE.TXT
  152.  
  153.  
  154. The first three lines define actions that modify the USERS.BBS file.
  155. Gotcha can currently change a users security level, and set/delete
  156. flags to reduce access to your BBS system.
  157.  
  158. Each action can be 'delayed', so that a user has to drop carrier a
  159. certain number of times before the action takes place..
  160.  
  161. Each action can also have an individual text file which is shown to
  162. the user at logon.
  163.  
  164. Gotcha uses the USER???.ASC (where ??? is the user number) text file
  165. to notify the user that they have dropped carrier. This is to make
  166. sure that the user receives the message (coz they can skip the mail
  167. scan 8-}  )
  168.  
  169. The lines take the following format :
  170.  
  171. REDUCE_SECURITY,  <<<< This is the actual action.. DO NOT CHANGE THIS!!
  172.  
  173. 10,               <<<< This tells Gotcha what exactly to do (in this
  174.                        case reduces the security level to 10.
  175.  
  176. 3,                <<<< This is the delay. In this case, Gotcha would
  177.                        reduce the security after 3 dropped carriers.
  178.  
  179. D:\QBBS\SECURITY.TXT < This is the full path and filename of the text
  180.                        file which will be shown to the user at logon.
  181.  
  182. And so on for the other two.... (ie in flag operations, A1 denotes
  183. flag A1 etc.....)
  184.  
  185. The final line looks summat like
  186.  
  187. WRITE_NOTE,1,D:\QBBS\MESSAGE.TXT
  188.  
  189. This is just a general purpose message to notify the user that he/she
  190. has dropped carrier. It's exactly the same as the action lines above,
  191. except that it does not alter the users.bbs file. (It just acts as a
  192. warning).
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. So,  this config file :
  200.  
  201.  
  202. REDUCE_SECURITY,10,3,D:\QBBS\SECURITY.TXT
  203.  
  204. SET_FLAG,A1,5,D:\QBBS\SET_TEXT.TXT
  205.  
  206. DEL_FLAG,A3,6,D:\QBBS\DEL_TXT.TXT
  207.  
  208. WRITE_NOTE,1,D:\QBBS\MESSAGE.TXT
  209.  
  210.  
  211. ......would tell Gotcha to :
  212.  
  213. o Write the warning message after 1 dropped carrier
  214.  
  215. o Set a users security to 10 after 3 dropped carriers and display the
  216.   file SECURITY.TXT at logon.
  217.  
  218. o Set flag A1 after 5 dropped carriers and display the file SET_TEXT
  219.   at logon
  220.  
  221. o Delete flag A3 after 6 dropped carriers and display the file DEL_TXT
  222.   at logon.
  223.  
  224.  
  225. Simple as that!!
  226.  
  227.  
  228.  
  229. So thats the GOTCHA.CFG file done... How do I install it!
  230. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  231.  
  232. You should first alter your BBS batch file so that it runs GOTCHA
  233. after QBBS exits with an errorlevel of 3. After GOTCHA has run, you
  234. must rename the LASTUSER.LOG to something like LASTUSER.BAK,
  235. otherwise, if a user drops carrier before logon, the person on before
  236. will get logged by Gotcha!
  237.  
  238.  
  239. So something like :
  240.  
  241. IF ERRORLEVEL = 3 THEN GOTO GOTCHA   <<< If user Drops carrier
  242.  
  243. GOTO MAILER                          <<< Nope? Start again!
  244.  
  245.  
  246. GOTCHA:
  247.  
  248. CD D:\QBBS\                          <<< Path to GOT_113.PRG
  249.  
  250. GOT_113.PRG                          <<< RUN IT!
  251.  
  252. DEL D:\QBBS\LASTUSER.XXX             <<< Delete the old backup
  253.  
  254. RENAME D:\QBBS\LASTUSER.LOG D:\QBBS\LASTUSER.XXX < Backup LASTUSER.LOG
  255.  
  256. GOTO MAILER                          <<< START AGAIN!!
  257.  
  258.  
  259. The you must alter your WELCOME.DOR so that is checks for any
  260. undeleted Gotcha Notification at logon. To do this, type summat like :
  261.  
  262. CD D:\QBBS\             <<<< Path to KILL_MSG.PRG
  263.  
  264. WRITE DORINFO1.DEF      <<<< Write out DORINFO1.DEF
  265.  
  266. EXEC KILL_MSG.PRG       <<<< Run the program.
  267.  
  268.  
  269. This must the the first thing in your WELCOME.DOR
  270.  
  271.  
  272. So now that your main BBS batch file is setup, and your WELCOME.DOR is
  273. ready, what else do I need to do?
  274.  
  275. Basically you need to get GOTCHA to build an index for your user base.
  276. This file (GOTCHA.TAB) has a list of all your users names and the
  277. number of times they have dropped carrier. It will be created in the
  278. GOTCHA folder you specified in the CFG file.
  279.  
  280. To get GOTCHA to create the table, you must make sure that there is a
  281. valid LASTUSER.LOG in the QBBS folder and just run GOT_113.PRG. It
  282. will notice that you have no table and start to make one.. It will
  283. also make a note of the name in the LASTUSER.LOG and alter the users
  284. record in GOTCHA.TAB just so you can check the installation has gone
  285. well.
  286.  
  287. Once the table has been created, run the EDITOR.PRG and select
  288. 'Change User Record'. Hopefully if all is well, you should get a
  289. screen with 1 name on it (The name in the LASTUSER.LOG) and the words
  290. 'has dropped carrier 1 times'
  291.  
  292. If you dont get this, you probably havent set up the CFG file
  293. correctly.
  294.  
  295. When you get this far, press the key to change a users record and
  296. you'll be asked what you want to change it to.. .Enter 0 to clear the
  297. record.
  298.  
  299. You'll be asked if you want to delete the message to the user. Select
  300. Yes.
  301.  
  302. After a couple more prompts, you should be faced with just the menu
  303. options on screen.. Just return to the main menu and quit. You'll be
  304. asked if you want to save the changes.. Just select YES!!
  305.  
  306. That's it! (Phew....) There is another option in the editor to create
  307. an ASCII table, but as this is shareware, it writes out an unformatted
  308. table. Guess what happens in the updates????
  309.  
  310. If you have any problems with GOTCHA, please call the support BBS
  311. (PMT-BBS on 0772 794663 6pm-9am weekdays, 24hrs weekends.)
  312.  
  313.  
  314.  
  315. So what's DONTDOIT.PRG???
  316.  
  317. Dont Do it? is a small program that should be used along with any
  318. door programs that may hang up your users (Such as the ST-ing online
  319. game). Obviously, when this sort of program returns to the BBS, there
  320. is no carrier present, so it appears to Gotcha! that the user has
  321. dropped carrier. Dont Do it writes out a file (DONDOIT.DAT) in the
  322. QBBS folder (where it MUST be run from) that Gotcha searches for. If
  323. it's present, it won't accuse the user of dropping carrier. To install
  324. it, I use summat like :
  325.  
  326.  
  327. ECHO STING is a game in which if you lose against the computer, you will be
  328. ECHO automatically logged off... So play well....
  329. ECHO
  330.  
  331. PROMPT Do you still want to play STING??? (y/N)?
  332.  
  333. KEY
  334. IF *CHR = Y then goto STING
  335. IF *CHR = y then goto STING
  336.  
  337. ECHO Ok then... Not feeling lucky.... Seeya Later... Press a Key
  338. KEY
  339. EXIT
  340.  
  341. :STING
  342. ECHO
  343. ECHO Ok... Loading Sting....
  344. ECHO
  345. CD D:\QBBS
  346. EXEC DONTDOIT.PRG
  347. CD F:\STING
  348. WRITE FOREM.DAT
  349. EXEC ST_ING.PRG
  350.  
  351.  
  352.  
  353. Thanks to Mark Williams of Nickleodeon BBS for giving me the main
  354. ideas for Gotcha. Gotcha is really his request, and me just the lousy
  355. coder <grin> .... Thanks for the number of comments and Beta Testing..
  356. And making my little boring life hell!
  357.  
  358.  
  359.  
  360. I suppose if you want to call Nickleodeon, here's his number :::
  361.  
  362. Nickleodeon BBS - 051 709 8508 : Mon-Thurs 6pm-9am
  363.                                  Fri-Sun    24hrs
  364.  
  365.  
  366. ...... Plug Pluggy Plug Plug...
  367.  
  368.  
  369.