OS/2 Professional/OS2PRO194.ISO/os2/packer/pmzip/pmzip.hlp

OS/2 Help File | 1994-02-03 | 20.2 KB | 580 lines

ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ

PMZIP 1.00 - Shareware Evaluation Version

PMZIP(TM) is a ZIP file manager for the OS/2 Presentation Manager. It features:

 o An SAA/CUA compatible interface for quickly adding, deleting, extracting,
   and viewing files in a ZIP file
 o Extensive online hypertext help (press F1 at any time)
 o A sortable scrollable multi-selection list box with the names, sizes, and
   date/time stamps of files in a ZIP file
 o Push buttons for most commonly used actions
 o A file search facility to locate selected ZIP files anywhere on a disk
 o Easy installation
 o Support for the File Manager's drag and drop interface in OS/2 version 1.20
   and later.
 o All options (including screen size and position) can be saved and restored

 PMZIP is distributed as Shareware.  This means that users are encouraged,
 subject to restrictions described in the License Agreement, to share copies of
 this program with friends, associates and bulletin boards.  Please remember
 that if you use this software you are required to pay the registration fee of
 $29 as described in the License Agreement.

 The online help facility is designed to give a context-sensitive description
 of the highlighted field and to provide additional information about the
 following topics. Double-click on one of the items (or tab to the item and
 press Enter) for details on the topic.

 For more information about using the help facility, select Help for help on
 the Help pull-down.

 o PMZIP Overview
 o Copyright/License Agreement/Warranty
 o Support and questions
 o Quick start information
 o Drag and Drop Interface
 o Installation
 o Opening ZIP files
 o Adding files to a ZIP file
 o Deleting files from a ZIP file
 o Extracting files from a ZIP file
 o Viewing files in a ZIP file
 o File Search Facility
 o Options
 o Error Handling
 o Keyboard usage
 o File Manager hints
 o Future Enhancements
 o Notes


ΓòÉΓòÉΓòÉ 2. PMZIP Overview ΓòÉΓòÉΓòÉ

ZIP files contain other files.  Typically the files in a ZIP file are
compressed.  ZIP files make it easy to group files and makes transporting and
copying these files faster.

PMZIP(TM) is a ZIP file manager for the OS/2 Presentation Manager. It provides
an easy-to-use SAA/CUA compatible interface for quickly adding, deleting,
extracting, and viewing members of a ZIP file. The program is easy to install,
and extensive online help is always available.

The main PMZIP window includes a list of files in the open ZIP file. This list
can be scrolled and sorted by name, extension, date, or size.  Files can be
added, deleted, extracted, or viewed using pull-down menu entries and push
buttons.

Other features include a built-in file search facility that makes it easy to
locate ZIP files anywhere on your disk, support for the File Manager's drag and
drop interface to conveniently add files to a ZIP file, and the ability to save
and restore all options, including screen size and position.

PMZIP supports the CUA "object-action process sequence" philosophy. This allows
you to select objects (files you want to add to a ZIP or files already in a
ZIP) and then specify the action you want to perform. Alternately, you can use
PMZIP in a more traditional "action-object" style of interaction.

The most common ways to start the program are:

 o To open an existing ZIP file from the File Manager, double click on the ZIP
   file.

 o To add files to an existing ZIP file, use the technique described in the
   section titled Drag and Drop Interface.  Briefly, select one or more files
   in the File Manager, hold down mouse button two, drag the file(s) over a
   PMZIP window or icon, and release the mouse button.  NOTE:  you should drop
   files over a copy of PMZIP that is running, not over an icon in a Desktop
   Manager Program Group window.

 o To add files to a new ZIP file, use the procedure for adding files to an
   existing ZIP file, but be sure to specify the name of a ZIP file in the
   dialog box displayed when you "drop" files onto a running copy of PMZIP.

 You can also start PMZIP by double clicking on the PMZIP icon in the "Group -
 Main" window.  To start PMZIP from the OS/2 command line type PMZIP,
 optionally specifying the name of a ZIP file as the first and only parameter.


