ooooooo   ooooo  oooooo  ooooo   o    o    ooo      oo
       o         o    o    o    o       o    o   o    o    oo
      o   oooo  o    o    o    o       oooooo   oooooo    oo
     o     o   o    o    o    o       o    o   o    o
     ooooo     ooooo    o    oooooo  o    o   o    o    oo

                         Written By Paul Seed

                         (c)1994 PMT-SOFTWARE

                     Support BBS +44(0)772 794633

                PMT-BBS 6pm-9am Weekdays/24hr Weekends

         NeST 90:100/109  AtariNet 51:6/9  FidoNet 2:250/155

              FishNet 777:400/5    MercuryNet 240:300/17

           Supporting Speeds up to v32bis and V42bis/MNP2-5



I have tested GOTCHA! very  thoroughly  but  there  are no doubt a few
bugs in  the  code.  If  you  think  you  have  found  a  bug  in  the
program,please write to me at the address  at  the end of this doc, or
Netmail on any of the above addresses.

Gotcha! V1.13 is distributed as  Shareware.  If  you like the program,
and use it regularly, please  register  the software. Registering will
allow you to receive future upgrades of the program, and also you will
receive any utilities and  extras  with  a  personal  ID for your BBS.
Registration of Gotcha! is 5 UKP. Please  read  the info at the end of
the doc for more information.

Support for Gotcha! and ant other PMT-Software titles is given to both
registered and unregistered users.


Disclaimer.
===========

Gotcha! changes data in  your  USERS.BBS  file.  It  also uses several
other files to control the  action  of  the  program. I cannot be held
responsible for any damage done to any files on your HD. I have tested
the program many times  on  my  system,  and  not trashed my USERS.BBS
file. Basically, you use  the  program  at  your  own risk. You should
really back up your USERS.BBS file every couple of days anyway <grin>.

This version of  Gotcha!  (Vers.   1.13b)   may  be  distributed  free
of charge, as long as you keep the following files in the archive...


Future releases of Gotcha! may include :

o The ability to ask  the  user  for  a  reason  to why he/she dropped
carrier at logon...

o Creation of a text file with Bad Logoffs etc for each user/day etc.

o Creation of a text file for  users  to view with names of people who
have dropped carrier too many times.

o Unlimited  actions  instead  of  one  delete  flag  ,one message,one
security and one set flag.


o Full GEM Config and Editor program.

o Exclusion list to stop people having modem trouble/new users keep
  getting demoted by Gotcha.

o Anything else anyone can think up!


Future versions may only be available to registered users...

Registration Details.
=====================

To register your copy, send 5 UK Pounds to :

Paul Seed
2,Glenluce Drive
Farringdon Park,
Preston. Lancs.

and please  use  the  registration  form  provided  in  this  archive.
Alternatively, contact me on the support BBS, and email or yell!...

Registered users will receive  the  current  version  of Gotcha! along
with any other updates, and copies  of any other demos of PMT-SOFTWARE
products.

            GOTCHA! by Paul Seed (c) 1994 PMT-Software...

                          Archive Contents.
                          -=-=-=-=-=-=-=-=-

You should have the following files in the Gotcha Archive.

GOT_113.PRG  - The actual GOTCHA program
EDITOR12.PRG - Gotcha User Editor.
DONTDOIT.PRG - Optional program to bypass Gotcha.
KILL_MSG.PRG - Message Deleter for Gotcha.
GOTCHA.TXT   - This documentation
MESSAGE.TXT  - Example Gotcha Message Text
GOTCHA.CFG   - Configuration Template (DO NOT ALTER THE ORDER!)
UPDATES.TXT  - History of Gotcha Version.
REGISTER.TXT - Registration Form.

If any of the above files are missing, please contact the support BBS.


Installation.
-=-=-=-=-=-=-

Gotcha! needs to be setup properly before anything is run. The first
thing to do is to copy the GOT_113.PRG ,EDITOR12.PRG,GOTCHA.CFG and
KILL_MSG files into the same folder. This ideally should be in the
main QBBS directory, but it is possible to have them elsewhere.

