home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / EXZIP204.ZIP / EXZIP.DOC < prev    next >
Text File  |  1991-06-15  |  49KB  |  964 lines
  1.  
  2.  
  3.                                  <=  ExZip  =>
  4.  
  5.                 Part of the EXpert series programs available at
  6.  
  7.                    The Executive Network Information System
  8.                                 (914) 667-4567
  9.  
  10.                   ------------------------------------------
  11.  
  12.                       Copyright 1988-1991 by Andy Keeves
  13.  
  14.  
  15.  
  16.  
  17. Welcome to ExZip!
  18. ──────────────────────────────────────────────────────────────────────────────
  19.  
  20.         OK, just what the devil is ExZip you ask.  ExZip is a rather simple
  21. program to help with the re-compressing of files.  It was born primarily to
  22. answer the need of a BBS SysOp who receives a fair number of files, some of
  23. which may be damaged or compressed with an older and less efficient program,
  24. or ZIPed with compression methods other than the ones desired.  Many of the
  25. features found in ExZip are geared toward BBS operators, but I hope that it
  26. can be of some value to others as well.
  27.  
  28.         ExZip has the ability to pick out any files from a given subdirectory
  29. that are dated with today's or yesterday's date and reZIP them all in one
  30. pass using PKZIP.  Simple, no?  This makes it an ideal program for unattended,
  31. overnight processing.  All you need is a simple configuration file to tell it
  32. where your files are.  There are a few other variables you can use, this way
  33. nearly anyone can use it effectively, not only Sysops.
  34.  
  35.         Besides selecting new or all files and reZIPping them ExZip has the
  36. ability to check the ZIP file for integrity, remove ZIP comments from it,
  37. remove file attributes, check for virus infection, check for file duplication,
  38. adjust PCBoard directory descriptions and like wonders.  A lot of this is done
  39. through the use of other programs making ExZip somewhat version independent
  40. when it comes to things such as ZIP formats, virus checkers and the like.
  41.  
  42.         ExZip is a successor to ExArc and it offers the ability of automatic
  43. and full featured conversion from .ARC to .ZIP formats.
  44.  
  45.  
  46.  
  47. If you have used ExZip before..
  48. ──────────────────────────────────────────────────────────────────────────────
  49.  
  50.         ExZip version 2.0 introduces a fullfeatured setup program and a
  51. totally new configuration file format!  The configuration file used by version
  52. 2.0 (or later versions) is NOT COMPATIBLE WITH EARLIER VERSIONS!  Do not
  53. attempt to read an old configuration file with the new software or the other
  54. way around!!  At the least, the results shall be undesirable!
  55.  
  56.         The ExZip 2.0 configuration file was designed with upward
  57. compatibility in mind.  ExZip and ExZSetup will automatically recognize file
  58. formats starting with this version and handle any required upgrading for you.
  59.  
  60.         You can share a single configuration file between ExZip and ExZTest if
  61. so desired.  After all, most of the parameters are the same or similar.
  62.  
  63.  
  64.  
  65. Distribution and License!!   Please read this!
  66. ──────────────────────────────────────────────────────────────────────────────
  67.  
  68.         ExZip is published as AdWare!  What?  You do not know what AdWare is?
  69. Under the AdWare concept you are free to use it and distribute it as long as
  70. you meet the following conditions:
  71.  
  72.      a)   You do not charge for it.  No fees of any sort are
  73.           authorized to be asked for, accepted or collected!
  74.      b)   Any and all alterations to the program or
  75.           documentation are expressly prohibited!  You may,
  76.           however, post the program on your system in the format
  77.           you prefer (i.e. .ZIP or .ARC or whatnot).
  78.      c)   You may not add any files to the ZIP file or other
  79.           compressed distribution file you may be using,
  80.           including your own bbs ad, and similarly, you may not
  81.           remove any file from the content, including my bbs ad!
  82.      d)   i.   If you operate a BBS and decide to use ExZip for
  83.                your BBS, under the concept of AdWare you are
  84.                required to post the enclosed BBS ad for the
  85.                Executive Network at least once in a message base
  86.                designated for BBS ads (if you have one) or on
  87.                your Main Board for a minimum of 7 days.
  88.           ii.  If you do not operate a BBS, under the concept of
  89.                AdWare you are required to post the enclosed BBS
  90.                ad for the Executive Network on three (3)
  91.                bulletin board systems, other than the Executive
  92.                Network, of course, in the main message area or
  93.                an area specifically designated for that purpose
  94.                by the operator.  DO NOT post our ad on systems
  95.                which prohibit the posting of BBS ads!
  96.  
  97.         I must also add here that there are no warranties of any sort,
  98. expressed or implied, that accompany this program.   Use at your own risk.
  99.  
  100.         Sorry.  If you feel that the above points are not agreeable to you,
  101. simply delete the file from your system.  Pretty easy, don't you think?
  102. Should you feel that you absolutely must pay for ExZip, send a few $$ to your
  103. favorite BBS Sysop - believe me, all Sysops can use it, since running a board
  104. is NOT cheap!  Please remember that I will try to fix problems as reported I
  105. will do so at my convenience as time is available.  This program is made
  106. available to you at no real cost or investment which should be considered
  107. when requesting "support".
  108.  
  109.  
  110.  
  111. Features summary.
  112. ──────────────────────────────────────────────────────────────────────────────
  113.  
  114.         ExZip is controlled through a configuration file.  The supplied
  115. ExZSetup program MUST be used for setting it up!  DO NOT try to edit the
  116. configuration file with a text editor!  It will NOT work!
  117.  
  118.  
  119. General features:
  120.  
  121.      o    Up to 50 paths where the files are located.
  122.      o    Conversion from ARC to ZIP, including nested files.
  123.      o    Full activity and error logs.
  124.      o    Checking for viruses and associated file disposition.
  125.      o    Optional use of up to 5 different virus checking
  126.           programs.
  127.      o    Optional use of duplicate checking and related disposition.
  128.      o    Full featured setup program.
  129.      o    Fully networkable operation.
  130.      o    Optional bypassing of files generated by you.
  131.      o    Unwanted file removal from ZIPs (TCAN).
  132.      o    Automatic removal of ZIP comments.
  133.      o    Alternate ZIP and ARC programs.
  134.      o    Your choice of ZIP options for compression.
  135.      o    Read Only and Hidden file handling.
  136.      o    Adding a standard ZIP comment.
  137.      o    Full self-check and anti-virus protection.
  138.      o    File Id stamping to recognize files already processed,
  139.           even if they would normally qualify for your date
  140.           range.
  141.  
  142.  
  143. Features for BBS operators:
  144.  
  145.      o    Directory files for PCBoard, including names, file
  146.           sizes and dates.
  147.      o    Damaged file disposition options and matching notation
  148.           for PCBoard sysops.
  149.      o    Enhanced file creation/write routines written in
  150.           assembler for added speed.
  151.      o    Full error checking and handling, including full
  152.           network compatibility, when processing PCBoard's DIRnn
  153.           files to allow safe operation in a network
  154.           environment.
  155.      o    Can interact with PCBoard's private upload directory
  156.           and move both, files and descriptions to a specified
  157.           public upload directory upon successful processing.
  158.      o    Full duplicate checking through third a third party program with
  159.           detailed reporting.  Duplicate checking is done based on CRC-32
  160.           values, not file just file names.
  161.  
  162.  
  163.  
  164. The use of external programs
  165. ──────────────────────────────────────────────────────────────────────────────
  166.  
  167.         ExZip now incorporates the use of some programs written by
  168. other authors.  One of these programs is STRIPZIP, written by
  169. Ken Brown, made available to everyone free, as POSTWare.  If you
  170. use it, DO send him a postcard to THANK him for a terrific job!
  171. StripZip should be available on most BBSs.  
  172.  
  173.         The second of these is VIRUSCAN from McAfee Associates.
  174. Please note that ViruScan is NOT a free program!  As with all ShareWare,
  175. please register it if you are going to use it!  This program can be
  176. found on most BBSs listed as SCANxxxx.ZIP, including the Executive
  177. Network, of course.  Although we have received permission from McAfee
  178. Associates to include SCAN with the ExZip distribution file, we elected
  179. not to do so (with the exception of one release) due to the frequency
  180. of upgrades for this product.
  181.  
  182.         For duplicate checking introduced in version 2.0 ExZip interfaces
  183. Fred Kantor's FWKCS program.  Please note that this program is Shareware as
  184. well and if you elect to use it you might as well register it.  The moeny you
  185. will send for it will be more than saved in disk space recovered!
  186.  
  187.         Although ExZip incorporates only a small amount of code for
  188. self-testing, it is quite capable to detect an attemptd virus attack on
  189. itself.  Should this occur, the code will immediately lock up the machine it
  190. is running on in order to prevent any further spreading of the possible virus.
  191. Please remember that ExZip does not look for nor does it detect a virus
  192. anywhere unless the virus attacks ExZip itself!
  193.  
  194.  
  195.  
  196. Getting started and setting up
  197. ──────────────────────────────────────────────────────────────────────────────
  198.  
  199.         ExzSetup will do most of the work for you initially.  Remember that
  200. this manual is not intended to teach about the use of PCBoard or other
  201. programs with which ExZip might interface.  You must have a working knowledge
  202. of these before you get started here!
  203.  
  204.         ExZSetup can be executed by simply typing "EXZSETUP" at the DOS prompt
  205. or by specifying the drive, path and name of the configuration file you wish
  206. to create or edit.  For the rest of this document we will assume that you are
  207. using the name EXZIP.CFG which will be located in the current path.  Once you
  208. typed EXZSETUP you will get a small selection menu as follows:
  209.  
  210.  
  211.           ┌─────────────────────────────┐
  212.           │ ExZip run time parameters   │
  213.           │ ExZTest run time parameters │
  214.           │ ─────────────────────────── │
  215.           │ Quit ExZSetup               │
  216.           └─────────────────────────────┘
  217.  
  218. Press ENTER to create/edit the EXZIP.CFG configuration file. The bottom line
  219. of your screen will be a status line with brief instructions for you:
  220.  
  221.  
  222.  04:54:45 pm │ Esc: Exit/Backup │ Space: Toggle │ Cursor keys: Move │ CAP
  223.  
  224.  
  225. The right side of the line will reflect the status of your Caps Lock and Num
  226. Lock keys while the left side will reflect the then current system time. The
  227. middle portion will indicate the usage of various control keys.  If your
  228. configuration file does not exist you will be asked if you want to create it:
  229.  
  230.  
  231.  
  232.  ┌[ File access error ]─────────────────────────────────────────────┐
  233.  │ Problem:  File not found or invalid!                             │
  234.  │ Target :  EXZIP.CFG                                              │
  235.  │ Action :  Create new file now (Y/N)?  _                          │
  236.  └──────────────────────────────────────────────────────────────────┘
  237.  
  238. Press "Y" to confirm and proceed.  You are now displayed the main options menu
  239. which are applicable to the operation of EXZIP.
  240.  
  241.  
  242.  ┌─────────────────────────────┐
  243.  │ ExZip run time parameters   │
  244.  │ ExZTest run time parameters │
  245.  │ ────────╒══════════════════════════════════╕
  246.  │ Quit ExZ│ Virus checking                   │
  247.  └─────────│ Duplicate checking               │
  248.            │ File attribute handling          │
  249.            │ ──────────────────────────────── │
  250.            │ Disposition of damaged files     │
  251.            │ Disposition of virus infections  │
  252.            │ ──────────────────────────────── │
  253.            │ ZIP comment insertion            │
  254.            │ Compression programs             │
  255.            │ Process files in .ARC format     │
  256.            │ Use ANSI colors in DOS           │
  257.            │ Activity log file                │
  258.            │ ──────────────────────────────── │
  259.            │ Paths to process                 │
  260.            │ Supporting files                 │
  261.            │ Index file specifications        │
  262.            ╘══════════════════════════════════╛
  263.  
  264.  
  265. You can move around the menu with your up and down arrow keys, page up and
  266. page down and you may leave the menu by pressing the escape key. Once you have
  267. positioned yourself to the item you wish to edit simply press the ENTER key to
  268. proceed.  Most menus and options that follow will require the use of the
  269. cursor control keys though a few will also require typing.  We will take each
  270. selection as they appear on the menu above.
  271.  
  272.  
  273.  
  274. Checkin for virus infection
  275. ──────────────────────────────────────────────────────────────────────────────
  276.  
  277.         You can have ExZip use up to 5 different programs to check for virus
  278. infections.  They must all have the ability to take all required parameters
  279. from the DOS command line and operate on all files in a specified path (passed
  280. to them by ExZip).  ExZSetup will give you the default command line for
  281. McAffe's Viruscan program:
  282.  
  283.  
  284.  ┌─────────────────────────────┐
  285.  │ ExZip run time parameters   │
  286.  │ ExZTest run time parameters │
  287.  │ ────────╒══════════════════════════════════╕
  288.  │ Quit ExZ│ Virus checking                   │
  289.  └─────────│ Duplic┌[ Virus detection ]─────────────────────────────┐
  290.            │ File a│                                                │
  291.            │ ──────│ Virus checking: ON                             │
  292.            │ Dispos│      Program 1: SCAN ! /NOMEM /A /X            │
  293.            │ Dispos│      Program 2:                                │
  294.            │ ──────│      Program 3:                                │
  295.            │ ZIP co│      Program 4:                                │
  296.            │ Compre│      Program 5:                                │
  297.            │ Proces│             ┌─────────────────────────────────┐│
  298.            │ Use AN└─────────────│    Space or Enter to toggle     │┘
  299.            │ Activity log file   │   Arrow keys to change lines    │
  300.            │ ────────────────────│          ESC to exit            │
  301.            │ Paths to process    └─────────────────────────────────┘
  302.            │ Supporting files                 │
  303.            │ Index file specifications        │
  304.            ╘══════════════════════════════════╛
  305.  
  306.  
  307.  
  308. Checking for and eliminating duplicates
  309. ──────────────────────────────────────────────────────────────────────────────
  310.  
  311.         This one becomes more complex!  ExZip v2.0 relies on Fred Kantor's
  312. FWKCS program to establish file duplications.  You need to have setup the
  313. database required by this software in order to use the duplicate checking
  314. options of ExZip.  Without going into a lecture on the use of this software
  315. we'll simply mention here that there are 4 basic files FWKCS works with. We
  316. will refer to them by their generic documented names.
  317.  
  318.         Please NOTE that ExZip v2.0 has been tested with FWKCS
  319. versions 1.05 (called FWKZCS and FWKCSF) and versions 1.06 through
  320. 1.08 ONLY!  IF YOU TRY TO USE VERSIONS OF THE FWKCS PROGRAM(s)
  321. OLDER OR NEWER THAN THE ONES DOCUMENTED HERE DO NOT COMPLAIN ABOUT
  322. INCONSISTENT OR ERRONEOUS OPERATION!
  323.  
  324.         If you toggle duplicate checking ON you will have to define a few
  325. other choices for ExZip.  In order to give you a better understanding of these
  326. we need to define what the definitions shown below mean.
  327.  
  328.         A "full, 100% duplicate" is a .ZIP file the contents of which already
  329. exists on your system.  The content may be in another single .ZIP or spread
  330. over several .ZIPs - we simply do not care.  If every file is already present
  331. somewhere we will consider it a FULL duplicate.  You may dispose of these
  332. files by deleting them or renaming them.  If you elect to rename ExZip will
  333. change the file's extention to .DUP for you.  You may toggle this choice by
  334. pressing the space bar once highlighted.
  335.  
  336.  ┌─────────────────────────────┐
  337.  │ ExZip run time parameters   │
  338.  │ ExZTest run time parameters │
  339.  │ ────────╒══════════════════════════════════╕
  340.  │ Quit ExZ│ Virus checking                   │
  341.  └─────────│ Dup┌[ Duplicate checking ]───────────────────────────────┐
  342.            │ Fil│                                                     │
  343.            │ ───│                                                     │
  344.            │ Dis│ Duplicate checking                     : ON         │
  345.            │ Dis│                                                     │
  346.            │ ───│   Disposition of full (100%) duplicates: D (Delete) │
  347.            │ ZIP│   Disposition of partial duplicates    : R (Rename) │
  348.            │ Com│   Minimum percentage to pass partial   :   (N/A)    │
  349.            │ Pro│   Sort program                         : QSORT      │
  350.            │ Use│   CSList1.SRT location & name          :            │
  351.            │ Act│            CSLIST1.SRT                              │
  352.            │ ───│   CSList1.NDX location & ┌─────────────────────────────────┐
  353.            │ Pat│            CSLIST1.NDX   │    Space or Enter to toggle     │
  354.            │ Sup│                          │   Arrow keys to change lines    │
  355.            │ Ind└──────────────────────────│          ESC to exit            │
  356.            ╘═══════════════════════════════└─────────────────────────────────┘
  357.  
  358.  
  359.         You have 3 possible choices for a partial duplicate.  A partially
  360. duplicated .ZIP file is one where at least one of the files within the .ZIP
  361. does not yet exist on your system.  Once again, you can toggle the choices for
  362. partial duplicate disposition by pressing the space bar once the selection is
  363. highlighted.  ExZip will not delete a partial duplication for you.  The most
  364. common partial duplication is a newer version of a file where some of the
  365. documentation has not changed.  You can rename the file and decide later or
  366. you can "pass" the file as is, making it available to your callers.  The 3rd
  367. choice is an automatic decision to be made by ExZip.  This is based on the
  368. percentage of duplication.  You may specify percentages on the next line
  369. starting with 10%.  If you were to specify 60%, a .ZIP file containing 10
  370. files inside would "pass" if 5 or less of the 10 files were duplicates and
  371. "fail" is 6 or more were duplicated.
  372.  
  373.         For sort program we default to the widely available QSORT although
  374. many others may be used.  The only requirement for the sort program is that it
  375. must be able to sort a file "in place".   We pass only one paramater to the
  376. sort routine, that being the file name.  When sort terminates we expect to
  377. find the same file in the same place, sorted.
  378.  
  379.         The CSLIST1.SRT and CSLIST1.NDX files are the generic names for 2 of
  380. the 4 files used/created by FWKCS.  You must enter the proper drive, path and
  381. file name here.  If ExZSetup does not find the specified file the name you
  382. entered will be flashing in red.
  383.  
  384.  
  385.  
  386. Handling file attributes in ZIPs
  387. ──────────────────────────────────────────────────────────────────────────────
  388.  
  389.         ZIP files have the ability to retain file attributes, such as Read
  390. Only which can do nasty things to your system.  We aim to remove these before
  391. doinganything with the file.  A program widely available on BBSs called
  392. STRIPZIP is the one we default to since it handles the task rather well. ExZip
  393. will insert the name of the file being processed whereever you type a pound
  394. sign (#) which makes this option reasonably flexible.  DO NOT overlook or
  395. underestimate the power of this option!  Too many Sysops have been burned by
  396. files extracted from a ZIP which could not be deleted and were added to other
  397. ZIPs later in the processing cycle!!
  398.  
  399.  ┌─────────────────────────────┐
  400.  │ ExZip run time parameters   │
  401.  │ ExZTest run time parameters │
  402.  │ ────────╒══════════════════════════════════╕
  403.  │ Quit ExZ│ Virus checking                   │
  404.  └─────────│ Duplicate checking               │
  405.            │ File attribute handling          │
  406.            │ ──────────────────────────────── │
  407.            │ Dispositi┌[ Attribute handling ]─────┐
  408.            │ Dispositi│                           │
  409.            │ ─────────│ STRIPZIP /R #             │
  410.            │ ZIP comme│          ┌────────────────────────────────────┐
  411.            │ Compressi└──────────│   Enter a single pound sign (#)    │
  412.            │ Process files in .AR│ where the .ZIP file name should be │
  413.            │ Use ANSI colors in D│  This is a full DOS command line   │
  414.            │ Activity log file   └────────────────────────────────────┘
  415.            │ ──────────────────────────────── │
  416.            │ Paths to process                 │
  417.            │ Supporting files                 │
  418.            │ Index file specifications        │
  419.            ╘══════════════════════════════════╛
  420.  
  421.  
  422.  
  423. Disposition of damaged or virus infected files
  424. ──────────────────────────────────────────────────────────────────────────────
  425.  
  426.         Both of these options are defined the very same way.  The pop-up
  427. screen offers you 4 choices through which you can move up and down with your
  428. arrow keys.  Once you highlighted the option you desire to use press ENTER or
  429. ESC to activate it.  Hopefully, the following illustration will be
  430. self-explanatory to most reading this..
  431.  
  432.  ┌─────────────────────────────┐
  433.  │ ExZip run time parameters   │
  434.  │ ExZTest run time parameters │
  435.  │ ────────╒══════════════════════════════════╕
  436.  │ Quit ExZ│ Virus checking                   │
  437.  └─────────│ Duplicate checking               │
  438.            │ File attr╔══════════════════════════════════════╗
  439.            │ ─────────║ Disposition of damaged files:        ║
  440.            │ Dispositi╚════════════════════┌─────────────────────────────┐
  441.            │ Disposition of virus infection│ Keep target file            │
  442.            │ ──────────────────────────────│ Delete target file          │
  443.            │ ZIP comment insertion         │ Overwrite with 0 byte file  │
  444.            │ Compression programs          │ Rename and keep file        │
  445.            │ Process files in .ARC format  └─────────────────────────────┘
  446.            │ Use ANSI colors in DOS           │
  447.            │ Activity log file                │
  448.            │ ──────────────────────────────── │
  449.            │ Paths to process                 │
  450.            │ Supporting files                 │
  451.            │ Index file specifications        │
  452.            ╘══════════════════════════════════╛
  453.  
  454.  
  455.  
  456. ZIP file comments
  457. ──────────────────────────────────────────────────────────────────────────────
  458.  
  459.         While we are very much against BBS ADS being inserted into ZIPs as
  460. files we have no real problems with comments being added to the ZIP file.
  461. Comments are easily removed by anyone (STRIPZIP mentioned above will
  462. automatically remove them for you!).  If you wish to add a ZIP comment of your
  463. own to files processed by ExZip you need to create a text file containing the
  464. comment to add.  Once you have done this you simply turn on the option in
  465. ExZSetup and specify the exact location and file name which contains the text.
  466.  
  467.  ┌─────────────────────────────┐
  468.  │ ExZip run time parameters   │
  469.  │ ExZTest run time parameters │
  470.  │ ────────╒══════════════════════════════════╕
  471.  │ Quit ExZ│ Virus checking                   │
  472.  └─────────│ Duplicate checking               │
  473.            │ File attribute handling          │
  474.            │ ──────────────────────────────── │
  475.            │ Disposition of damaged files     │
  476.            │ Disposition of virus infections  │
  477.            │ ──────────────────────────────── │
  478.           ┌[ Zip comment insertion ]─────────────────────────────────────┐
  479.           │                                                              │
  480.           │ In use  : NO                                                 │
  481.           │ Filename:                                                    │
  482.           │                                                              │
  483.           └──────────────────────────────────────────────────────────────┘
  484.            │ Paths to process                 │
  485.            │ Supporting files                 │
  486.            │ Index file specifications        │
  487.            ╘══════════════════════════════════╛
  488.  
  489.  
  490.  
  491. Compression programs
  492. ──────────────────────────────────────────────────────────────────────────────
  493.  
  494.         Although ExZip's primary task is to handle ZIP files it does have the
  495. ability to accept and convert .ARC files for you.  it will not process ARC
  496. files without converting them to the ZIP format!  On this screen you may
  497. specify your favorite compression programs and the compress options you wish
  498. to use.
  499.  
  500.  ┌─────────────────────────────┐
  501.  │ ExZip run time parameters   │
  502.  │ ExZTest run time parameters │
  503.  │ ────────╒══════════════════════════════════╕
  504.  │ Quit ExZ│ Virus checking                   │
  505.  └─────────│ Duplicate checking               │
  506.            │ File attribute handling          │
  507.            │ ──────────────────────────────── │
  508.            │ Disposition of damaged files     │
  509.            │ Disposition of virus infections  │
  510.            │ ──────┌[ Compression programs ]────────────────────────────────┐
  511.            │ ZIP co│                                                        │
  512.            │ Compre│ Program to create .ZIP files:     PKZIP                │
  513.            │ Proces│ Compression options to use:       -A -EX -O            │
  514.            │ Use AN│ Program to uncompress .ZIP files: PKUNZIP              │
  515.            │ Activi│ Program to uncompress .ARC files: PKUNPAK              │
  516.            │ ──────│                                                        │
  517.            │ Paths └────────────────────────────────────────────────────────┘
  518.            │ Supporting files                 │
  519.            │ Index file specifications        │
  520.            ╘══════════════════════════════════╛
  521.  
  522.  
  523.         Don't forget to tell ExZip which files you want to process!  You can
  524. do this nearly effortlessly on the following selection screen:
  525.  
  526.  
  527.  ┌─────────────────────────────┐
  528.  │ ExZip run time parameters   │
  529.  │ ExZTest run time parameters │
  530.  │ ────────╒══════════════════════════════════╕
  531.  │ Quit ExZ│ Virus checking                   │
  532.  └─────────│ Duplicate checking               │
  533.            │ File attr╔══════════════════════════════════════╗
  534.            │ ─────────║ Compressed file type to process:     ║
  535.            │ Dispositi╚════════════════════┌─────────────────────────────┐
  536.            │ Disposition of virus infection│ Process only .ARC files     │
  537.            │ ──────────────────────────────│ Process only .ZIP files     │
  538.            │ ZIP comment insertion         │ Process both .ARCs & .ZIPs  │
  539.            │ Compression programs          └─────────────────────────────┘
  540.            │ Process files in .ARC format     │
  541.            │ Use ANSI colors in DOS           │
  542.            │ Activity log file                │
  543.            │ ──────────────────────────────── │
  544.            │ Paths to process                 │
  545.            │ Supporting files                 │
  546.            │ Index file specifications        │
  547.            ╘══════════════════════════════════╛
  548.  
  549.  
  550.  
  551. Using ANSI colors
  552. ──────────────────────────────────────────────────────────────────────────────
  553.  
  554.         This is an insignificant option.  It does nothing more than inserting
  555. some ANSI color codes to the batch processing section of ExZip.  If you have
  556. ANSI.SYS loaded you might as well use it as it will highlight things like
  557. file names while doing the work.
  558.  
  559.  ┌─────────────────────────────┐
  560.  │ ExZip run time parameters   │
  561.  │ ExZTest run time parameters │
  562.  │ ────────╒══════════════════════════════════╕
  563.  │ Quit ExZ│ Virus checking                   │
  564.  └─────────│ Duplicate checking               │
  565.            │ File attribute handling          │
  566.            │ ──────────────────────────────── │
  567.            │ Disposition of damaged files     │
  568.            │ Disposition of virus infections  │
  569.            │ ──────────────────────────────── │
  570.            │ ZIP comment insertion            │
  571.            │ Compression programs             │
  572.            │ Process files in .ARC format     │
  573.            │ Use ANSI ┌──────────────────────────────────────┐
  574.            │ Activity │ Use ANSI colors in DOS (Y/N)?      Y │
  575.            │ ─────────└──────────────────────────────────────┘
  576.            │ Paths to process                 │
  577.            │ Supporting files                 │
  578.            │ Index file specifications        │
  579.            ╘══════════════════════════════════╛
  580.  
  581.  
  582.  
  583. Using ANSI colors
  584. ──────────────────────────────────────────────────────────────────────────────
  585.  
  586.         ExZip will keep a running log of what it has found for you.  This is
  587. an important feature to help you monitor the findings of the process. It will
  588. become more important with future developments!  You have the option of
  589. specifying the name and location of this log file below:
  590.  
  591.  ┌─────────────────────────────┐
  592.  │ ExZip run time parameters   │
  593.  │ ExZTest run time parameters │
  594.  │ ────────╒══════════════════════════════════╕
  595.  │ Quit ExZ│ Virus checking                   │
  596.  └─────────│ Duplicate checking               │
  597.            │ File attribute handling          │
  598.            │ ──────────────────────────────── │
  599.            │ Disposition of damaged files     │
  600.            │ Disposition of virus infections  │
  601.            │ ──────────────────────────────── │
  602.           ┌[ ExZip log file to use ]───────────────────────────────────┐
  603.           │                                                            │
  604.           │ Log file to use:                                           │
  605.           │         EXZIP.LOG                                          │
  606.           │                                                            │
  607.           └────────────────────────────────────────────────────────────┘
  608.            │ Paths to process                 │
  609.            │ Supporting files                 │
  610.            │ Index file specifications        │
  611.            ╘══════════════════════════════════╛
  612.  
  613.  
  614.  
  615. Defining your paths and optional PCBoard directories
  616. ──────────────────────────────────────────────────────────────────────────────
  617.  
  618.         This may be the most complex specification you have thus far tackled
  619. in ExZSetup!  You need to tell ExZip where your files to be checked are
  620. located and possibly where they should end up if they pass inspection.  ExZip
  621. can process up to 50 paths in one run.  It will check your PCBoard DIRnn file
  622. and if need be adjust things such as the file size in it.
  623.  
  624.         To move around this screen is slightly trickier than previous ones.
  625. You can use your arrow keys to select the entry number to modify or type the
  626. number (1-50) yourself.  Press enter to process the entry which consists of up
  627. to 4 parts as shown below.  The ESC key will get you out of the window you are
  628. in at any time.
  629.  
  630.  ┌─────────────────────────────┐
  631.  │ ExZip run time parameters   │
  632.  │ ExZTest run time parameters │
  633.  │ ────────╒══════════════════════════════════╕
  634.  │ Quit ExZ│ Virus checking                   │
  635.  └─────────│ Duplicate checking               │
  636.            │ File attribute handling          │
  637.            │ ──────────────────────────────── │
  638.        ┌[ Path specification 1  of 50 ]───────────────────────────────────────┐
  639.        │                                                                      │
  640.        │ Origin - file location before processing                             │
  641.        │   Drive/directory of files: C:\PRIVATE\                              │
  642.        │   PCBoard DIRnn file spec : C:\GEN\DIR0                              │
  643.        │                                                                      │
  644.        │ Destination - if file is to be moved or blanks                       │
  645.        │   Drive/directory of files: C:\UPLOADS\                              │
  646.        │   PCBoard DIRnn file spec : C:\GEN\DIR99                             │
  647.        │                              ╔═════════════════════════════════════╗ │
  648.        └──────────────────────────────║ Enter path number to view/change or ║─┘
  649.            │ Index file specifications║ use  to display paths in sequence ║
  650.            ╘══════════════════════════║ Press Enter to add or change a path ║
  651.                                       ╚═════════════════════════════════════╝
  652.  
  653.  
  654.  
  655. Defining your ExZip supporting files
  656. ──────────────────────────────────────────────────────────────────────────────
  657.  
  658.         There are three supporting files you may elect to use with ExZip. Each
  659. of them are handled in the same fashion but they each have different uses.  In
  660. all cases you may use the question mark as a wild card character, however, you
  661. may NOT use an asterisc!
  662.  
  663.         The "unwanted" file lsiting contains names which you wish to delete
  664. from a ZIP file at all times.  Typically, you might add things such as
  665. COMMAND.COM or PKUNZIP.EXE (how could you extract PKUNZIP from a ZIP if you
  666. didn't already have it?).
  667.  
  668.         The "acceptable duplication" listing contains file names which you do
  669. not want to check against other files on your system.  A typical example of
  670. these might be things like certain VGA drivers which show up in numerous ZIP
  671. files.
  672.  
  673.         The "do not process" listing tells ExZip to completely bypass a file
  674. listed here.  Seems many of you recreate and redate some files in your current
  675. uploads, such as your ALLFILES.ZIP listing.  These files really do not need to
  676. be processed by ExZip even though they qualify by their creation dates.  Put
  677. their names in this listing to exclude them.
  678.  
  679.         To define either of these files you need to specify their actual
  680. location, including drive and path, along with the name of the file to use. If
  681. the file does not exist the name will flash in red.
  682.  
  683.  ┌─────────────────────────────┐
  684.  │ ExZip run time parameters   │
  685.  │ ExZTest run time parameters │
  686.  │ ────────╒══════════════════════════════════╕
  687.  │ Quit ExZ│ Virus checking                   │
  688.  └─────────│ Duplicate checking               │
  689.            │ File attribute handling          │
  690.            │ ──────────────────────────────── │
  691.           ┌[ Supporting files ]────────────────────────────────────────┐
  692.           │                                                            │
  693.           │ Unwanted files' list:                                      │
  694.           │         EXZIP.EXC                                          │
  695.           │ Acceptable duplications' list:                             │
  696.           │         EXZIP.VDL                                          │
  697.           │ 'Do Not Process' file list:                                │
  698.           │         EXZIP.DNP                                          │
  699.           │                                                            │
  700.           └────────────────────────[ F2=Edit ]─────────────────────────┘
  701.            │ Supporting files                 │
  702.            │ Index file specifications        │
  703.            ╘══════════════════════════════════╛
  704.  
  705.         To create or edit these files highlight the one you wish to work on
  706. and press F2.
  707.  
  708.  ┌─────────────────────────────┐
  709.  │ ExZip run time parameters   │            ┌[ Pick list ]────────────────┐
  710.  │ ExZTest run time parameters │            │ WELCOME.TXT    READ_ME.PLS  │
  711.  │ ────────╒════════════════════════════════│ VIRUSCHK.DOC   READ_ME.750  │
  712.  │ Quit ExZ│ Virus checking                 │ U_README       READ_1ST.PLS │
  713.  └─────────│ Duplicate checking             │ U_READ.ME      READ_1ST.EXE │
  714.            │ File attribute handling        │ U_CAN.REG      READTHIS.TOO │
  715.            │ ───────────────────────────────│ UREAD1ST       READNOW.TFB  │
  716.           ┌[ Supporting files ]─────────────│ UGLY.COM       README2.COM  │
  717.           │                                 │ U-CAN.REG      README1.DOC  │
  718.           │ Unwanted files' list:           │ TYPE.ME        README.TFB   │
  719.           │         J:\PCB\NODE2\EXZIP.EXC  │ TPB            README.ROS   │
  720.           │ Acceptable duplications' list:  │ SOUND.MSG      README.CUE   │
  721.           │         EXZIP.VDL               │ SAVEADS.ZIP    README.??    │
  722.           │ 'Do Not Process' file list:     │ SAFE_OWL.COM   README.33    │
  723.           │         EXZIP.DNP               │ RUN-ME.COM     README-9.??? │
  724.           │                                 │ ROSEREAD.ME    README-8.??? │
  725.           └────────────────────────[ F2=Edit│ ROCKLAND.BBS   README-7.??? │
  726.            │ Supporting files               │ READ_ME.TXT    README-6.??? │
  727.            │ Index file specifications      ├─────────────────────────────┤
  728.            ╘════════════════════════════════│ Scratch pad  :              │
  729.                                             └─────────────────────────────┘
  730.  
  731.         The 'pick list' displayed may contain no files or more files than will
  732. fit in the display window (depending on your file).  You can move around this
  733. list with your arrow keys easily.  To change an existing entry simply
  734. highlight it and press the ENTER key.  The name will move down to the "scratch
  735. pad" for editing.  To add a new name to the list press INS.  This will make
  736. "room" for a new item.  To remove a name from the list highlight the item to
  737. be removed and press DEL.  Remember that the list of names will always be
  738. resorted for you on exit.
  739.  
  740.  
  741.  
  742. PCBoard 14.5a and later index file option
  743. ──────────────────────────────────────────────────────────────────────────────
  744.  
  745.         Since the PCBoard index file is a static file you may have to re-index
  746. when moving files with ExZip.  For example, on my system all uploads are
  747. private.  I use ExZip to move them to my public upload directory if they pass
  748. all tests.  As a result of this my upload directory changes only once each day
  749. I was able to add it to the index file used by PCBoard.  But I need to be
  750. certain that all new additions to this directory are reflected in the index
  751. file.  By specifying the information shown below you can tell ExZip to
  752. automatically recreate this index for you.  To disable this option simply make
  753. sure that no name is shown in the program name field.  You can do that by
  754. placing your cursor on the first character of the field and pressing DEL until
  755. it is cleared.
  756.  
  757.  ┌─────────────────────────────┐
  758.  │ ExZip run time parameters   │
  759.  │ ExZTest run time parameters │
  760.  │ ────────╒══════════════════════════════════╕
  761.  │ Quit ExZ│ Virus checking                   │
  762.  └─────────│ Duplicate checking               │
  763.            │ File attribute handling          │
  764.            │ ──────────────────────────────── │
  765.            │ Disposition of damaged files     │
  766.            │ Disposition of virus infections  │
  767.            │ ──────┌[ Database specifications ]─────────────────────────────┐
  768.            │ ZIP co│                                                        │
  769.            │ Compre│ Name of index program to use:     MAKEIDX              │
  770.            │ Proces│ Name of the data file:            MASTER.DAT           │
  771.            │ Use AN│ Name of the index file:           MASTER.IDX           │
  772.            │ Activi│ Location of index files:                               │
  773.            │ ──────│               C:\PCB\                                  │
  774.            │ Paths │                                                        │
  775.            │ Suppor└────────────────────────────────────────────────────────┘
  776.            │ Index file specifications        │
  777.            ╘══════════════════════════════════╛
  778.  
  779.  
  780.  
  781.         If you entered correct information and selected the proper options you
  782. wish to use you are now ready for a test run of ExZip!
  783.  
  784.  ┌─────────────────────────────┐
  785.  │ ExZip run time parameters   │
  786.  │ ExZTest run time parameters │
  787.  │ ────────╒══════════════════════════════════╕
  788.  │ Quit ExZ│ Virus checking                   │
  789.  └─────────│ Duplicate checking               │
  790.            │ File attribute handling          │
  791.            │ ──────────────────────────────── │
  792.            │ Disposition of damaged files     │
  793.            │ Disposition of virus infections  │
  794.            │ ──────────────────────────────── │
  795.            │ ZIP comment insertion            │
  796.            │ Compression programs             │
  797.            │ Process files in .ARC format     │
  798.            │ Use ANSI ┌──────────────────────────────────────┐
  799.            │ Activity │ Save changed information (if any)? _ │
  800.            │ ─────────└──────────────────────────────────────┘
  801.            │ Paths to process                 │
  802.            │ Supporting files                 │
  803.            │ Index file specifications        │
  804.            ╘══════════════════════════════════╛
  805.  
  806.  
  807.  
  808. Command line options
  809. ──────────────────────────────────────────────────────────────────────────────
  810.  
  811.         There are relatively few command line options available in ExZip. All
  812. are identified by a leading / (slash) as the first character of the option.
  813. Options are not case sensitive, may be specified in any order and leading and
  814. trailing spaces are ignored.  The first item specified on the command line
  815. immediately following the name of the program will be considered to be the
  816. specification for the configuration file if it is not preceeded by a slash. If
  817. the file name is not preceeded by a drive and/or path specification ExZip will
  818. search all paths specified in your DOS PATH= setting in order to locate the
  819. file.  You may freely rename ExZip if you should deem that advisable.  The
  820. command line format is as follows:
  821.  
  822.         EXZIP <config_file> </option1> </option2> ... </option?>
  823.  
  824. All command line options may be abbreviated to the first two letters following
  825. the slash (and must be at least that long).  The available options and their
  826. uses are:
  827.  
  828.      /ALL      When specified, this option tells ExZip to ignore
  829.                dates and process ALL files in all specified
  830.                paths.  Ideal for conversions.  NOTE that if /ALL
  831.                is specified all file moves will be disabled!!
  832.  
  833.      /EVENT    When specified, it tells ExZip to suppress all
  834.                sound effects.  Retries on some errors will also be
  835.                limited if the task about to be performed is not crutial.
  836.  
  837.      /TODAY    Forces today's date on the file as well as the
  838.                DIRnn listing for Sysops.  This is functional
  839.                only when ExZip is handling a private directory
  840.                and is ignored at all other times.  See
  841.                description of Private Upload handling for more
  842.                information.
  843.  
  844.      /NOVELL   Tells ExZip to use Novell's NCOPY instead of the DOS
  845.                COPY program for faster copying of files.  Make sure you have
  846.                NCOPY in a search path if you specify this option.
  847.  
  848.      /ND       Disables duplicate checking for this run only.  This switch
  849.                overrides the setting of the configuration file.
  850.  
  851.      /NU       Disables the recording of the results of duplicate checking.
  852.                Duplicate checks will be performed and reported but the databse
  853.                will not be updated with the processed information.
  854.  
  855.  
  856.  
  857. Other options, notes & thoughts
  858. ──────────────────────────────────────────────────────────────────────────────
  859.  
  860.      EXZDATE.EXE  - this is a small program which you can place in any of
  861.                     your search paths.  ExZip looks checks for it and if
  862.                     found any invalid date found inside a ZIP file will be
  863.                     automatically changed to the processing date.  This
  864.                     includes dates in the future as well as pure garbage
  865.                     found in compressed files on occasion.
  866.  
  867.      CLEARERR.COM - is a small program to clear the DOS errorlevel due to an
  868.                     inconsistency.  See documentation for the program for more
  869.                     details.  You shuold have this in a search path available
  870.                     for ExZip's use.
  871.  
  872.      ZIPs in ZIPs - ExZip will fully process a ZIP found within a ZIP (or for
  873.                     that matter an ARC in a ZIP or ARC in an ARC).  However,
  874.                     it will NOT process down to the third level.  Inasmuch as
  875.                     I find ZIPs in ZIPs an acceptable practice I disagree with
  876.                     going to 3 or more levels.  ExZip will note any such
  877.                     occurances in the log file but will rely on you for their
  878.                     final checks.
  879.  
  880.      Problems     - All known problems of previous release versions have been
  881.                     corrected.
  882.  
  883.      FWKCS        - Duplicate checking depends a great deal on your ability to
  884.                     initially set-up this software.  Although a few startup
  885.                     ideas are included here you will need to consult the
  886.                     program's documentation and options more details. I can
  887.                     tell you what information ExZip uses based on which you
  888.                     can decide what you may wish to keep and discard.
  889.  
  890.                     ExZip uses only individual file 'signatures' - not ZIP
  891.                     signatures.  As far as ExZip is concerned you can remove
  892.                     all ZIP file signatures.
  893.  
  894.                     Once you have 'cleaned up' your system and eliminated
  895.                     duplications which already existed (if that is desired)
  896.                     you can, if you want to also eliminate multiple occurances
  897.                     of signatures.  Again, ExZip looks only for identical
  898.                     matches.  If multiple occurances are found in your
  899.                     database ExZip will report them to you (up to 99 of them)
  900.                     but it is not necessary for proper operationn.
  901.  
  902.                     FWKCS prior to version 1.06 consisted of two programs.
  903.                     ExZip will identify this and properly interface with
  904.                     either.  ExZip will function correctly with either v1.05
  905.                     or v1.08 of this software.  It has not been tested with
  906.                     versions above 1.08 thus it is entirely possible that they
  907.                     will not interface correctly.
  908.  
  909.      Memory use   - ExZip uses a moderate amount of RAM which is allocated
  910.                     dynamically as needed.  Since the supporting files, such
  911.                     as EXZIP.EXC are loaded in entirety the amount of memory
  912.                     required will vary from site to site.  You must remember,
  913.                     however, that ExZip will shell and load programs such as
  914.                     PKZIP which require a fair amount of RAM by themselves (I
  915.                     have seen PKZIP use as much as 300+ KB) thus the more
  916.                     memory you can give it the safer you'll be.  I cannot
  917.                     check for memory while in a DOS shell!
  918.  
  919.      Disk use     - ExZip unzips files it processes one at a time, thus the
  920.                     space required for work areas will not be greater than the
  921.                     contents of the largest ZIP it is to process.  However, it
  922.                     does create a number of batch files which, when processing
  923.                     a large number of files at once (in excess of 500) will
  924.                     take up considerable space.
  925.  
  926.  
  927.  
  928. The end
  929. ──────────────────────────────────────────────────────────────────────────────
  930.  
  931.         I really do not have much more to add although I am quite certain I
  932. have overlooked a number of points which perhaps should have been mentioned. I
  933. never claimed to be good at writing documentation.  :)  If ExZip works for you
  934. and helps that is great.  If I wasted your time reading all this and it really
  935. isn't for you, so be it.
  936.  
  937.         Please note that any trade marks and service marks mentioned in this
  938. document belong to someone.  I do not hold any trademarks on anything
  939. associated with this software.  I do, however, reserve all rights and
  940. copyright to ExZip, ExZSetup and ExZTest.
  941.  
  942.         My greatful appreciation to many who have helped ExZip get to where it
  943. is today including but not limited to the beta testers who's files and
  944. directories were at the mercy of early versions.  Although all beta tester
  945. feedback is valuable I need to specifically thank Mike Meyer and Ray Novino
  946. for their time and dedication to this project.  Much of what we accomplished
  947. in ExZip will be the foundation of the next ExZTest program!
  948.  
  949.         All typos (for which I am famous) fund in this document are
  950. intentional.  (And if you beleive that you should send me $1,000 in small
  951. bills for registration!)
  952.  
  953.         Since, in my opinion, no documentation should ever exceed 1000 lines
  954. in length we'll put an end to this real soon.  If you managed to read this far
  955. you should bear in mind that you might be the only one!  If you need to
  956. contact me I can be reached on the ILink mail network's Sysop echo and
  957. Shareware echo.
  958.  
  959.         Have fun!
  960.  
  961.  
  962.  
  963.  
  964.