home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / KPROT191.ZIP / KPROTECT.DOC < prev    next >
Text File  |  1993-10-10  |  13KB  |  240 lines
  1.                       ┌─────────────────────────────┐
  2.                       │      Kill Protect 1.91      │
  3.                       └─────────────────────────────┘
  4.  
  5.  
  6.                              !!!! WARNING !!!!
  7.        !!   This Program Is Designed for GT 16.00+ Specifically   !!
  8.    !!  Use on previous versions could prove hazardous to your system  !!
  9.  
  10.        ──────────────────────────────────────────────────────────────
  11.                                   History
  12.        ──────────────────────────────────────────────────────────────
  13.  
  14.          01-11-92   Ver 1.0 Initial Release
  15.          01-12-92   Ver 1.1 Introduction of /F: Parameter (see below)
  16.          02-08-92   Ver 1.2 Fixed a small bug in reading of GTMDIR.BBS
  17.                             Multiple message variables were not under-
  18.                             stood in ver 1.0 and 1.1. For example....
  19.                             if you had #^E:\GTMAIL\SYSOP, KPROTECT would
  20.                             error out when opening MESSAGE.CTL.
  21.          12-06-92   Ver 1.3 Now compatible with the new QWK version of
  22.                             GTMDIR.BBS.  Added /REGISTER command line
  23.                             parameter.
  24.           2-02-93   Ver 1.4 Bug Fix, corrected problem reading GTMDIR.BBS
  25.           2-21-93   Ver 1.5 Kprotect now understands a '#' flag in the
  26.                             GTMDIR.BBS file.
  27.           7-21-93   Ver 1.6 Kprotect now provides loggins support, as
  28.                             requested by Jim Knight.  Along with the log
  29.                             support comes two new command line parameters
  30.                             /L /NL.  /L tell Kprotect to turn on the
  31.                             logging feature and create a
  32.                             <GTPATH>\HOTWARE\KPROTECT.LOG.  /NL also turns
  33.                             on the logging feature but will create a NEW
  34.                             LOG thus overwriting any information that may
  35.                             be contained from a previous log.
  36.           7-24-93   Ver 1.7 Bug Fix in the Msg Couting logic.  KPROTECT
  37.                             was counting the SYS CTL entry in the
  38.                             MESSAGE.CTL as a valid message.
  39.           8-15-93   Ver 1.8 Added logic to make sure messages in a public
  40.                             message area are all public.  Likewise to make
  41.                             sure that a private message area has all
  42.                             private messages.  These messages will be
  43.                             converted if they are incorrect.  If a message
  44.                             has a pesky little Re: starting the subject,
  45.                             like so many readers like to apply, it will be
  46.                             removed.  Both of these new options are
  47.                             optional and can be turned off with new command
  48.                             line switches.  /NFC or "No Flag Convert" will
  49.                             tell the program NOT to convert messages from
  50.                             public <> private.  /NSC or "No Subject Change"
  51.                             will tell the program to leave the Subject
  52.                             intact.
  53.           9-14-93   Ver 1.9 Kprotect now creates a work copy of the
  54.                             GTMDIR.BBS prior to execution.  This allows
  55.                             KPROTECT to work in Multitasking Environments
  56.                             where multiple programs are accessing the
  57.                             GTMDIR.BBS.  The work file will be placed in
  58.                             the <GTPATH>\HOTWARE directory and
  59.                             automatically removed after execution
  60.                             completes.
  61.          10-10-93  Ver 1.91 Corrects a small problem with the REGISTER
  62.                             feature.  The SYSOP.BBS file, which is where
  63.                             the name is found for the FROM: field of the
  64.                             registration message, will now be searched for
  65.                             in 1. The GTPATH, 2. The DOS PATH, and finally
  66.                             3. The BBSCBS path as found in the GT.CNF.
  67.  
  68.  
  69.  
  70.        ──────────────────────────────────────────────────────────────
  71.                                 What is It?
  72.        ──────────────────────────────────────────────────────────────
  73.          A simple little program that will go to each message area
  74.          listed in your GTMDIR.BBS file and "Kill Protect" each message
  75.          that is not currently either "Private" or "Kill Protect".
  76.          This program will also convert any Public messages in a Private
  77.          only message area to Private.  It will also convert any Private
  78.          messages in a Public only message area to Public.
  79.  
  80.          At the end of each execution you will be given a report on,
  81.          1. The total number of messages available on your system, 2.
  82.          The total number of "Kill Protected" messages on your system,
  83.          3.  Total number of "Private" messages on your system, 4. Total
  84.          number of message areas found in your GTMDIR.BBS file, 5. Total
  85.          number of message areas that were successfully processed, 6.
  86.          The total number of unsuccessfully processed message areas, 7.
  87.          Total number of messages converted Public <> Private, 8. Total
  88.          number of messages that were converted to "Kill Protect"
  89.          status on this execution of KPROTECT.
  90.  
  91.  
  92.        ──────────────────────────────────────────────────────────────
  93.                                   Why Is It?
  94.        ──────────────────────────────────────────────────────────────
  95.  
  96.          You may be asking about now, Why would you want to do this?
  97.          It's simple.  On my system, all "Public" messages default
  98.          to "Kill Protect" when they are entered.  Unfortunately not
  99.          all systems in the GT Network are not this way.  Therefore
  100.          messages arriving in echos that are not marked "Kill Protect"
  101.          are often deleted by users as they read the echos.  By marking
  102.          all NON-Private messages as "Kill Protect" the messages will
  103.          remain in the echo areas for others to read.  Besides, my
  104.          nightly maintenance is very efficient at removing out of date
  105.          messages for me automatically.
  106.  
  107.        ──────────────────────────────────────────────────────────────
  108.                                 Registration
  109.        ──────────────────────────────────────────────────────────────
  110.  
  111.         I am not requesting any money for this program, but I would
  112.         not turn any down either <g>.  If you want to slip $5.00 into
  113.         and envelope I'll accept it.  Although I don't require a
  114.         registration fee I would appreciate knowing that you are using
  115.         the program on a normal basis.  Therefore I have provided a
  116.         simple and easy way for you to register this program.  From
  117.         the DOS prompt type:   
  118.  
  119.  
  120.          KPROTECT /REGISTER
  121.  
  122.       Kill Protect will the proceed to send me a netmail message informing
  123.       me that you are using the program.  Please use this feature ONCE.
  124.  
  125.  
  126.        ──────────────────────────────────────────────────────────────
  127.                                  Execution..
  128.        ──────────────────────────────────────────────────────────────
  129.          Running the program is very easy.  The only things that are
  130.          required are 1. A valid GTPATH statement, and a valid GTMDIR.BBS
  131.          file in the directory pointed to by GTPATH.  KPROTECT takes care
  132.          of the rest of it.  It reads each line of the GTMDIR.BBS file
  133.          and takes appropriate action on each message area.  The program
  134.          is intended to run daily either during your nightly maintenance
  135.          or after any mail run.  I personally run the utility after each
  136.          run of MDIST, just to pick up any stray "Un Kill Protected"
  137.          messages that should arrive.  If you would rather specify a
  138.          filename other than GTMDIR.BBS you may use a /F: parameter on
  139.          the command line of KPROTECT.  For example....
  140.  
  141.          KPROTECT /F:C:\TESTING\ALTERNATE.BBS
  142.  
  143.          This would read information from a file named ALTERNATE.BBS
  144.          located in C:\TESTING.  This file MUST be in the same format
  145.          as the GTMDIR.BBS file.
  146.  
  147.          If you would like Kill Protect to keep a log file for you, you may
  148.          use one of two parameters /L or /NL.  /L will simply turn on the
  149.          logging feature and APPEND to any existing log information.  /NL
  150.          or NEW LOG will erase any old log files and start a fresh new one.
  151.          The LOG file will be placed in <GTPATH>\HOTWARE\KPROTECT.LOG.
  152.          Here is an example of what you will find in the log.
  153.  
  154. Kill Protect Started: 7-21-1993 21:44
  155.         Message Area         Totl Msgs   Start Msg #   End  Msg #   Totl Chng
  156.  -------------------------- ----------- ------------- ------------ -----------
  157.  General Public Messages...       1             0            0           0
  158.  Private E-Mail............       1             0            0           0
  159.  Private Sysop Mail........      33             1           47           0
  160.  Netmail Message Area            73             1          170           0
  161.  HOTware Support and Sugges      18            50           71           0
  162.  
  163.    *-----------------  Kill Protect Execution Statistics  -----------------*
  164.      Messages Inspected         Kill Proof Messages      Private Messages
  165.             551                         436                     115
  166.  
  167.      Total Message Areas          Sucessful Areas         Aborted Areas
  168.               5                           5                       0
  169.  
  170.                    Total Messages Kill Protected This Run
  171.                                      0
  172.    *-----------------------------------------------------------------------*
  173.  
  174.       If you do NOT want Kill Protect to convert Public messages to Private
  175.       in a message area marked Private Only, or if you do not want it to
  176.       convert Private messages to Public in a Public only message area then
  177.       you can place a /NFC on the command line as follows:
  178.  
  179.       KPROTECT /NFC
  180.  
  181.       The Kill Protect default is to convert these messages as needed.
  182.  
  183.  
  184.       If you do NOT want Kill Protect to remove those pesky little Re:
  185.       additions to the Subjects of messages then you can use a /NSC on the
  186.       command line as follows:
  187.  
  188.       KPROTECT /NSC
  189.  
  190.       The Kill Protect default is to remove this little additions that so
  191.       many offline readers like to apply.
  192.  
  193.  
  194.        ──────────────────────────────────────────────────────────────
  195.                                  Errorlevels
  196.        ──────────────────────────────────────────────────────────────
  197.          Here are the possible errorlevel exits the program will give.
  198.       
  199.                   ERRORLEVEL 0  No Problems, Good Run.....
  200.                   ERRORLEVEL 1  GTPATH Environment not Set.
  201.                   ERRORLEVEL 2  Cannot Find GTMDIR.BBS in GTPATH.
  202.                   ERRORLEVEL 3  CTRL-BREAK Pressed
  203.  
  204.  
  205.        ──────────────────────────────────────────────────────────────
  206.                             Who Is Responsible for This?
  207.        ──────────────────────────────────────────────────────────────
  208.                                  Rob Roesch
  209.                               The HOTware BBS
  210.                          GT Power Net-Node 064/003
  211.                                 Rt 7 Box 566
  212.                            Mocksville, NC  27028
  213.                          704-492-2081 (USR 16.8 DS)
  214.  
  215.           If you start using this utility, and get a chance, let me know 
  216.           what you think of it.  If you don't have any use for it, delete  
  217.           it for your total refund of all the disk space that it was
  218.           occupying.  This program comes with no warranty, no guarantee,
  219.           and no promises.  If it works GREAT, if not let me know and I
  220.           will gladly take a look at it in my spare time.  If you really
  221.           really really like the program and want to make any donations,
  222.           feel free, but it is not a requirement.....
  223.                                                                 
  224.  
  225.        ──────────────────────────────────────────────────────────────
  226.                         Alternate Distribution Sites
  227.        ──────────────────────────────────────────────────────────────
  228.  
  229.            The HOTware Utilities now have alternate Distribution
  230.            Centers for your convenience.  The following BBS always
  231.            have the latest and greatest HOTware utilities online and
  232.            available for download.
  233.  
  234.      BBS Name          BBS Phone          Location     GT Net/Node    Hours
  235.  ┌──────────────────┬───────────────┬────────────────────┬───────┬──────────┐
  236.  │ Laboratory 386   │ 618-549-2322  │ Carbondale IL      │064/400│ 10pm-8am │
  237.  └──────────────────┴───────────────┴────────────────────┴───────┴──────────┘
  238.  
  239. EOF
  240.