Gotcha! also keeps a logfile in the directory that GOTCHA is run from.
It's called GOTCHA.LOG (suprisingly enough!)

You must then edit GOTCHA.CFG with a normal ASCII editor. YOU MUST NOT
change the order of the config file. You can delete the lines starting
with a ';' if you wish, but DO NOT change the actual ordering of the
statements.

The config file is pretty straight forward :


The following specify path names required by GOTCH. All must end in a
backslash. The path for GOTCHA data files SHOULD BE EMPTY.

D:\QBBS\        <<<<<<<<<< Path to main BBS folder.
D:\QBBS\TEXT\   <<<<<<<<<< Path to the QBBS Text File Folder.
D:\QBBS\GOTCHA\ <<<<<<<<<< Leads to a path for the GOTCHA data files.

The next few lines in the gotcha file specify the actions that Gotcha
takes after a number of time a user drops carrier.

They look like this...

REDUCE_SECURITY,10,3,D:\QBBS\SECURITY.TXT

SET_FLAG,A1,5,D:\QBBS\SET_TEXT.TXT

DEL_FLAG,A3,6,D:\QBBS\DEL_TXT.TXT

WRITE_NOTE,1,D:\QBBS\MESSAGE.TXT


The first three lines define actions that modify the USERS.BBS file.
Gotcha can currently change a users security level, and set/delete
flags to reduce access to your BBS system.

Each action can be 'delayed', so that a user has to drop carrier a
certain number of times before the action takes place..

Each action can also have an individual text file which is shown to
the user at logon.

Gotcha uses the USER???.ASC (where ??? is the user number) text file
to notify the user that they have dropped carrier. This is to make
sure that the user receives the message (coz they can skip the mail
scan 8-}  )

The lines take the following format :

REDUCE_SECURITY,  <<<< This is the actual action.. DO NOT CHANGE THIS!!