ΓòÉΓòÉΓòÉ 3. Copyright/License/Warranty ΓòÉΓòÉΓòÉ

PMZIP(TM) Copyright (c) 1991 by Nico Mak - All rights reserved.

License Agreement and Warranty Disclaimer

You should carefully read the following terms and conditions before using this
software.  Use of this software indicates your acceptance of these terms and
conditions.  If you do not agree with them, do not use the software.

Shareware Version

You are hereby licensed to:  use the Shareware Version of the software for a 21
day evaluation period; make as many copies of the Shareware version of this
software and documentation as you wish; give exact copies of the original
Shareware version to anyone; and distribute the Shareware version of the
software and documentation in its unmodified form via electronic means.  There
is no charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any
such copies, however made; and from distributing the software and/or
documentation with other products (commercial or otherwise) without prior
written permission.

Unregistered use of PMZIP after the 21-day evaluation period is in violation of
federal copyright laws.

Evaluation and Registration

This is not free software.  This license allows you to use this software for
evaluation purposes without charge for a period of 21 days.  If you use this
software after the 21 day evaluation period a registration fee of $29 (plus
shipping and handling for orders outside USA) is required. Payments must be in
US dollars drawn on a US bank, and should be sent to Nico Mak, P.O.  Box 919,
Bristol, CT 06010.  Credit card ordering and quantity discounts are available,
as described in the file ORDER.DOC.

One registered copy of PMZIP may be dedicated to a single person who uses the
software on one or more computers or to a single workstation used by multiple
people.

You may access the registered version of PMZIP through a network, provided that
you have obtained individual license for the software covering all workstations
that will access the software through the network.

Governing Law

This agreement shall be governed by the laws of the State of Connecticut.

Disclaimer of Warrantee

This software and the accompanying files are sold "as is" and without
warranties as to performance of merchantability or any other warranties whether
expressed or implied.  Because of the various hardware and software
environments into which this program may be put, no warranty of fitness for a
particular purpose is offered.

Good data processing procedure dictates that any program be thoroughly tested
with non-critical data before relying on it.  The user must assume the entire
risk of using the program.  Any liability of the seller will be limited
exclusively to product replacement or refund of purchase price.


ΓòÉΓòÉΓòÉ 4. Support and questions ΓòÉΓòÉΓòÉ

Technical support is available at no charge by sending electronic mail to
70056,241 on CompuServe, to Nico_Mak on BIX, or by sending US Mail to Nico Mak,
P.O. Box 919, Bristol, CT 06010. Registered users have priority but I will try
to answer all questions.


ΓòÉΓòÉΓòÉ 5. Quick start information ΓòÉΓòÉΓòÉ

Many people that have used other Presentation Manager or Windows applications
will be able to use PMZIP without reading all the documentation. However, the
following sections should be reviewed before running the program:

 o Copyright/License Agreement/Warranty
 o Installation
 o Drag and Drop Interface

 I also suggest you read the section titled Notes for miscellaneous information
 about the interface philosophy and background, as well as technical notes.

 For more information about using the help facility, select Help for help on
 the Help pull-down.


ΓòÉΓòÉΓòÉ 6. Drag and Drop interface ΓòÉΓòÉΓòÉ

PMZIP supports the File Manager's "Drag and Drop" interface in OS/2 version
1.20 and later. This interface provides a convenient way to add, freshen, or
update files in a ZIP file with selected files listed by the File Manager. To
use the interface

  1. select one or more files in the File Manager
  2. hold down mouse button two
  3. drag the file(s) over PMZIP window or icon
  4. release mouse button two to drop the file(s)

 NOTE:  you should drop files over a copy of PMZIP that is running, not over an
 icon in a Desktop Manager Program Group window.

 When you drop one or more files on a PMZIP window, the "Drop" dialog box is
 displayed.  The dialog box lets you change the name of ZIP file affected by
 the drop operation, either by typing the name of a ZIP file, or by clicking on
 the Open or New buttons, which activate the standard Open and New dialog
 boxes, respectively. This is a quick way to open a different ZIP file without
 going through the File pull-down menu.

 The Drop dialog box provides the following options:

 o The Add, Freshen, and Update radio buttons correspond to the PKZIP -a, -f,
   and -u options
 o The "delete original after adding" check box corresponds to the PKZIP -m
   option
 o The Size and Speed radio buttons correspond to the PKZIP -ex and -es options
 o The "Recurse subdirectories" check box corresponds to the PKZIP -r option
 o The "Store recursed pathnames" check box corresponds to the PKZIP -p option
 o The "Store specified pathnames" check box corresponds to the PKZIP -P option


