home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CHKPC098.ZIP / CHKPC.DOC < prev    next >
Text File  |  1994-11-04  |  10KB  |  223 lines
  1.  
  2.  
  3.  
  4. ******************************************************************************
  5. * COPYRIGHT (C) 1994   /   THE RACER'S EDGE * TRE!  /   ALL RIGHTS RESERVED. *
  6. ******************************************************************************
  7.  
  8.  
  9.  
  10.                  *********************************************
  11.                  Check PC v 0.98 - Dupe Checker/Mover/Deleter
  12.                  for Planet Connect Sites.  All of your mail &
  13.                  files are moved for you.  Simple installation
  14.                  with full file comparisons including CRC-32
  15.                  checks, works on LANs, log reports, pass
  16.                  analysis, and many more features that can't
  17.                  fit inside this little file_id.diz file. :)
  18.                  Written by: Tim Fierro 10/04/94 @ 04:00 PM
  19.                  Brought to you by The Racer's Edge * TRE!
  20.                  *********************************************
  21.  
  22.  
  23.  
  24.                  Just a word of caution:  Disclaimer / Warranty
  25.                  ----------------------------------------------
  26. *  This product is provided with no warranty of any kind.  The entire risk   *
  27. *  as to the results and performance of this program is assumed by you, the  *
  28. *  end user.  I shall not be liable for any damages, whether directly, or    *
  29. *  indirectly, for damages that may be caused by this program and it's use.  *
  30.  
  31. Some formalities:  You are hereby granted a limited license to use this
  32.                    program.  You may freely distribute it to your friends and
  33.                    local bbs systems.  If your CHKPC.KEY is old, you can get a
  34.                    new one anytime from TRENDS!'s BBS.  If you should continue
  35.                    to use it past 30 days, you are encouraged to register this
  36.                    program.
  37.  
  38.  
  39. Please keep the archive intact.  This archive is CHKPC098.ZIP.  If you do
  40. upload this program to another bbs, please keep the same filename so others
  41. may may find it by it's distributed name.  The Check PC distribution file
  42. follows the format CHKPCxxx.ZIP where xxx represents the version.  If you
  43. should give this program to a friend to try, please give them the complete
  44. archive and not just some of the files.
  45.  
  46.  
  47.     Your support of the Shareware Distribution is very much appreciated!
  48.  
  49.  
  50.  
  51. Current Check PC version is always available as Magic Name - "CHKPC"
  52.  
  53. Magic Name "CHKPC" @ 1:138/165
  54.  
  55. Internet uuencoded E-Mail (Approx. 6 messages)
  56. Send E-mail to: chkpc@racer.wa.com
  57.  
  58. 1st call download: (206) 863-5877 ZyXEL 16.8k
  59. CHKPCxxx.ZIP about 70k in size (xxx being the current version)
  60.  
  61.  
  62.  
  63. Contacting the author:
  64.  
  65. U.S. Mail    :  Tim Fierro
  66.                 The Racer's Edge * TRE!
  67.                 P.O. Box 1472
  68.                 Sumner, WA  98390-0300
  69.  
  70. BBS Number   :  TRENDS! * (206) 863-5877 * ZyXEL v.32bis 16.8k/Fax
  71.  
  72. FidoNet Node :  1:138/165
  73.  
  74. Internet     :  tim.fierro@racer.wa.com
  75.                 After 12/01/94 -->  tim.fierro@racer.com
  76.  
  77. RoseNet P2P  :  TIM FIERRO @ RACER
  78.  
  79.  
  80.  
  81. I do want to say a BIG THANK YOU to all those who have netmailed their
  82. suggestions and have been using Check PC.  What started out as a hard coded
  83. program for me so I can make better use of the .QWK files, has turned out to
  84. be a bit bigger than I had thought and now have it doing a complete
  85. replacement for programs like PCFU and Skymail, instead of only an add-on.
  86.  
  87.  
  88.  
  89. The best way to describe Check PC is to run it, and then look at the log file
  90. (CHKPC.LOG) and the processed file (CHKPC.PRC).  The processing of the
  91. incoming data is all automatic!
  92.  
  93.  
  94.  
  95. A requirement of this program is that you have all your incoming data stream
  96. going to one directory.  I like this approach and it works here flawlessly.
  97. Your view on this may be different and if so, you may be better off using
  98. PCFU, SkyMail, or another program to check your incoming data.
  99.  
  100.  
  101.  
  102. Check PC looks for it's support files in the directory from which it is ran.
  103. Make sure you place all the support files in the archive into the same
  104. directory.  I suggest \CHKPC as the directory to use.
  105.  
  106. CHKPC.EXE       Executable file
  107. CHKPC.KEY       Key file (registered key or the 30 day evaluation key)
  108. CHKPC.CFG       Check PC's configuration file
  109. CHKPC.EXC       Exclude List
  110. CHKPC.DOC       Documentation on use
  111. CHKPC.NEW       The latest enhancements to this version
  112. CHKPC.REG       Registration File
  113. CHKPC.NOT       Last run's check against the UPLD.LST file
  114. CHKPC.xxx       Julian date of the CHKPC.NOT file
  115. CHKPC.LOG       Log file of the last run
  116. CHKPC.PRC       History of files for the past 3 days
  117. CHKPC.DBG       Check PC's debug file for identifying problems
  118. CHKPC.SKY       Current ACONFIG.SKY file used on TRENDS! (Re-run MAKECFG.EXE)
  119. CHKPC.RUN       How I run the dish feed (DISH.BAT)
  120. FILE_ID.DIZ     Description of Check PC
  121. DESC.SDI        Description of Check PC
  122.  
  123.  
  124.  
  125. To setup Check PC, place all the files in this archive into a directory of
  126. your choice.  I have mine in D:\CHKPC.
  127.  
  128.  
  129. Edit your ACONFIG.SKY file to show all your mail/files going to one directory.
  130. I have included CHKPC.SKY which is the current ACONFIG.SKY file I run on my
  131. system.  After you edit ACONFIG.SKY, don't forget to run MAKECFG on it.
  132.  
  133.  
  134. Edit the CHKPC.CFG file to show your directory structure of where you want the
  135. files to be moved to after being processed.  The CHKPC.CFG file is heavily
  136. documented so you should not have any troubles with it.  As a reminder, make
  137. sure that entries of directories really do exist on your system.  Check PC
  138. will use whatever entries you place into it's configuration, but it is up to
  139. you to insure that those directories do exist.
  140.  
  141.  
  142. Edit the CHKPC.EXC file with your list of files you do not wish to be reported
  143. as missing.  This is your exclude list.  The format is to use the 'BASE' name
  144. for files you do not want reported.  An example would be that if you do not
  145. want the CRS.QWx file checked since you have them directed to \NUL in your
  146. ACONFIG.SKY file, then just place CRS as the base name in the exclude list.
  147. This will allow you to place those bundles/files that you do not want to be
  148. bothered with, but are reported by the UPLD.LST as being sent, to be
  149. disregarded.  I have included the CHKPC.EXC file I use here.  Edit it to suit
  150. your system.  You only need to place the 'BASE' name, not the extension.  The
  151. exclude list can have 128 entries which should be more than enough.
  152.  
  153.  
  154. You are now ready to run CHKPC.EXE.  Just change to the directory where you
  155. have placed the contents of the archive, and type "CHKPC".  If Check PC
  156. reports to the screen an error reason, review the message to see if it a minor
  157. error that can be corrected and re-run CHKPC.EXE.  If Check PC for some reason
  158. does not run on your system, you will find a CHKPC.DBG file in your directory
  159. and I would appreciate you sending me this file, and your CHKPC.CFG file and I
  160. will help you get Check PC up and running.
  161.  
  162.  
  163. Check PC will generate a log file (CHKPC.LOG) in the current directory which
  164. will be the entries of Filename, Extension, Size, Date, CRC-32, Day/Time of
  165. this run, and the action (M for move, D for deleted, and K for Killed) that
  166. was performed.  "M" means that we moved the file from the incoming directory
  167. to the directory in your config file, normal.  "D" means that we did not move
  168. this file and instead deleted it, a duplicate file.  "K" means that this file
  169. was moved to the directory that you chose, but you did not finish processing
  170. the old one and we had to delete it in order to bring in the newer mail/file.
  171. If you get a "K" in your log file, then you should check your batch files to
  172. insure you are taking care of the bundles as they come in.  There is also an
  173. "E" which means this file was in your CHKPC.EXC (Exclude list).  You can
  174. overide the default directory and place the log(s) where you want them.
  175.  
  176.  
  177.  
  178. Check PC will generate a missed files list (CHKPC.NOT).  This file is what was
  179. not received on this pass.  If the time of processing is after 06:00am and you
  180. have not ran Check PC yet, then it is the first pass.  If you have already ran
  181. Check PC today and then run it again, all new passes will be reported as not
  182. being the first pass.  The flag that determines if it is a first pass or not
  183. is the CHKPC.xxx (where xxx is the julian day).  If it is the first pass, you
  184. will have your CHKPC.NOT file AND a CHKPC.xxx file generated.  All new passes
  185. on this day will only produce a CHKPC.NOT file.  This file is your information
  186. on how things are running.
  187.  
  188.  
  189.  
  190. You could also use a text importing utility to send your .NOT and LOG files to
  191. an echo conference to compare to other dish sites, or to your system messages
  192. conference to keep tabs on what your system is doing.  If you wish to view the
  193. .NOT or .LOG files, you must do so before the next time you run CHKPC.EXE.
  194. These two files are generated each time and overwriting the old ones.
  195.  
  196.  
  197. Check PC will also generate a new processed file (CHKPC.PRC) each time you run
  198. it.  The processed file is what is used to determine if the file is new in any
  199. way and if so, to move it.  Otherwise if it matches 'exactly' to an existing
  200. entry, then it is deleted.  If you wish to edit the CHKPC.PRC file, in case
  201. you wish to receive a file again, then just delete the lines necessary.  It is
  202. a self maintaining file and will keep 3 days of history.
  203.  
  204.  
  205.  
  206. If you should find a bug in the way Check PC operates, then please let me know
  207. via the ways mentioned in the docs.  I am more than willing to fix anything
  208. that needs it as I use this software daily as you will be doing. :)  Most
  209. of the things that have been added to Check PC, have been requested by others
  210. to help their processing go smoother.  If you have a suggestion, just let
  211. me know what it is you want added, and I will see if it is within the scope
  212. I have for Check PC, and see if it is something I can incorporate into it.
  213.  
  214.  
  215.  
  216. I wish to thank all those who have encouraged me on the development of
  217. Check PC and especially to those who have asked for features and gave me
  218. the necessary information to actually do it.  Without the explanations on
  219. a few things, some of the features would not have been added.  I may have a
  220. dish, but I don't utilize all the stuff that comes in. <g>
  221.  
  222.  
  223.