home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / unzip512.zip / vms / README < prev    next >
Text File  |  1994-08-25  |  5KB  |  93 lines

  1. vms/README for UnZip 5.12 and later, 25 Aug 94
  2. ----------------------------------------------
  3.  
  4. Notes about using UnZip and zipfiles under VMS (see INSTALL for instructions
  5. on compiling):
  6.  
  7.  - Install UnZip as foreign symbol by adding this to login.com:
  8.       $ unzip == "$disk:[dir]unzip.exe"
  9.       $ zipinfo == "$disk:[dir]unzip.exe -Z"
  10.    where "disk" and "dir" are location of UnZip executable; the "$" before
  11.    the disk name is important.  Some people, including the author, prefer
  12.    a short alias such as "ii" instead of "zipinfo"; edit to taste.
  13.  
  14.  - Optionally install UnZipSFX for use with the MAKESFX.COM command file:
  15.       $ unzipsfx :== disk:[dir]unzipsfx.exe
  16.    Thereafter an archive "foo.zip" may be converted to "foo.exe" simply by
  17.    typing "@makesfx foo" (assuming MAKESFX.COM is in the current directory).
  18.    Note that there is *no* leading "$" in this case.
  19.  
  20.  - After proper installation, the default version of UnZip is invoked just
  21.    as in Unix or MS-DOS:  "unzip -opts archive files".  The hyphen ('-') is
  22.    the switch character, not the slash ('/') as in native VMS commands.  An
  23.    alternative is available if VMSCLI is defined during compilation; this
  24.    version does provide a native VMS-style command interface (e.g., /ZIPINFO
  25.    instead of -Z).  Both versions accept the command "unzip -v", which can
  26.    be used to check whether VMSCLI was defined or not; but an even simpler
  27.    method is to type "unzip" and look at the help screen.  Note that options
  28.    placed in an environment variable (UNZIP_OPTS) must be of the short, hy-
  29.    phenated form regardless of how UnZip was compiled.
  30.  
  31.  - VMS (or the C compiler) translates all command-line text to lowercase
  32.    unless it is quoted, making some options and/or filenames not work as
  33.    intended.  For example:
  34.     unzip -V zipfile vms/README
  35.    is tranlated to
  36.     unzip -v zipfile vms/readme
  37.    which may not match the contents of the zipfile and definitely won't
  38.    extract the file with its version number as intended.  This can be
  39.    avoided by use of the -C option (/CASE_INSENSITIVE) or by enclosing
  40.    the uppercase stuff in quotes:
  41.     unzip "-V" zipfile "vms/README"
  42.    Note that quoting the whole line probably won't work, since it would
  43.    be interpreted as a single argument by the C library.
  44.  
  45.  - Wildcards which refer to files internal to the archive behave like Unix
  46.    wildcards, not VMS ones (assuming UnZip was not compiled with VMSWILD
  47.    defined).  This is both a matter of consistency (see above) and power--
  48.    full Unix regular expressions are supported, so that one can specify
  49.    "all .c and .h files which start with a, b, c or d and do not have a 2
  50.    before the dot" as "[a-d]*[^2].[ch]".  Of course, "*.[ch]" is a much more
  51.    common wildcard specification, but the power is there if you need it.
  52.    Note that "*" matches zipfile directory separators ('/'), too.  If UnZip
  53.    *was* compiled with VMSWILD defined (do "unzip -v" to check), the single-
  54.    character wildcard is "%" rather than "?", and character sets (ranges)
  55.    are delimited with () instead of [] (for example, "*.(ch)").
  56.  
  57.  - Created files get whatever permissions were stored in the archive (mapped
  58.    to VMS and/or masked with your default permissions, depending on the 
  59.    originating operating system), but created directories additionally in-
  60.    herit the (possibly more restrictive) permissions of the parent directory.
  61.    And obviously things won't work if you don't have permission to write to
  62.    the extraction directory.
  63.  
  64.  - When transferring files, particularly via Kermit, pay attention to the
  65.    settings!  In particular, zipfiles must be transferred in some binary
  66.    mode, which is NOT Kermit's default mode, and this mode must usually be
  67.    set on BOTH sides of the transfer (e.g., both VAX and PC).  See the notes
  68.    below for details.
  69.  
  70.  
  71.  
  72.  
  73. From Info-ZIP Digest (Wed, 6 Nov 1991), Volume 91, Issue 290:
  74.  
  75.    Date: Tue, 5 Nov 91 15:31 CDT
  76.    From: Hugh Schmidt <HUGH@macc.wisc.edu>
  77.  
  78.             ****************************************************
  79.             *** VMS ZIP and PKZIP compatibility using KERMIT ***
  80.             ****************************************************
  81.  
  82.    Many use Procomm's kermit to transfer zipped files between PC and VMS
  83.    VAX.  The following VMS kermit settings make VMS Zip/UnZip compatible
  84.    with PC Zip/UnZip or PKZIP/PKUNZIP:
  85.                                          VMS kermit          Procomm kermit
  86.                                     -------------------   --------------------
  87.    Uploading PC zipfile to VMS:     set file type fixed   set file type binary
  88.    Downloading VMS zipfile to PC:   set file type block   set file type binary
  89.  
  90.    "Block I/O lets you bypass the VMS RMS record-processing capabilities
  91.    entirely", (Guide to VMS file applications, Section 8.5).  The kermit
  92.    guys must have known this!
  93.