ΓòÉΓòÉΓòÉ 7. Installation ΓòÉΓòÉΓòÉ

System Requirements:

 o OS/2 version 1.2 or later.
 o The OS/2 versions of the PKWARE, Inc. PKZIP(TM) and PKUNZIP(TM) programs.
   These can be obtained from most bulletin board systems or ordered directly
   from PKWARE (phone [phone]).

 PMZIP-related files are:

 o README.1ST this file
 o ORDER.DOC order form
 o PMZIP.EXE executable
 o PMZIP.HLP documentation in online hypertext help format
 o PMZIP.TXT documentation formatted for printing
 o PMZIP.DLL required dynamic link library

 Installation:

 There are two parts to the installation process.  The first is performed
 manually before running PMZIP. The second part is run from the Install dialog.
 This dialog box is displayed the first time PMZIP is run, and can be rerun
 from the Options pull-down menu.

 One time installation procedure:

 1) If you already have installed a previous version of PMZIP, delete all files
 in your PMZIP directory.  Otherwise create a directory to hold the PMZIP
 related files.  For example, "C:\PMZIP".

 2) Copy all PMZIP-related files to this directory.  At a minimum you need the
 following files:  PMZIP.EXE, PMZIP.HLP, and PMZIP.DLL. Note:  there is no need
 to include the directory containing PMZIP related files in your LIBPATH= or
 HELP= paths.

 3) Run PMZIP.EXE, either by double clicking on PMZIP.EXE in the File Manager
 or by entering PMZIP at the the OS/2 system prompt.  The first time you run
 PMZIP it will bring up the Install dialog box to complete the installation.
 If PMZIP cannot find PKZIP or PKUNZIP in your path, it will prompt you for the
 program locations with the Program locations dialog box.

 Optional steps:

 a) Add the directory created in step one to your PATH.  If you don't add the
 directory to your path, you'll need to type the directory name when you start
 PMZIP from the command line (for example, you'll have to type "C:\PMZIP\PMZIP"
 rather than just "PMZIP").

 b) Add the statement PMZIP /ICON to your STARTUP.CMD file. This will
 automatically start PMZIP as an icon whenever you boot OS/2, and facilitates
 use of the File Manager's Drag and Drop Interface.

 Install dialog box:

 The Install dialog box will add a PMZIP entry to the first Program Group in
 the Desktop Manager (usually "Group - Main"). It will also set a File Manager
 association for *.ZIP files.  This association lets you double-click on any
 ZIP file listed in the File Manager to automatically open the ZIP file with
 PMZIP.


ΓòÉΓòÉΓòÉ 8. Program locations ΓòÉΓòÉΓòÉ

The Program Locations dialog box is displayed during PMZIP initialization if it
can't find the OS/2 versions of the PKZIP or PKUNZIP commands.  If this dialog
box is displayed, type the name of the programs in the appropriate entry fields
and click on the OK button.  Specify either a fully qualified pathname (e.g.
C:\PKWARE\PKZIP.EXE), or, if you want PMZIP to search your path, just the
filename and extension (e.g. PKZIP2.EXE).

Note: PKWARE distributes the OS/2 versions of their products with a "2" or "F"
file name suffix (e.g. PKZIP2).  Since many users rename the files to remove
these suffixes, PMZIP automatically searches for all three file name formats
when it is first installed.


