INTRODUCTION PMZIP(TM) Manual Version 1.0 Copyright (c) 1991 Nico Mak All Rights Reserved 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 documentation in this file is available as context sensitive help while running PMZIP. Just press F1 at any time. Hypertext links make it easy to navigate the online information, so give it a try! CONTENTS Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 PMZIP Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Copyright/License/Warranty . . . . . . . . . . . . . . . . . . . . . 5 Support and questions . . . . . . . . . . . . . . . . . . . . . . . 7 Quick start information . . . . . . . . . . . . . . . . . . . . . . 8 Drag and Drop interface . . . . . . . . . . . . . . . . . . . . . . 9 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Program locations . . . . . . . . . . . . . . . . . . . . . . . . 12 Opening ZIP files . . . . . . . . . . . . . . . . . . . . . . . . 13 Adding files to a ZIP file . . . . . . . . . . . . . . . . . . . . 14 Deleting files from a ZIP file . . . . . . . . . . . . . . . . . . 15 Extracting files from a ZIP file . . . . . . . . . . . . . . . . . 16 Viewing files in a ZIP file . . . . . . . . . . . . . . . . . . . 17 File Search Facility . . . . . . . . . . . . . . . . . . . . . . . 18 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . 20 File Manager hints . . . . . . . . . . . . . . . . . . . . . . . . 21 Keyboard usage . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Future Enhancements . . . . . . . . . . . . . . . . . . . . . . . 23 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . INDEX-1 page 3 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. page 4 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. page 5 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. page 6 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. page 7 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. page 8 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. page 9 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 page 10 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 414-352-3670). 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 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 page 11 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. page 12 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. page 13 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. page 14 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 page 15 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). page 16 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. page 17 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. page 18 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. page 19 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. page 20 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. page 21 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. page 22 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. page 23 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! page 24 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. page 25 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. INDEX A L Adding files to a ZIP file 14 License 5 C Copyright 5 O D Opening ZIP files 13 Options 19 Deleting files from a ZIP file Overview 3 15 Drag and Drop Interface 9 P E PKZIP, PKUNZIP, PKWARE 24 Program locations 12 Error Handling 20 Extracting files from a ZIP file 16 Q Quick start information. 8 F File Manager hints 21 S File Search Facility 18 Future Enhancements 23 Search Facility 18 Support and questions 7 I V Installation 10 Introduction 1 Viewing files in a ZIP file 17 K W Keyboard usage 22 Warranty 5 WhereIs 18 Index-1