home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / H_RUCK10.ZIP / H-RUCK.DOC < prev    next >
Text File  |  1993-11-03  |  8KB  |  227 lines
  1.      
  2.  
  3.  
  4. H-Ruck, Hack Report Upload Checker, Copyright 1993, Maritime Computer Services
  5.  
  6.  
  7.         The "Hack Report," is of course, the one and only Hack Report,
  8. created monthly by Lee Jackson and the FidoNet International Echos 
  9. Shareware and Warnings (1:124/4007).  A special thanks to Lee Jackson
  10. and the rest of the Hack Squad for providing us with this invaluable
  11. service, of which makes this program possible.
  12.  
  13.         I created the program out of personal need for my board, and
  14. that is mainly to protect myself and my users from dangerous files. I
  15. searched for a program to do what this one does, but was unable to find
  16. one suitable for PCBoard.  There are hack searchers and hack mergers,
  17. but not a hack report upload checker...until now.  ;-)
  18.  
  19. OK, down and dirty-
  20.  
  21.  Files that you should have in this archive:
  22.  
  23.                 H-RUCK.EXE       The program executable
  24.                 H-RUCK.DOC       This file
  25.                 H-RUCK.CNF       Configuration File
  26.                 HISTORY.DOC      Version history 
  27.                 FILE_ID.DIZ      Description file
  28.                 ORDER.FRM        Order form for registration  
  29.                 PCBTEST.BAT      Sample PCB batch file
  30.                 UPGRADE.DOC      How to upgrade from previous version
  31.  
  32.  Files you will need:
  33.  
  34.                 The most recent version of the Hack Report.  The file
  35.       name convention of the archive is HACK9308.ZIP.
  36.                                             YRMO
  37.                                           (YearMonth)
  38.  
  39.                 Specifically, you will need the HACK92FA.IDX file, and
  40.       until 1994, will probably want the HACK9308.COL file.  When it
  41.       becomes obsolete, H-Ruck is ready for that too.
  42.  
  43.  
  44.  General Overview:    (Details to come later)
  45.  
  46.  
  47.         1.  Ensure that PCBoard is set to test uploads.  If you already
  48.             test uploads, don't worry about it.  If not, it's a switch
  49.             in PCBSetup.
  50.  
  51.         2.  You will need to alter your PCBTEST.BAT file, the batch
  52.             file that PCB uses to execute any upload testing.  There
  53.             is a sample PCBTEST.BAT included that shows how to use it
  54.             with Ziplab, a GREAT upload checker by Jeff Morley.
  55.  
  56.         3.  You will need to create a seperate directory for H-Ruck.
  57.  
  58.         4.  You will need to customize the Configuration file.
  59.  
  60.         5.  You will need to send me money, so you can get rid of that
  61.             nasty UNREGISTERED and 10 second pause.   (grin)
  62.  
  63.  
  64.  
  65. Steps to setting it up:  (It's really quite easy)
  66.  
  67.  
  68.         1.  Make a directory for H-Ruck.  I suggest :\PCB\HRUCK , but
  69.             you can put it anywhere you like.
  70.  
  71.         2.  Take a look at your PCBTEST.BAT file.  Take a look at my
  72.             PCBTEST.BAT file.  This is the part where system differences
  73.             come in to play.  Hopefully, since you are a sysop, you are
  74.             fairly familiar with batch files.  If you know anything 
  75.             about errorlevels, thats even better.  If you don't, not to
  76.             worry, you can still set this up.  Here are a few facts you
  77.             need to know:
  78.  
  79.             In the PCBTEST.BAT file, PCBoard passes the following 
  80.             parameters:
  81.  
  82.                 %1     the filename
  83.                 %2     the word UPLOAD or the word TEST
  84.  
  85.  
  86.             The only time %2 will not be UPLOAD is when a user invokes
  87.             the Test command from PCBoard.
  88.  
  89.  
  90.             The following errorlevels are used by H-Ruck:
  91.  
  92.             errorlevel 95 means the file PASSED
  93.  
  94.             errorlevel 1  means the file FAILED
  95.  
  96.  
  97.  
  98.             When H-Ruck is invoked from the PCBTEST batch file, it
  99.             uses the following command line:
  100.  
  101.  
  102.             Drive\Path\H-RUCK.EXE Drive\Path\H-RUCK.CNF %1 %2 
  103.             
  104.             For example, if H-Ruck is in the c:\pcb\h-ruck directory:
  105.  
  106.             c:\pcb\h-ruck\h-ruck.exe c:\pcb\h-ruck\.cnf %1 %2
  107.  
  108.  
  109.  
  110.             Based on the above, here is a sample PCBTEST.BAT to run
  111.             H-Ruck along with Ziplab:
  112.  
  113.  
  114. @echo off
  115. c:\pcb\h-ruck\h-ruck c:\pcb\h-ruck\h-ruck.cnf %1 %2
  116. if errorlevel == 95 goto ziplab
  117. if errorlevel == 1 goto end
  118. goto end
  119.  
  120. :ziplab
  121. c:\ziplab\zlab.exe %1 c:\pcb c:\ziplab %2
  122.  
  123. :end
  124. cd c:\pcb
  125. if exist h-ruck.txt copy h-ruck.txt pcbpass.txt > nul
  126. if exist h-ruck.txt del h-ruck.txt > nul
  127.  
  128.  
  129. *************The last 3 lines are new!  They MUST now be added!*************
  130.  
  131.  
  132.  
  133.         Now, if errorlevel is 95, meaning the file passed, it now is
  134. sent to Ziplab (or your checker of choice).   If it fails, it skips to
  135. the end, since there is no need for ZipLab to look at it.  In fact, do
  136. NOT let another checker look at it if it already failed (errorlevel 1).
  137.  
  138.  
  139.         3.   All you have to do is modify the 7 line CNF file, which is
  140.         self-documented, BTW.    
  141.  
  142.  
  143.                 Line 1:   Put your BBS name here
  144.  
  145.                 Line 2:   Put Your name here
  146.  
  147.                 Line 3:   Put your registration code here.
  148.                           If unregistered, leave it as 0.
  149.  
  150.                 Line 4:   Put your main pcb directory here.
  151.                           (ex.   c:\pcb  )
  152.  
  153.                 Line 5:   Put the H-Ruck directory name here.
  154.                           This would be the one you just made.
  155.                           (ex.   c:\pcb\h-ruck  )
  156.  
  157.                 Line 6:   Put the name of the Hack Report IDX
  158.                           file here.  Not the path, just the name.
  159.                           (ex.  HACK92FA.IDX   )
  160.  
  161.                 Line 7:   You have a choice.  Either put the name
  162.                           of the Hack Report COL file here,
  163.                           (ex.  HACK9308.COL   ) or if you choose
  164.                           not to use it put the word NONE in all
  165.                           caps.  Soon enough you will be forced
  166.                           to do this since it is being discontinued.
  167.  
  168.  
  169.                
  170.         4.  You must put the IDX file and the COL file in the H-ruck 
  171.             directory.  Let me repeat, ALL of the files in this archive
  172.             must be in the H-Ruck directory AND the IDX file AND the COL
  173.             file (if that one is used).
  174.  
  175.             Of course, you will want to replace these files as they are
  176.             updated by the Hack Squad, and when you do, REMEMBER to change
  177.             the NAMES in the CONFIGURATION file (H-RUCK.CNF).
  178.  
  179.         5.  You're done.  Just test it yourself before opening it up to
  180.             the masses.
  181.  
  182.  
  183.  
  184.  
  185.  This program is fully functional and not crippled in any way.  I only ask 
  186.  that if you use it, please register it. H-Ruck is shareware, not freeware.
  187.  
  188.  Registration is ONLY  $10.00 (US) - help support shareware authors!
  189.  
  190.  Registration will also give you extended access to our support BBS, and
  191.  free upgrades of newer versions - and there will be newer versions with
  192.  more functions.   
  193.                         
  194.                         
  195.                         The Glazer's Guild BBS
  196.                            (804) 739-9315
  197.  
  198.                         Maritime Computer Services
  199.                              PO Box 1846 
  200.                           Midlothian, VA 23113    
  201.  
  202.  
  203.  
  204.  
  205.  To register, please send check or money order to the above address. You
  206.  will receive access to the Guild, and free updates for new versions.
  207.  Please include the program name, version number, along with your pertinent
  208.  information : (name, address, phone, etc.).  Please use the order form,
  209.  ORDER.FRM for faster processing on your registration.
  210.  
  211.  *** Registration will remove the 10 second delay and will remove the
  212.  *** UNREGISTERED message and replace it with your Board Name.
  213.  
  214.  
  215.  
  216.  DISCLAIMER:
  217.  
  218.  We ("Maritime Computer" or "Michael W. Graham") are not responsible 
  219.  for any damages of any kind, including profit losses and data losses, 
  220.  that relate directly or indirectly to these programs and files.  
  221.  You may distribute this program, as long as it is in unmodified form 
  222.  with all the files originally included.  Do not "reverse engineer" or 
  223.  unassemble this program.
  224.  
  225.  This program and associated files may not be distributed for a fee
  226.  without express written consent from the author.
  227.