ΓòÉΓòÉΓòÉ 9. Opening ZIP files ΓòÉΓòÉΓòÉ

You can open ZIP files with the standard "New" or "Open" entries on the File
pull-down menu. These functions work like those of most other PM applications,
except that the Open dialog box features a File Search Facility that will list
all or selected ZIP files in your directory tree.

Alternately, you can open a ZIP file while using the File Manager's "Drag and
Drop" interface to add files to a new or existing ZIP file, as described in the
section titled Drag and Drop Interface. If you change the name of the ZIP file
in the Drag and Drop dialog box, then PMZIP will continue to work with the
specified ZIP file until you again change the name.

To save mouse clicks, PMZIP automatically brings up the Open dialog box if no
ZIP file is specified when the program is started. To disable this behavior,
click on the "Auto open dialog box" radio button in the Configuration dialog
box and save the default settings via the Defaults dialog box.

You can close the current ZIP file with the "Close" entry on the File pull-down
menu.  However, this menu entry is included primarily for completeness, since
the New, Open, and Drag and Drop dialog boxes all automatically perform this
action.


ΓòÉΓòÉΓòÉ 10. Adding files to a ZIP file ΓòÉΓòÉΓòÉ

There are two ways to add files to a ZIP:

1) Object-action interface:  use the File Managers "Drag and Drop" interface,
as described in the section titled Drag and Drop Interface.

2) Action-object interface:  click on the "Add" push button or select the "Add"
entry from the "Action" pull-down menu to bring up the Add dialog box.  Then
specify the file names you want to add (standard OS/2 wildcards are accepted).

The Add dialog box provides the following options:

 o The Add, Freshen, and Update radio buttons correspond to the PKZIP -a, -f,
   and -u options
 o The "delete original after adding" check box corresponds to the PKZIP -m
   option
 o The Size and Speed radio buttons correspond to the PKZIP -ex and -es options
 o The "Recurse subdirectories" check box corresponds to the PKZIP -r option
 o The "Store recursed pathnames" check box  corresponds to the PKZIP -p option
 o The "Store specified pathnames" check box corresponds to the PKZIP -P option


ΓòÉΓòÉΓòÉ 11. Deleting files from a ZIP file ΓòÉΓòÉΓòÉ

There are two ways to delete files from a ZIP:

1) Object-action interface:  first select entries in the list box, then click
on the "Delete" push button or select the "Delete" entry from the "Action"
pull-down menu.

2) Action-object interface:  click on the "Delete" push button or select the
"Delete" entry from the "Action" pull-down to bring up the "Delete" dialog box.
You can then specify the file names you want to delete (standard OS/2 wildcards
are accepted).


ΓòÉΓòÉΓòÉ 12. Extracting files from a ZIP file ΓòÉΓòÉΓòÉ

There are two ways to extract files from a ZIP:

1) Object-action interface:  first select entries in the list box, then click
on the "Extract" push button or select the "Extract" entry from the "Action"
pull-down menu to bring up the Extract dialog box.

2) Action-object interface:  click on the "Extract" push button or select the
"Extract" entry from the "Action" pull-down to bring up the Extract dialog box.
You can then specify the file names you want to extract (standard OS/2
wildcards are accepted) or extract all files in the ZIP.

The Extract dialog box lets you specify the directory to contain the extracted
files (note: the default directory for this prompt can be changed by selecting
"Extract Directory..." in the "Options" pull-down menu).

The Extract dialog box provides the following options:

 o The "Overlay newer files only" check box corresponds to the PKUNZIP -n
   option
 o The "Use pathnames" check box corresponds to the PKUNZIP -d option

 Note: the PKUNZIP -o option is always specified.


ΓòÉΓòÉΓòÉ 13. Viewing files in a ZIP file ΓòÉΓòÉΓòÉ

The View dialog box is used to view files in a ZIP file or view the results of
the last PKZIP or PKUNZIP command issued by PMZIP. Unlike most dialog boxes,
the View dialog box is sizeable and can be maximized.

