home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / bbsutils / ziplab9.arj / ZIPLAB.DOC < prev   
Text File  |  1991-06-12  |  16KB  |  298 lines
  1.                         
  2.                    ZipLab IX - Another ZIPLab in Paradise
  3.                    (C)Copyright 1991 by Jeffrey S. Morley
  4.                              June 11th, 1991
  5.  
  6.                    PCBTest.Bat enhancer for PCBoard 14.5
  7.  
  8.                    
  9. ZipLab IX is a alternative/replacement for the normal PCBTEST.BAT file 
  10. which is run by PCBoard after a user uploads file(s).  In the past, we have 
  11. all run maybe PKUNZIP -T on each file, and if there were no CRC erorrs, all 
  12. was considered well.  There is a lot more we can do to protect ourselves and 
  13. our users from unwanted files!  ZipLab will do the following:
  14.  
  15. * Test for CRC errors in the .ZIP file.
  16. * Test for imbedded .ZIP files and if found, CRC check those too.
  17. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  18. * Virus SCAN imbedded EXE and COM files, using SCAN.EXE from McAffey.
  19. * Remove all .ZIP comments from the file.
  20. * Replace .ZIP comments with your own. (Optional)
  21. * Delete unwanted BBS ads and/or other unwanted ZIP members as you define.
  22. * Test .GIF files for validity if you accept that file format (Optional)
  23. * Reject programs older than a date (year) which you specify.
  24. * Adds most recent .ZIP member date to the description (Optional)
  25.  
  26. *******************************************************************************
  27.           
  28.  ******** A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE! *********
  29.  
  30. REQUIRED:
  31. You must already have the following programs:
  32.  
  33. PKZIP.EXE   - Phil Katz archive create program (version 1.01)
  34. PKUNZIP.EXE - Phil Katz archive extract program (version 1.01)
  35. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
  36. SCAN.EXE    - McAffey's virus detection program (any version)
  37.  
  38. There are other small utility programs which I have bundled with this .ZIP.
  39. Those which were not written by me may require registration for continued
  40. use.  PLEASE SUPPORT SHAREWARE AND DO SO!
  41.  
  42. RECOM.EXE   - Mike Loewen's ZIP file comment remover and date stamper.
  43. TESTGIF.EXE - Dave Navarro's .GIF file tester (part of GIFTST30.ZIP)
  44. DELF.COM    - A version of DEL with no "Are you sure?" prompt written by me.
  45.               (No registration required)
  46.  
  47.  
  48. Quick Start ---
  49.  
  50. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is limited
  51.   memory available for PTEST.EXE.  If you are running in a multitasking 
  52.   or other memory constrained situation, PTEST may not work!  You should 
  53.   have at least 210k free memory when shelled out of PCBoard.  If this is
  54.   a problem, you may want to consider the VAROOM (overlay) version of 
  55.   PCBoard, which runs in considerably less memory than the standard PCB.EXE.
  56.   
  57.   The other option is to run PCBoard with the SET PCB = /SWAP environment
  58.   variable.  This will cause PCBoard to "swap" its code to the best available
  59.   storage (EMS, DISK) whenever a SHELL function (external protocol, viewfile,
  60.   and even DOORs if you have the SHELL column in DOORS.DAT(LST) set to "Y")
  61.   is called.  This method will cause a slight delay when SHELLing, but will
  62.   provide the largest amount of available DOS memory for your external code.
  63.   
  64. * Place the PTEST.EXE, SETUP.EXE and DELF.COM files into a directory which is
  65.   in your DOS PATH.
  66. * UnZIP the enclosed supplemental utilities into directories in your DOS PATH.
  67.   Make note of where you put them, you will need this information later.
  68. * Change to your PCBoard HOME directory (C:\PCB for many) and run SETUP.EXE.
  69.   The resulting PTEST.CFG must reside in your PCBoard home directory.
  70. * Fill in the following information when prompted by SETUP.EXE:
  71.  
  72.         -  The type of modem HANDSHAKE you desire.  This can be 
  73.            0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
  74.            (Use 2 or 3 with an error correcting modem...)
  75.         -  The name of your BBS system.  43 characters maximum.
  76.         -  The DRIVE and PATH to the directory where rejects will be
  77.            placed pending manual sysop inspection.
  78.         -  The date (yyyy) which will be the minimum acepted year.  ZIPs
  79.            containing files older than this will be rejected.
  80.         -  A "Y" if you wish the "recent date" notation added to the file
  81.            descriptions.  A "N" if you do not wish this addition.
  82.         -  The fully qualified filename of the zip comment to add, or
  83.            type "NONE" if you don't want to add a comment.
  84.         -  Full DRIVE:\PATH to PKZIP.EXE.
  85.         -  Full DRIVE:\PATH to PKUNZIP.EXE.    
  86.         -  Full DRIVE:\PATH to TDCHECK.EXE.
  87.         -  Full DRIVE:\PATH to SCAN.EXE.
  88.         -  Full DRIVE:\PATH to RECOM.EXE.
  89.         -  Full DRIVE:\PATH to TESTGIF.EXE (Just lie to it if not using)   
  90.            (I need these spelled out becuase the method I am using 
  91.             to get ERRORLEVELS returned to the program requires it.)
  92.         -  A list, each on one line, of any extensions (.GIF, .TXT etc)
  93.            Which will be passed without normal ZIP testing.  Any 
  94.            extensions other than .ZIP which do not appear in this .CFG
  95.            file will be rejected by the process.  The "." is optional.
  96. NEW!!!     If .GIF appears in this list, TESTGIF will be used to test
  97.            the integrity of the .GIF file.
  98.         -  A list, each on one line, of files which you wish deleted
  99.            from .ZIP's before posting.  This could include the famous
  100.            "READMEOR.DIE", "BBS.AD", or other unwanted advertising.
  101.  
  102.             Sample PTEST.CFG file:
  103.             
  104.             2           
  105.             The Interconnect BBS
  106.             M:\HOLD
  107.             1990
  108.             Y
  109.             C:\EXE\COMMENT.CMT
  110.             C:\ZIP\PKZIP.EXE
  111.             C:\ZIP\PKUNZIP.EXE
  112.             C:\ZIP\TDCHECK.EXE
  113.             C:\DIAGS\SCAN.EXE
  114.             C:\EXE\RECOM.EXE
  115. NEW!!!      C:\EXE\TESTGIF.EXE
  116.             .ROM
  117.             .GIF
  118.             ANNOYING.BBS
  119.             README.TOO
  120.  
  121. * Edit your existing PCBTEST.BAT file, and delete the whole thing except
  122.   for two lines:
  123.   
  124.   Sample PCBTEST.BAT file:
  125.   
  126.   @ECHO OFF
  127.   PTEST %1
  128.    
  129. * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass 
  130.   command over to PTEST.EXE with the parameter containing the path
  131.   and name of the file to be tested.  PTEST will check out the file,
  132.   placing any rejects in the holding directory you specified in the
  133.   SETUP process above.  
  134.  
  135.   
  136. * NEW IN THIS VERSION!!! ******************************************************
  137.  
  138. ZipLab IX     - A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE!
  139.                 Added the ability to test .GIF files if ".GIF" is found as
  140.                 one of the accepted formats in PTEST.CFG.  I am using a
  141.                 small utility called TESTGIF.EXE which was written by 
  142.                 DAVE NAVARRO.  This is a shareware program, and it is 
  143.                 expected that you will register this package if you use it.
  144.                 I have bundled the entire GIFTST30.ZIP package with ZipLab,
  145.                 and documentation for registering it is included.  If you
  146.                 do NOT accept .GIF files on your board, just delete the
  147.                 GIFTST30.ZIP file, and no registration is required.  ZipLab
  148.                 does not require this program to be available if you are
  149.                 not going to be testing .GIF files.  See the "Quick Start"
  150.                 section above on where the TESTGIF.EXE information is entered
  151.                 into PTEST.CFG.  Even if you do NOT plan to use TESTGIF.EXE,
  152.                 you must enter a DRIVE:\PATH while in SETUP.EXE.  Just lie
  153.                 to  it...
  154.                 
  155.                 A complete rework of the output screens in this version.  I
  156.                 hope you like the new look.
  157.                 
  158.                 USER PROBLEMS AND SUGGESTIONS:
  159.                 
  160.                 A problem which would crop up if you didn't have DELF.COM
  161.                 (a small DEL clone with no "Are you sure?" prompt I wrote
  162.                 and included) in the DOS path.  Please be sure to have 
  163.                 DELF.COM in your path somewhere.  An entry in PTEST.CFG is
  164.                 not required, as I do not expect ERRORLEVELs to be returned
  165.                 by DELF. 
  166.                 
  167.                 You MUST run PTEST.EXE while in your PCBoard root (C:\PCB?)
  168.                 directory.  The PTEST.CFG file MUST be in this directory,
  169.                 although PTEST.EXE itself can be anywhere in the DOS path.
  170.                 Do not have PCBTEST.BAT change you to a C:\PTEST directory
  171.                 and run from there.  Nice idea, but it won't work. 
  172.                 
  173.                 Lots of people have asked if I could either port ZipLab to
  174.                 one or more of their favorite BBS software types, or create
  175.                 a "generic" version.  If those interested will be kind 
  176.                 enough to send me the files and file layouts required to
  177.                 get PCBOARD.SYS'ish information from other software types,
  178.                 I will be glad to create specific versions.  A generic 
  179.                 version may be the eventual outcome of these efforts.
  180.                 Send files to me here at the Interconnect BBS (703-425-2505).
  181.                 Start the description of the file with a "/" to make it
  182.                 a private upload, and be sure to include in the ZIP a text
  183.                 file explaining 1) Who you are, and where I can get ahold
  184.                 of you.  2) What BBS type we are talking about, and what the
  185.                 differences from PCBoard are that you know of.  3) The 
  186.                 appropriate files from which I can get information while a
  187.                 user is "shelled" out in an external process.  4) The file
  188.                 layouts of these files, with contents, lengths and data types.
  189.  
  190. ZipLab VIII   - NO CHANGES TO YOUR .CFG FILE IS REQUIRED FOR THIS RELEASE!
  191.                 Changed the format of the "date" line added to the DIRxx 
  192.                 file description.  Several users requested that both the
  193.                 newest AND the oldest date be indicated.  Done.
  194.                 
  195. ZipLab VII(a) - NO CHANGES TO YOUR .CFG FILE IS REQUIRED FOR THIS RELEASE!
  196.                 Bug fix version only.  There was a problem in the logic with
  197.                 the new internal date verification.  Two things were happening.
  198.                 The first was that any ZIP which contained only one file was
  199.                 failing.  Fixed.  The second was that the OLDEST file in the
  200.                 ZIP was being used for the comparison, not the newest.  Fixed.
  201.  
  202.                 The other addition to this release is the ability to change 
  203.                 the default location that PTEST.EXE uses to unzip files for
  204.                 testing with SCAN.EXE.  PTEST will normally create a directory
  205.                 under your PCB root directory called ..\PTEST.DIR and will 
  206.                 kill this directory when done.  If you wish to have this 
  207.                 work carried on someplace else, set up an environment 
  208.                 variable called ZIPLAB, and put the drive and path there.
  209.                 
  210.                 Example:  ZIPLAB=D:\WORK
  211.                  
  212.                 You may wish this change if your PCB drive is quite small, 
  213.                 or if you wish the work to take place on a virtual disk for
  214.                 speed.  
  215.                 
  216. ZipLab VII    - PTEST.CFG FILE HAS CHANGED!!!  YOU MUST RUN SETUP.EXE AGAIN TO
  217.                 CREATE THE CONFIG FILE.  DON'T FORGET THIS STEP, OR NOTHING   
  218.                 WILL WORK!
  219.              
  220.                 I have eliminated the need for the TESTAGE.EXE program from 
  221.                 the process.  All testing of the dates of the various .ZIP
  222.                 file members is now built into the code.   Boy did I have a 
  223.                 good time figuring out how to turn 5781 into 04/21/1991!
  224.                 
  225.                 As a side-benefit, I now allow you the option of adding a  
  226.                 notation "Date of most recent .ZIP member >> mm/dd/yyyy" to
  227.                 the file description as posted by PCBoard.  This notation
  228.                 will be generated and added by ZipLab if a "Y" is included
  229.                 in the appropriate field in PTEST.CFG.  Place a "N" in this
  230.                 field to bypass this option.
  231.                 
  232.                 Also as a side-benefit, the date of the most recent file will
  233.                 be displayed by ZipLab when a .ZIP passes the age verification,
  234.                 and both the most recent and oldest will be displayed when a
  235.                 .ZIP fails.
  236.                 
  237. ZipLab VI     - No changes to the .CFG file this version.  You need to nothing
  238.                 except replace the PTEST.EXE file.
  239.                 
  240.                 AAARGH!  Missed a hard-coded directory spec I left in the code.
  241.                 (I had put it in during the debug process.).  Unless you were
  242.                 lucky enough to have an "M:\HOLD" directory, all files that 
  243.                 failed the age test were being erased instead of moved.  Fixed.
  244.                 
  245.                 Added the bell (or is it whistle?) of having the first line of
  246.                 the description displayed while the file is testing.  Thanks go
  247.                 to Paul Beda for reminding me that the description is available
  248.                 during the PCBTEST process.  Try his RFUPDESC program to change
  249.                 the column 34-78 descriptions into full line ones.
  250.                 
  251. ZipLab V      - PTEST.CFG FILE HAS CHANGED!!!  YOU MUST RUN SETUP.EXE AGAIN TO
  252.                 CREATE THE CONFIG FILE.  DON'T FORGET THIS STEP, OR NOTHING 
  253.                 WILL WORK!
  254.                 
  255.                 This version now supports users in NON-COLOR mode.  ZipLab will
  256.                 detect these users, and will not display any colors.  The user
  257.                 MUST STILL HAVE ANSI.SYS LOADED!  ANSI codes are used for moving
  258.                 the cursor.  If you have lots of users calling in with non-DOS
  259.                 machines which can't support ANSI, don't use ZipLab.
  260.                 
  261.                 Somewhat against my better judgement, you may now ADD a zip
  262.                 comment to the file while testing.  There is an additional 
  263.                 line added to PTEST.CFG.  If you can resist the urge to mess
  264.                 with the .ZIP, please put "NONE" in this field.
  265.                 
  266.                 Fixed some problems with TestAge, including a bad compile which
  267.                 was mistakenly sent out in some ZipLab IV packages.  
  268.                 
  269.                 Added the /NOMEM command to the call to SCAN.EXE, so your local
  270.                 RAM memory won't be tested every time.  This will speed things
  271.                 up quite a bit.
  272.                 
  273. ZipLab IV     - This version of ZipLab is now an EXE file, instead of a series 
  274.                 of batch commands.  This was done to speed the process up.  The 
  275.                 batch file method, while effective and flexible, was very slow.  
  276.                 Many users were becoming discouraged waiting on large, 
  277.                 multi-file uploads to be tested. 
  278. *******************************************************************************
  279.  
  280.   
  281. This program was written in QuickBasic 4.5, with some help from Hammerly 
  282. Computing's ProBas 4.01.  I have also included a few utilities which PTEST 
  283. will use in the course of testing.  These utilities are the property of the 
  284. authors, and you are strongly requested to register them if you continue to 
  285. use PTEST.EXE.  There is no registration required for PTEST itself, nor for 
  286. any of the little utilities included which were written by me.
  287.  
  288.  
  289. Jeffrey S. Morley
  290. The Interconnect BBS
  291. (703)425-2505
  292.  
  293. * PTEST.EXE, SETUP.EXE, and DELF.COM are my own creations, and no
  294.   registration is required.  They are all:
  295.   (C)Copyright 1989-1991 by Jeffrey S. Morley
  296.   
  297.  
  298.