home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / EXZIP18.ZIP / EXZIP.DOC next >
Encoding:
Text File  |  1989-02-23  |  20.3 KB  |  595 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                    <=  ExZip  =>
  14.  
  15.                   Part of the EXpert series programs available at
  16.  
  17.                        The Executive Network Multi-Node BBS
  18.  
  19.                        Registration number:  (914) 667-4567
  20.                        Public access      :  (914) 667-4684
  21.                        Subscriber access  :  (914) 667-4759
  22.  
  23.             --------------------------------------------------------------
  24.  
  25.  
  26.                            Copyright 1988 - Andy Keeves
  27.  
  28.  
  29.  
  30.  
  31.                OK,  just  what  the  devil  is  ExZip you ask.  ExZip is a
  32.           rather simple program to help with the re-compressing  of files.
  33.           It was  born primarily  to answer  the need  of a  BBS SysOp who
  34.           receives a fair number of files, some of which may be damaged or
  35.           ARCed with an older and less efficient ARChive program, or ZIPed
  36.           with compression methods other than the ones I wish to use.
  37.  
  38.                ExZip has the ability to pick  out any  files from  a given
  39.           subdirectory that are dated with today's or yesterday's date and
  40.           reZIP them all in one pass using PKZIP.  Simple, no?  This makes
  41.           it an  ideal program  for unattended, overnight processing.  All
  42.           you need is a simple configuration  file to  tell it  where your
  43.           files are.   There  are a  few other variables you can use, this
  44.           way nearly anyone can use it effectively, not only Sysops.
  45.  
  46.                ExZip is a successor to ExArc and it introduces a number of
  47.           new, enhanced  features, including the automatic conversion from
  48.           .ARC to .ZIP formats.
  49.  
  50.                ExZip is a FREE program.   That is  you may  freely use it,
  51.           give it  away, upload  it to other bulletin boards.  You may NOT
  52.           change it, or ask money for  it or  claim it  is yours.   If you
  53.           like ExZip  and is  of help  to you,  upload a few files to your
  54.           favorite bulletin  board.   If you  absolutely must  pay for it,
  55.           send  a  few  $$  to  your  favorite BBS Sysop - believe me, all
  56.           Sysops can use it, since running a board  is NOT  cheap!  Should
  57.           you find  a bug  in ExZip,  you may drop me a line via my BBS or
  58.           via the InterLink network (several topics).
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 1.
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.                             How to set-up and use ExZip
  80.                             ---------------------------
  81.  
  82.  
  83.                The configuration file MUST be called EXZIP.CFG and it MUST
  84.           be located  in your default directory when ExZip is ran.  If you
  85.           have used ExArc in the past, notice that  the configuration file
  86.           MUST now  BE CALLED  EXZIP.CFG!!   MAKE SURE  YOU READ ON, SINCE
  87.           THERE ARE NEW OPTIONS HERE!   It is a standard ASCII  text file,
  88.           so you  may use most any editor to create it, including EDLIN or
  89.           "COPY CON".   The  only required  entry in  this file  is a path
  90.           where  the   files  to  re-ZIP  are  to  be  found.    The  path
  91.           specification, as well  as  the  few  other  optional  specs are
  92.           entered  in  the  format  X=<options>,  where  X  is  the letter
  93.           indicating the type of specification  that  follows.    The path
  94.           specification is  indicated by  the letter  P.   By the way, the
  95.           configuration file is NOT case sensitive, so do  not worry about
  96.           it.  Here's what it might look like:
  97.  
  98.           P=C:\NEWFILES
  99.  
  100.           OK, that wasn't so bad, was it?  With that line, ExZip would re-
  101.           ZIP all files on C:\NEWFILES that have a .ZIP extension and have
  102.           yesterday's or  today's date!  Oh, nearly forgot to mention that
  103.           ExZip can handle more then one directory if you so desire.  This
  104.           is accomplished  by entering  more then one P=<path spec> lines,
  105.           like this:
  106.  
  107.           P=C:\NEWFILES
  108.           P=C:\MYDIR
  109.           P=C:\BASIC\PROGS
  110.  
  111.  
  112.           More on path specifications.
  113.           ----------------------------
  114.  
  115.           FORMAT:   P=<drive\path>=<drive\path\DIRnn>
  116.  
  117.                The path  specifications lines  must always  begin with the
  118.           letter P.   Two options may be specified on this line, all parts
  119.           separated by = (equal sign).  Part 1, as shown above is the path
  120.           to  the  files,  including  drive  letter.  Should NOT contain a
  121.           trailing backslash, though ExZip will correct  it for  you.  The
  122.           second option  is a  pointer to  the corresponding PCBoard DIRnn
  123.           file, including drive letter and path.  This  should NOT  be the
  124.           ANSI version  under any  circumstances!!!  If this is specified,
  125.           ExZip will perform the following functions for you as well:
  126.  
  127.                -    Set the ZIP file date to that found in the DIRnn file;
  128.                -    Adjust the  DIRnn  file  entry  for  ZIP  extension if
  129.                     needed;
  130.                -    Adjust the file size in the DIRnn to the new ZIP;
  131.  
  132.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 2.
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.                I know that no program can please everyone, but I needed to
  149.           put a ceiling on this somewhere, so the most path specifications
  150.           you can  enter into  a .CFG file is limited to 50.  Actually you
  151.           could enter as many as you want, but ExZip will  ignore anything
  152.           past 50.  
  153.  
  154.  
  155.           ARC options.
  156.           ------------
  157.  
  158.           FORMAT :  A=<Option>
  159.           DEFAULT:  NO
  160.  
  161.                Default here  is to  scan only for ZIP files.  If option is
  162.           "Y" for  yes,  ExZip  will  also  scan  for  .ARC  files  in the
  163.           specified path and convert them .ZIP in the same pass.  
  164.  
  165.                You may  also set  this parameter  to "O" (Only ARCs) which
  166.           will bypass the processing of any ZIP files.  This  can be handy
  167.           if  processing  a  directory  which  has  already been partially
  168.           completed.
  169.  
  170.  
  171.           >>   Note  that  both,  ZIP  to  ZIP  and  ARC   to  ZIP  format
  172.                conversions  check  for  imbedded  compressed  files!    If
  173.                converting from ARC ExZip  will  look  for  additional .ARC
  174.                files  contained  in  the  archive  and  they  will also be
  175.                converted to ZIP.   Similarly, ZIPs will  be looked  for in
  176.                ZIP files and recompressed.
  177.  
  178.  
  179.           Activity logs.
  180.           --------------
  181.  
  182.           FORMAT :  L=<drive\path\filename>
  183.           DEFAULT:  EXZIP.LOG
  184.  
  185.                ExZip  activity  will  be  recorded,  along with any errors
  186.           encountered, in the log file.  This is  a cumulative  record and
  187.           the file should be occasionally deleted to save space.
  188.  
  189.  
  190.           Program names.
  191.           --------------
  192.  
  193.           FORMAT :  Z=<program name>
  194.           DEFAULT:  PKZIP
  195.  
  196.                Defines the PKZIP program name, if other than original.
  197.  
  198.  
  199.  
  200.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 3.
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.           FORMAT :  U=<program name>
  216.           DEFAULT:  PKUNZIP
  217.  
  218.                Defines the PKUNZIP program name, if other than original.
  219.  
  220.  
  221.           FORMAT :  X=<program name>
  222.           DEFAULT:  PKXARC
  223.  
  224.                Defines the PKXARC program name, if other than original.
  225.  
  226.  
  227.  
  228.           Command options.
  229.           ----------------
  230.  
  231.           FORMAT :  O=<options>
  232.           DEFAULT:  -A -EB4 -O
  233.  
  234.                Allows you  to specify  your own  PKZIP options overwriting
  235.                all defaults shown above.
  236.  
  237.  
  238.           ANSI options.
  239.           -------------
  240.  
  241.           FORMAT :  C=<OFF>
  242.           DEFAULT:  ON
  243.  
  244.                Turns off ANSI codes if ANSI.SYS is not loaded.
  245.  
  246.  
  247.           ZIP file comments.
  248.           ------------------
  249.  
  250.           FORMAT :  I=<drive\path\filename>
  251.           DEFAULT:  NONE
  252.  
  253.                If specified, the contents  of the  indicated file  will be
  254.           placed in the new ZIP file as a comment.
  255.  
  256.  
  257.  
  258.  
  259.                                   Unwanted files!
  260.                                   ---------------
  261.  
  262.                ExZip  allows  you  to  specify  a  list of unwanted files.
  263.           These would be files like COMMAND.COM,  AUTOEXEC.BAT, CONFIG.SYS
  264.           and whatever  other names  you wish  to exclude from compression
  265.           whenever found in a file being  ZIPed.    To  use  this feature,
  266.           simply create  a file called EXZIP.EXC on the same drive\path as
  267.  
  268.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 4.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.           your EXZIP.CFG file.   This file  can be  created and maintained
  284.           with  any  text  editor.    Enter  each  unwanted  filename on a
  285.           separate line, without a  drive\path  designation.    Up  to 100
  286.           names may be specified.
  287.  
  288.  
  289.  
  290.                                 Directory Handling
  291.                                 ------------------
  292.  
  293.                ExZip observes  network file sharing on multi-node systems.
  294.           As a result, when using the DIRnn update  feature, it  creates a
  295.           temoprary work  file, which  is copied  to the actual DIRnn file
  296.           when all completed.  Should another user be  on-line reading the
  297.           directory, ExZip  will go  into a wait loop, retrying the update
  298.           every 10 seconds or so until it succeeds.  If running unattended
  299.           during your  event, you  should assure  that no other program is
  300.           locking the directories permanently.  ExZip  will wait  for ever
  301.           if need  be.  Should a problem occur, the copy may be skipped by
  302.           pressing ESC.
  303.  
  304.                ExZip does NOT update your ANSI  directories!   After ExZip
  305.           is finished  you can  accomplish that by simply running PCBFiler
  306.           during your event via the command line:
  307.  
  308.                PCBFILER /COLORIZE;SORT
  309.  
  310.           which will sort and colorize all your directories.
  311.  
  312.  
  313.  
  314.                                Command line switches
  315.                                ---------------------
  316.  
  317.                There are only two command line options available in ExZip.
  318.           Either or both are specified with a leading / (slash).
  319.  
  320.                /ALL      When specified, this option tells ExZip to ignore
  321.                          dates and  process  ALL  files  in  all specified
  322.                          paths.  Ideal for conversions.
  323.  
  324.                /EVENT    When  specified,  it  tells ExZip to suppress all
  325.                          sound effects.
  326.  
  327.  
  328.  
  329.                                   Known Problems!
  330.                                   ---------------
  331.  
  332.                At the  time of  this writing  there are  known problems in
  333.           PKZIP, which  I imagine  will be  fixed in time.  Some have been
  334.  
  335.  
  336.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 5.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.           addressed by ExZip, others simply cannot  be, so  you should use
  352.           caution!
  353.  
  354.                1)   PKZIP   seems   to   create   larger  files  if  ASCII
  355.                     compression is turned on.  This is the -ea# parameter,
  356.                     omitted by ExZip.  I recommend no -ea# at all!
  357.  
  358.                2)   PKZIP does not observe the -o parameter as documented.
  359.                     ExZip gets around this problem IF you also point it to
  360.                     your corresponding DIRnn file.
  361.  
  362.                3)   PKUNZIP seems  to fail  to display or extract ZIP file
  363.                     members under some circumstances.   This  has not been
  364.                     identified as  to the  exact reason or way it happens,
  365.                     but it does happen.  Since  no error  code is returned
  366.                     by PKZIP,  ExZip has  no way  to find out that nothing
  367.                     was extracted, and you CAN lose a file this way!  This
  368.                     is a problem that must be resolved on the PK side. 
  369.  
  370.                4)   A problem  has been  reported where  PKZIP will create
  371.                     and continue to create  a ZIP  file.   I have  no idea
  372.                     what the  circumstances might  be as I have never seen
  373.                     this one myself, however, it can and will  run you out
  374.                     of disk space if/when it happens!
  375.  
  376.                5)   We found a problem with PKZIP inserting the drive\path
  377.                     designation of the original file into  the ZIP.   This
  378.                     does not  seem to  be the case when creating a new ZIP
  379.                     file, but rather if you replace  a member  within one,
  380.                     possibly repeatedly, with the -A or -U option.  We are
  381.                     not certain  at  this  time  which  option  causes the
  382.                     situation.
  383.  
  384.  
  385.  
  386.                This really  is it.   Just  remember that PKZIP and PKUNZIP
  387.           (and possible PKUNPAK) must be available when doing this, in the
  388.           current directory  or in a search path.   Also, don't run out of
  389.           space!  A good rule to keep in mind is that you should have free
  390.           space equal  to the size of your largest ARChive times 2 (at the
  391.           least).   Although  ExZip may  look a  bit strange  running on a
  392.           monochrome monitor (was designed for CGA), it will run flawless.
  393.  
  394.  
  395.  
  396.                              Suggestions and warnings!
  397.                              -------------------------
  398.  
  399.  
  400.                WARNING!  DO NOT RUN ExZip in a DDOS bottom partition!!  It
  401.                          will hang, since it uses direct screen writes !!!
  402.  
  403.  
  404.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 6.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                WARNING!  I do not suggest running ExZip with DDOS up or in
  420.                          small memory machines IF you will be encountering
  421.                          ARCs within ARCs or ZIPs within ZIPs!  ExZip uses
  422.                          a DOS shell to do the  work and  yet a  second if
  423.                          ARCs or ZIPs are located in the file.
  424.  
  425.  
  426.  
  427.  
  428.  
  429.                And ZIPping right along .... keep dialing!
  430.            
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 7.
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.           Changes in ExZip.
  489.           -----------------
  490.  
  491.                In all  honesty I  do not  anticipate many  changes to this
  492.           program, so there is no separate what's new file.  I will simply
  493.           pickup from today's changes, and future ones, if any.
  494.  
  495.           v 1.4     Oct 17, 1988        New feature added.
  496.  
  497.                     -    There  is  a  new  .CFG parameter you can now use
  498.                          with ExArc.  It  facilitates the  addition of tag
  499.                          lines  that  PKWare  allows.    You  will need to
  500.                          create file, containing the  single line  of your
  501.                          desired  tag  line.    Once you have this, simply
  502.                          tell ExArc where it  is and  it will  do the rest
  503.                          for    you.        The   format   for   this   is
  504.                          "I=<path\filespec>" where "I" stands for input.
  505.  
  506.                     -    With the  proliferation and  changes in archiving
  507.                          utilities,  there  seems  to  be  a need to allow
  508.                          multiple  programs.    Thus,  an  additional .CFG
  509.                          parameter  is  available  to  allow  the  use  of
  510.                          programs other than PKARC/PKXARC.  The  format is
  511.                          simply  "X=<extract-program>" & "A=<arcprogram>".
  512.                          Thus you might  have  a  line  like  "X=PKPAK" or
  513.                          variations  like  it.    You need not specify the
  514.                          extension, only the name.  If either of these two
  515.                          are found  in the  .CFG file,  ExArc will use the
  516.                          program names you supply instead of PKARC/PKXARC.
  517.                          If  not  found,  it  will  still  default  to the
  518.                          original names.
  519.  
  520.  
  521.           v 1.5     Feb  5, 1989        New feature added.
  522.  
  523.                     -    I  came  across  a  slightly  annoying situation,
  524.                          finding that  some folks not only place a comment
  525.                          in the archive, but  also additional  files which
  526.                          do not  belong there.   Not  only is this against
  527.                          the wishes of most  Shareware authors,  but these
  528.                          files will  also increase my storage requirements
  529.                          and my callers' transfer times!   Well, now there
  530.                          is  an  answer.    ExArc  can  be  told to remove
  531.                          specific files from the  archive if  found!  Most
  532.                          people are  consistent when  adding a  file.  All
  533.                          you need to  do  is  create  a  text  file called
  534.                          EXARC.EXC   (as   in   EXClusions)  in  the  same
  535.                          directory as  EXARC.CFG is  already in.   Use any
  536.                          text editor, COPY CON, EDLIN, and enter each file
  537.                          name you wish removed.  You  may enter  up to 100
  538.                          file  names,  each  on  a  separate line.  DO NOT
  539.  
  540.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 8.
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.                          enter drive  or directory  designations, only the
  556.                          file names!    This is it.  Simple and effective!
  557.                          You will never be  annoyed by  "extra" files ever
  558.                          again!
  559.  
  560.           v 1.6     Feb 20, 1989        Changes toward ZIP.
  561.  
  562.                     -    Program renamed to EXZIP.
  563.                     -    Several new CFG options added
  564.                     -    Handles compressed files inside the file
  565.                     -    Converts from either ARC or ZIP
  566.                     -    Updates PCBoard's DIRnn files now
  567.                     -    Stamps the new ZIP with date from DIRnn
  568.  
  569.           v 1.7     Feb 21, 1989        Minor (internal) change
  570.  
  571.                     -    ExZip was  never designed  for a major conversion
  572.                          effor, such as that of an  entire system.   Since
  573.                          it  relied  on  relatively  few  files  being re-
  574.                          comressed, the  DOS  .BAT  usage  was  fine.   In
  575.                          handling thousands  of files, however, DOS slowed
  576.                          it to unrealistically slow  levels.   Version 1.7
  577.                          now checks  the number  of files  that need to be
  578.                          processed and breaks the batch into  smaller .BAT
  579.                          files of  50 compressions each.  Thus we are able
  580.                          to retain the full conversion speed throughout.
  581.                     -    Minor changes in colors for readability
  582.                     -    Added file  display  to  last  step  of directory
  583.                          scans.  The system just seemed to sit there doing
  584.                          nothing on a large conversion.  Now at  least you
  585.                          can tell what it is doin.
  586.  
  587.           v 1.8     Feb 23, 89          Maintenance release
  588.  
  589.                     -    Corrected (external)  problem of  faulty ZIP file
  590.                          for version 1.7 (see notes on PKZIP bugs).
  591.                     -    Reduced  label  sizes   to   allow   handling  of
  592.                          directories containing more than 999 files.
  593.                     -    Added  additional  checking  for  the presense of
  594.                          PKZIP.  Previously, if this was  not found, ExZip
  595.                          could have  deleted the  original files without a
  596.                          replacement file.
  597.                     -    Corrected  documentation   to  properly  indicate
  598.                          default  program   name  as   PKXARC  instead  of
  599.                          PKUNPAK.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.           ExZip v1.8 [02/23/89] - File Re-compressor program       Page 9.
  609.  
  610.  
  611.  
  612.  
  613.