There are three ways to view files in a ZIP file:

1) Double click on a file name in the list box listing files in the ZIP file.

2) Object-action interface:  first select entries in the list box, then click
on the View push button or select the "View" entry from the "Action" pull-down
menu.

3) Action-object interface:  click on the "View" push button or select the
"View" entry from the "Action" pull-down to bring up the View dialog box.  You
can then specify the file name you want to view.

Click on the Clipboard Copy push button to copy selected text to the system
clipboard.  Note: this button is disabled when no text is selected.


ΓòÉΓòÉΓòÉ 14. File Search Facility ΓòÉΓòÉΓòÉ

The File Search Facility is invoked by clicking on the Search button in the
Open dialog box.  Type a file name (standard OS/2 wildcards are accepted) in
the Pattern entry field of the Search dialog box and click on the Search button
to search an entire disk for the specified file(s).  You can then select any
file found by this procedure and click on the Open button to open the ZIP file.


ΓòÉΓòÉΓòÉ 15. Options ΓòÉΓòÉΓòÉ

The PMZIP option system consists of the following components:

The Option pull-down menu lets you specify whether the list of files in the ZIP
file is sorted by date, extension, size, name, or whether the original ZIP file
order should be used. It also lets you bring up the following dialog boxes
described below.

The Configuration dialog box lets you specify

 o Whether the default directory in the Extract dialog box is the current
   directory or a directory of your choice.
 o Whether the Open dialog box is automatically displayed when no ZIP file is
   specified when PMZIP is started.
 o Whether files in the ZIP file are listed in lowercase for the possibility of
   improved legibility.
 o Whether PMZIP should maintain a log of all error messages and all PKZIP and
   PKUNZIP commands it issues. The log is written to the file C:\PMZIP.LOG.
 o Whether PMZIP automatically changes the current directory when files are
   dropped to the directory containing the files being dropped.

 The Defaults dialog box lets you save the current defaults for use next time
 PMZIP is started, or restore the original distribution defaults. Options that
 are saved and restored by this procedure include all the options in the
 "Options" pull-down menu, all options in the Add, Configuration, Extract, and
 Program Locations dialog boxes, and the current screen size.  Note that this
 information is also saved if PMZIP is running when you select "Save" from the
 "Desktop" pull-down in the "Desktop Manager" window.

 The Install dialog box will add a PMZIP entry to the first Program Group in
 the Desktop Manager (usually "Group - Main").  It will also set a File Manager
 association for *.ZIP files.  This association lets you double-click on any
 ZIP file listed in the File Manager to automatically open the ZIP file with
 PMZIP.

 The Program locations dialog box lets you specify the file names used by PMZIP
 instead of the default PKZIP.EXE and PKUNZIP.EXE.

 The View last output entry in the Options pull-down displays the results of
 the last PKZIP or PKUNZIP command issued by PMZIP.


ΓòÉΓòÉΓòÉ 16. Error Handling ΓòÉΓòÉΓòÉ

When a PKZIP or PKUNZIP command issued by PMZIP returns a non-zero error level,
a dialog box is displayed listing the error level and error level description.
You can click on the "View command output" button to view all messages issued
by the command that caused the error.

PMZIP will optionally maintain a log of all error messages and all PKZIP and
PKUNZIP commands it issues. The log is written to the file C:\PMZIP.LOG.

Note:  When a critical error (e.g. an open drive door) occurs while the PKZIP
or PKUNZIP commands are running, you will get the standard OS/2 error screen.
This is because the PKZIP and PKUNZIP commands were not coded to handle these
errors.  PMZIP cannot control this behavior.


ΓòÉΓòÉΓòÉ 17. File Manager hints ΓòÉΓòÉΓòÉ

The OS/2 File Manager isn't the most versatile file management program, but it
is the only one available for OS/2 with a Presentation Manager interface. The
best way to learn to use it is to experiment and read the online help.
Pull-down all the menus, and if you don't know what an entry does, select it
and press the F1 key for context sensitive help (note: if you're using the
mouse, be sure to press F1 while holding down the mouse button).