10,               <<<< This tells Gotcha what exactly to do (in this
                       case reduces the security level to 10.

3,                <<<< This is the delay. In this case, Gotcha would
                       reduce the security after 3 dropped carriers.

D:\QBBS\SECURITY.TXT < This is the full path and filename of the text
                       file which will be shown to the user at logon.

And so on for the other two.... (ie in flag operations, A1 denotes
flag A1 etc.....)

The final line looks summat like

WRITE_NOTE,1,D:\QBBS\MESSAGE.TXT

This is just a general purpose message to notify the user that he/she
has dropped carrier. It's exactly the same as the action lines above,
except that it does not alter the users.bbs file. (It just acts as a
warning).






So,  this config file :


REDUCE_SECURITY,10,3,D:\QBBS\SECURITY.TXT

SET_FLAG,A1,5,D:\QBBS\SET_TEXT.TXT

DEL_FLAG,A3,6,D:\QBBS\DEL_TXT.TXT

WRITE_NOTE,1,D:\QBBS\MESSAGE.TXT


......would tell Gotcha to :

o Write the warning message after 1 dropped carrier

o Set a users security to 10 after 3 dropped carriers and display the
  file SECURITY.TXT at logon.

o Set flag A1 after 5 dropped carriers and display the file SET_TEXT
  at logon

o Delete flag A3 after 6 dropped carriers and display the file DEL_TXT
  at logon.


Simple as that!!



So thats the GOTCHA.CFG file done... How do I install it!
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

You should first alter your BBS batch file so that it runs GOTCHA
after QBBS exits with an errorlevel of 3. After GOTCHA has run, you
must rename the LASTUSER.LOG to something like LASTUSER.BAK,
otherwise, if a user drops carrier before logon, the person on before
will get logged by Gotcha!


So something like :

IF ERRORLEVEL = 3 THEN GOTO GOTCHA   <<< If user Drops carrier

GOTO MAILER                          <<< Nope? Start again!


GOTCHA:

CD D:\QBBS\                          <<< Path to GOT_113.PRG

GOT_113.PRG                          <<< RUN IT!

DEL D:\QBBS\LASTUSER.XXX             <<< Delete the old backup

RENAME D:\QBBS\LASTUSER.LOG D:\QBBS\LASTUSER.XXX < Backup LASTUSER.LOG

GOTO MAILER                          <<< START AGAIN!!


The you must alter your WELCOME.DOR so that is checks for any
undeleted Gotcha Notification at logon. To do this, type summat like :

CD D:\QBBS\             <<<< Path to KILL_MSG.PRG

WRITE DORINFO1.DEF      <<<< Write out DORINFO1.DEF

EXEC KILL_MSG.PRG       <<<< Run the program.


This must the the first thing in your WELCOME.DOR


So now that your main BBS batch file is setup, and your WELCOME.DOR is
ready, what else do I need to do?

Basically you need to get GOTCHA to build an index for your user base.
This file (GOTCHA.TAB) has a list of all your users names and the
number of times they have dropped carrier. It will be created in the
GOTCHA folder you specified in the CFG file.

To get GOTCHA to create the table, you must make sure that there is a
valid LASTUSER.LOG in the QBBS folder and just run GOT_113.PRG. It
will notice that you have no table and start to make one.. It will
also make a note of the name in the LASTUSER.LOG and alter the users
record in GOTCHA.TAB just so you can check the installation has gone
well.

Once the table has been created, run the EDITOR.PRG and select
'Change User Record'. Hopefully if all is well, you should get a
screen with 1 name on it (The name in the LASTUSER.LOG) and the words
'has dropped carrier 1 times'

If you dont get this, you probably havent set up the CFG file
correctly.

When you get this far, press the key to change a users record and
you'll be asked what you want to change it to.. .Enter 0 to clear the
record.

You'll be asked if you want to delete the message to the user. Select
Yes.

After a couple more prompts, you should be faced with just the menu
options on screen.. Just return to the main menu and quit. You'll be
asked if you want to save the changes.. Just select YES!!

That's it! (Phew....) There is another option in the editor to create
an ASCII table, but as this is shareware, it writes out an unformatted
table. Guess what happens in the updates????

If you have any problems with GOTCHA, please call the support BBS
(PMT-BBS on 0772 794663 6pm-9am weekdays, 24hrs weekends.)



So what's DONTDOIT.PRG???

Dont Do it? is a small program that should be used along with any
door programs that may hang up your users (Such as the ST-ing online
game). Obviously, when this sort of program returns to the BBS, there
is no carrier present, so it appears to Gotcha! that the user has
dropped carrier. Dont Do it writes out a file (DONDOIT.DAT) in the
QBBS folder (where it MUST be run from) that Gotcha searches for. If
it's present, it won't accuse the user of dropping carrier. To install
it, I use summat like :


ECHO STING is a game in which if you lose against the computer, you will be
ECHO automatically logged off... So play well....
ECHO

PROMPT Do you still want to play STING??? (y/N)?

KEY
IF *CHR = Y then goto STING
IF *CHR = y then goto STING

ECHO Ok then... Not feeling lucky.... Seeya Later... Press a Key
KEY
EXIT

:STING
ECHO
ECHO Ok... Loading Sting....
ECHO
CD D:\QBBS
EXEC DONTDOIT.PRG
CD F:\STING
WRITE FOREM.DAT
EXEC ST_ING.PRG



Thanks to Mark Williams of Nickleodeon BBS for giving me the main
ideas for Gotcha. Gotcha is really his request, and me just the lousy
coder <grin> .... Thanks for the number of comments and Beta Testing..
And making my little boring life hell!



I suppose if you want to call Nickleodeon, here's his number :::

Nickleodeon BBS - 051 709 8508 : Mon-Thurs 6pm-9am
                                 Fri-Sun    24hrs


...... Plug Pluggy Plug Plug...