Here are two hints for using the File Manager. Your suggestions for additional
hints are welcome.

1) By default the file manager does not list file sizes and modification dates.
You can change this by selecting "File details" from the "View" pull-down menu.
To automatically list files by date select "Sort by" from the "View" menu and
click on "Last modification date" in the "Sort by" dialog box and check the
"Set system default" button before closing the dialog box.

2) To open directories in the File Manager's tree display, double click on the
name, not the icon.  Clicking on the icon can expand or collapse a branch of
the tree, depending on whether there is a plus or minus sign in the directory
icon.


ΓòÉΓòÉΓòÉ 18. Keyboard usage ΓòÉΓòÉΓòÉ

PMZIP is easier to use with a mouse, but you can also use the standard PM
keyboard interface.  The Drag and Drop interface to the File Manager is not
available from the keyboard. Keyboard accelerators defined for PMZIP include:

 Ctrl+N    Open new Zip file.

 Ctrl+O    Open existing ZIP file.

 Ctrl+A    Add files to a ZIP file.

 Ctrl+D    Delete files from a ZIP file.

 Ctrl+E    Extract files from a ZIP file.

 Ctrl+V    View files in a ZIP file.


ΓòÉΓòÉΓòÉ 19. Future Enhancements ΓòÉΓòÉΓòÉ

Ideas for future enhancements include:

 o Support for all ZIP options, including passwords and comments
 o Ability to run programs in a ZIP file
 o Support for other file formats (e.g. ARC)
 o Optional hex dump mode when viewing files in a ZIP File

 Additional suggestions are welcome!


ΓòÉΓòÉΓòÉ 20. Notes ΓòÉΓòÉΓòÉ

 o This version of PMZIP was tested under OS/2 versions 1.20 and 1.30 with
   PKZIP and PKUNZIP versions 1.01.

 o PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc.

 o PMZIP does not manipulate ZIP files directly.  Instead it runs PKZIP and
   PKUNZIP for all operations.

 o PMZIP displays an hour-glass pointer to indicate that it is busy while the
   PKZIP and PKUNZIP commands are running.  You can, of course, switch to
   another OS/2 session during this time.

 o PMZIP supports most commonly used PKZIP and PKUNZIP options but the current
   version does not include special support for comments, passwords, and file
   attribute masks.

 o PMZIP will try to use the "System Monospaced" font (the file SYSMONO.FON)
   first introduced in the November, 1989 update to OS/2 1.2. If this font is
   not found it will use the standard Courier font.  The Courier font is always
   used for the text in the View dialog box because of a bug in some versions
   of OS/2 1.20.

 o PMZIP sometimes passes a temporary "list file" to the PKWARE, Inc. programs.
   PMZIP uses a unique filename for this file, and automatically erases it when
   it is no longer needed.  If you have a TMP= environment variable, temporary
   files are created in the specified directory. Otherwise they are created in
   the root directory of your C: drive.

 o Ideally PMZIP should use the same selection techniques as the File Manager
   for manipulating files in a ZIP file.  However, that facility is not
   currently provided by the Presentation Manager, and is quite time consuming
   to program from scratch.  Since Windows 3.0 provides this facility as a
   "Extended Selection List Box", we can hope it will be provided in the
   Presentation Manager in the near future, in which case I expect to use it in
   PMZIP. Meanwhile, the program uses the standard "Multiple Selection List
   Box", which, while not the ideal solution, should be familiar and easy to
   use.

 o PMZIP was written because I wanted a PM interface to ZIP files, and no other
   programs provided this facility.  The first version was written in
   Digitalk's Smalltalk V/PM.  The result, like all V/PM programs, required
   over a megabyte of code to execute, and was rather slow. Favorable response
   to the first version convinced me to rewrite the program in C and release it
   as Shareware.

 o Special thanks to Steve Queen for his feedback on the PMZIP user interface.