                        ----------------------------------
                         PKZFIND (tm)  USER MANUAL
                        ----------------------------------



Copyright (C) 1996-1997 PKWARE, Inc. All Rights Reserved.

No part of this publication may be reproduced, transmitted, 
transcribed, stored in a retrieval system, or translated into 
any other language in whole or in part, in any form or by
any means, whether it be electronic, mechanical, magnetic,
optical, manual or otherwise, without prior written consent
of PKWARE, Inc.

PKWARE, INC. DISCLAIMS ALL WARRANTIES AS TO THIS SOFTWARE,
WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION
ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, FUNCTIONALITY, DATA INTEGRITY OR
PROTECTION.

PKWARE, the PKWARE logo, and PKZIP are registered
trademarks of PKWARE, Inc.  PKZFIND is a trademark of PKWARE, Inc.

Trademarks of other companies mentioned in this documentation
appear for identification purposes only and are the property
of their respective companies.




USING PKZFIND


PKZFIND can search for any file on your hard disk, including files that 
are in a .ZIP file (files compressed by PKZIP). You can tell PKZFIND to 
just search for a file, or search for a file "and" automatically move to the 
directory in which that file exists.

With PKZFIND, you can search for:

    *     A single file.

    *     Multiple files.

    *     Files that are contained in a .ZIP file.

    *     Files that are contained in a self-extracting .ZIP
          file (.EXE files).

    *     Directory names.

You can also access multiple drives.

Even if you don't know the exact name of a file, you can specify a partial 
filename and PKZFIND will find all files that match that file pattern. 
Whatever your file-finding needs, you can customize PKZFIND to fit 
those needs. 

Note:     PKZFIND looks at files in "share" mode, meaning that it is
          compatible with network software and LANs. 



USING PKZFIND WITH YOUR COMMAND LINE

PKZFIND is command-line driven, which means that you type all of your 
commands at an operating system command prompt. For example, if your computer 
is currently on the C drive, you would type your PKZFIND commands 
at the following prompt:

     C:\>

Because it uses the command line, PKZFIND takes advantage of 
several features. For example, you can tell PKZFIND to search in a 
specific directory or on a specific drive. You can also use such features as 
wildcards (* or ?) to help PKZFIND further define your search.

Although this is not an operating system manual, it does contain basic operating
system information, as it pertains to using PKZFIND. Refer to your 
operating system documentation. The Sample Search Commands section 
at the end of this section contains several examples of file searches. 
Hopefully, these examples will closely fit your own file searching needs.



THE PKZFIND COMMAND

The command you use to search for files is pkzfind. No matter what operating 
system conventions you use, pkzfind is always the first thing you type 
at the command prompt.



UNDERSTANDING PKZFIND

When PKZFIND finds an occurrence of the file that you request, it 
displays information about that file. It also allows you to continue the 
search for other occurrences, or end the search. This is handy when you 
specify a partial match, for example, if you want to search for all files
that begin with the letter "B." Because there might be more files that begin 
with the letter B than can fit on one screen, displaying one file at a time 
prevents you from missing some of the files that PKZFIND finds.

You can customize PKZFIND to display all files at once. Refer to 
ENHANCING YOUR SEARCH WITH PKZFIND OPTIONS for more information.



WHERE CAN PKZFIND SEARCH?

PKZFIND can search wherever you tell it to. You can search a specific 
drive on your computer, or in a specific directory. If you do not specify a 
drive or directory, PKZFIND automatically searches on the current drive 
that you're working on, and begins from the root directory. So even if you 
are a couple of directories deep on your drive, for example, \jobs\full\, 
PKZFIND searches "backwards" to the "\" directory.

Note:     The "root" directory is the highest directory level on a
          drive, often denoted as \ . For example, if you're on the
          C drive, it would be C:\.

          Also, PKZFIND will search sub-directories as soon as it encounters
          them. For example, if you are searching for a file called TEST.DOC
          and that file appears both in the current directory "and" a 
          sub-directory, PKZFIND might find the version in the sub-directory
          first.

With PKZFIND, you can also search on more than one drive at the same 
time.

Refer to the SEARCHING ON A DIFFERENT DRIVE and SEARCHING IN A SPECIFIC 
DIRECTORY sections under GETTING STARTED for more information.


CANCELLING A SEARCH

You can cancel your search at any time. To do so, hold down the Ctrl key 
and type c. The search stops and the command prompt appears.


USING HELP

Help for PKZFIND is always available. At the command prompt, type
pkzfind -h and press ENTER. You can also just type pkzfind.

Sometimes, when you type the pkzfind command incorrectly, help 
automatically appears on your screen.



GETTING STARTED

This section contains all the information you need to perform a simple 
search using PKZFIND. It also shows you what happens when PKZFIND 
finds a file and what happens when PKZFIND doesn't find a file.

In this section, you will learn to:

    *     Search for a single file.

    *     Search for multiple files.



SEARCHING FOR A SINGLE FILE

To search for a file:

1.   Start your computer. Make sure your screen is at a command prompt (for 
     example, C:\). If you are running Windows, start a command prompt window.

2.   At the command prompt, type pkzfind, a space, and the name of the file 
     you want to search for. For example, if you want to search for a file 
     named resume.doc, you would type the following and press ENTER:

          pkzfind  resume.doc



If PKZFIND finds the file, the following happens:


     Version and copyright information appear, then 
     the following prompt:

          /JOB/RESUME.DOC 4534 09-2-94 0:45:48 More (ynj)?

     The more (ynj)? prompt allows you to continue or 
     stop your search. For information on how to 
     respond to this prompt, go to step 3.


     PKZFIND displays the following information
     when it finds a file:

          *    PKZFIND copyright information.

          *    The directory in which the file is located.

          *    The name of the file.

          *    The size of the file in bytes.

          *    The date and time the file was last 
               modified.

If PKZFIND doesn't find a file, the following happens:

     The following message appears:

          No files found

     Note:     PKZFIND version and copyright information also appear.

     The command prompt appears.


3. To search for the next matching file, type y.

    PKZFIND continues to search. If another match is found, the
    information pertaining to that file is displayed and 
    the following prompt appears:

          more (ynj)? 

     If PKZFIND does not find another 
     match, the following appears, followed 
     by the command prompt:

          (x) files found.

     where x is the number of files found.


To stop searching, type n. 

     PKZFIND stops searching and the command
     prompt appears.

To jump to the directory in which the file appears 
and stop searching

Type j

     PKZFIND opens a new command prompt box, then jumps to 
     the directory in which the file appears and stops 
     searching. The command prompt appears.

Note:  If you are using a different "command prompt interpreter," 
       PKZFIND might not "jump" to the desired location 
       if the command prompt interpreter defaults to a 
       different location.        


SEARCHING FOR MULTIPLE FILES

PKZFIND allows you to search for multiple files at one time. You can use 
one of the following methods:

     *    Typing more than one filename.

     *    Using wildcards to specify a partial file pattern.


TYPING MORE THAN ONE FILENAME

To type more than one filename, put a space between each filename in 
your pkzfind command. For example, if you want to search for a file 
named RESUME.DOC and a file named letter.doc, you would type the 
following and press ENTER:

     pkzfind  resume.doc  letter.doc



SPECIFYING A FILE PATTERN USING WILDCARDS

Sometimes when you're searching for a file, you're not sure of the entire 
name of the file, but know at least a partial name or the file extension (for 
example, .DOC). In this case, you can use the wildcard symbol, the 
asterisk (*). For example, you might want to search for all files that 
contain the .DOC extension. To search for those files, you would type the 
following and press ENTER:

     pkzfind  *.DOC

This tells PKZFIND to search for all files on the current drive that end in 
.DOC. The asterisk indicates that the name of the file can be anything, as 
long as it ends in .DOC.

For more information on wildcards, refer to your documentation.



TELLING PKZFIND WHERE TO SEARCH

Now that you've learned to do a basic file search with PKZFIND, the next 
step is to learn how to tell PKZFIND to search in a particular location, for 
example, a specific directory or drive.

In this section, you will learn to:

     *    Search on a different drive.

     *    Search on multiple drives.

     *    Search in a specific directory.



SEARCHING ON A DIFFERENT DRIVE

PKZFIND allows you to search on a drive other than the drive you are on. 
To search on a different drive, type the name of the drive after the 
filename. For example, if you want to search for the file named 
RESUME.DOC on the D: drive while you are on the C: drive, you would 
type the following and press ENTER:

     pkzfind  resume.doc  d:

If you type only the drive letter with a backslash (\) and not a directory, 
PKZFIND starts the search in the root directory, which is \.

For more information on drives, refer to your operating system documentation.



SEARCHING ON MULTIPLE DRIVES

With PKZFIND, you can search on multiple drives at the same time. For 
example, if you know that the file named RESUME.DOC is either on the 
C drive or D drive, you could type the following and press ENTER:

     pkzfind  resume.doc  c:  d:

If the file resides on both drives, PKZFIND will find and display both 
occurrences of that file.



SEARCHING IN A SPECIFIC DIRECTORY

If you don't specify a directory in which to search, PKZFIND 
automatically starts to search from the root directory on your current drive 
(for example, C:\) and searches through every directory under that root 
directory. However, with PKZFIND, you can search in any directory that 
you want.

For example, if you know that the file named RESUME.DOC is 
somewhere under a directory named jobs and you want PKZFIND to only 
search under that directory, you could type the following and press 
ENTER:

     pkzfind  resume.doc  \JOBS

If the file you're searching for is on a different drive, for example, D:,
you would type something similar to the following:

     pkzfind  resume.doc  d:\JOBS

     Note:     Don't forget to put the backslash (\) before the name of the
               directory. When you specify directories using PKZFIND, follow
               the rules of your operating system. For more information on 
               directories, refer to your operating system documentation.
      


ENHANCING YOUR SEARCH WITH PKZFIND OPTIONS

PKZFIND contains several options that help you enhance your file 
search. For example, you can tell PKZFIND to jump to the location at 
which it finds a file, or you can indicate that you only want PKZFIND to 
search inside .ZIP files. Each option is represented by a single letter that 
you include in the pkzfind command. You can also combine most of these 
options in a single command. 

The information that PKZFIND displays when it finds a file differs from 
option to option. For example, if you use the -b option (display only the 
filename), PKZFIND only displays the name of the file, not the size, date 
or time. If you use the -z option (search only in .ZIP files), PKZFIND
displays the name of the .ZIP file "and" the file that you're searching for 
that is contained in that .ZIP file. 

The following is a list of PKZFIND options:


     -b   Display only the filename.


     -c   List all matching files without stopping, 
          and skip the more (ynj)? prompt.

          Normally, PKZFIND searches one file 
          at a time and gives you the opportunity 
          to continue the search or stop the search.

          You should always use this option whenever
          you re-direct output from your PKZFIND command
          to a file or printer. Otherwise, your search will
          stop "without" the prompt appearing. (Even though
          the More (ynj)? prompt won't appear, you can still
          type y, n, or j.)

     -d   List directories that have the same name 
          as the file(s) that you specified.


     -j   Jump to the drive and directory in which 
          PKZFIND finds a file.


     -z   Search only in .ZIP files (for files that 
          were compressed by PKZIP).


     -e   Search also in self-extracting .ZIP files 
          (.EXE files).


     -n   Search only for files that are "not" 
          contained in a .ZIP file.


     -m   Use less memory to search in .ZIP and .EXE files by
          removing the use of memory mapped files.

          Using this option might significantly slow down your
          search, especially if you also use the -t option with
          the -m option.  (this option is not used on versions
          of PKZFIND run on OS/2)


     -o   Open the .ZIP or .EXE file that contains the
          file(s) for which you are searching.  (on OS/2
          this option will only run .EXE's, it will not 
          open a .ZIP)


     -t   Make sure PKZFIND does not skip files within
          self-extracting .ZIP files (.EXE files) during its
          search.


You can also search for a file based on "size." You can specify bytes, 
kilobytes, or megabytes, depending on your needs. You can also specify a 
range of sizes. For example, you can search for all files that are larger 
than 100 bytes but smaller than 200 bytes.


     *    To search for files that are equal to or "larger" than xxx bytes
          type a forward slash (/) "or" minus sign (-), a plus sign (+),
          and the number of bytes (for example, pkzfind  /+555). 

          PKZFIND finds all files that are equal to or larger than the number 
          of bytes you type.


     *    To search for files that are equal to or "smaller" than xxx
          "bytes," type forward slash (/) "or" minus sign (-), a minus
          sign (-), and the number of bytes (for example, pkzfind  /-555). 

          PKZFIND finds all files that are equal to or smaller than the number 
          of bytes you type.


     *    To search for files that fall within a size range, in bytes
          (for example, equal to or "larger" than 9500 bytes but smaller 
          than or equal to 11,000 bytes), type a forward slash (/), a plus
          sign (+), the minimum number of bytes, a minus sign (-) and the
          maximum number of bytes (for example, pkzfind  /+9500-11000).

          Do not put a space between the two values. 

          Also, you can type the values in any order. For example,
          the maximum value first and the minimum value last
          (pkzfind  /-11000+9500). You must put the forward slash in front 
          of the "first" value you type.


     *    To search for files that are equal to or "larger" than xxx
          kilobytes, type forward slash (/) "or" minus sign (-), a plus
          sign (+), the number of kilobytes, and the letter k.

          Do not put a space between the number and the letter (for example, 
          pkzfind  /+100k).


     *    To search for files that fall within a size range, in kilobytes
          (for example, equal to or "larger" than 95 kilobytes but smaller 
          than or equal to 110 kilobytes), type a forward slash (/), a plus
          sign (+), the minimum number of kilobytes, the letter k, a minus
          sign (-), the maximum number of kilobytes, and the letter k (for 
          example, pkzfind /+95k-110k).

          Do not put a space between the two values. 

          Also, you can type the values in any order. For example, the
          maximum value first and the minimum value last
          (pkzfind  /-110k+95k). You must put the forward slash in front 
          of the "first" value you type.


     *    To search for files that are equal to or "larger" than xxx
          megabytes, type forward slash (/) "or" minus sign (-), a plus
          sign (+), the number of megabytes, and the letter m.

          Do not put a space between the 
          number and the letter (for example, pkzfind  /+10m).


     *    To search for files that fall within a size range, in megabytes
          (for example, equal to or "larger" than 2 megabytes but smaller
          than or equal to 3 megabytes), type a forward slash (/), a
          plus sign (+), the minimum number of megabytes, the letter m, a
          minus sign (-), the maximum number of megabytes, and the
          letter m (for example, pkzfind /+2m-3m).

          Do not put a space between the two values. 

          Also, you can type the values in any order. For example, the
          maximum value first and the minimum value last (pkzfind /-3m+2m).
          You must put the forward slash in front of the "first" value you
          type.


For more information on the options listed above, refer to the appropriate 
sections in this file. For information on how to use these options, refer 
to the INCLUDING AN OPTION IN THE PKZFIND COMMAND and USING MORE THAN 
ONE OPTION SIMULTANEOUSLY sections that follow.



INCLUDING AN OPTION IN THE PKZFIND COMMAND

You can put a PKZFIND option anywhere in the command line, but it 
must be separated from other elements in the command (for example, a 
filename) by spaces. The example below uses the -d option, which allows 
you to search for directories.

     pkzfind  -d  resume.doc

In this example, you also could have typed one of the following:

     pkzfind  resume.doc  -d

     pkzfind  resume.doc  /d

     pkzfind  /d  resume.doc



USING MORE THAN ONE OPTION SIMULTANEOUSLY

PKZFIND allows you to use more than one option in a single command. 
To combine options, type the options right next to each other in the 
pkzfind command, using one dash (-). Do not put a space between each 
option. For example, if you combined the -b (display only the name of the 
file) and -j (jump to a directory) options and are searching for the file 
RESUME.DOC, you would type the following and press ENTER:

     pkzfind  -jb  resume.doc

You can type the options in any order.



DISPLAYING FILENAMES ONLY

Normally, when PKZFIND displays a file, it includes the name, size, date, 
and time for that file. When you use the -b option, PKZFIND only 
displays the name of the file. For example, if you type 
pkzfind  -b  resume.doc and PKZFIND finds the file named 
RESUME.DOC in the \work\jobs directory, your screen would look 
similar to the following:

     C:\> pkzfind  -b  resume.doc

      /WORK/JOBS/RESUME.DOC

     1 file found.

     C:\>


Note:     PKZFIND version and copyright information also appears.



DISPLAYING ALL MATCHING FILES AT ONCE

Normally, PKZFIND displays one file at a time and prompts you if you 
want to search for more. When you use the -c option, PKZFIND displays 
all matching files at once and does not prompt you.

Note:     If you search for a file match and anticipate more than one
          screenful of matches, you might not want to use this option 
          because some files might flash on and off your screen before you 
          have a chance to see them.



DISPLAYING DIRECTORIES WITH THE SAME NAME AS A FILE         

When you use the -d option, PKZFIND displays directories that have the 
same name as the file(s) you specified. For example, if you have a file 
named jobs and a directory named jobs, PKZFIND would display both 
and look similar to the following:

     C:\>  pkzfind  -d  jobs

     /JOBS/                               08-23-94   12:24:34
     
     /WORK/RESUME/JOBS             3792   10-12-94   10:02:28
          
     
     1 file found.
     
     1 directory found.

     C:\>

The first line contains the directory name.

Note:     PKZFIND version and copyright information also appears.

Note:     To "only" display directory names, use the -d, -z, and -n
          options together.



JUMPING TO A DIRECTORY IN WHICH A FILE WAS FOUND

When you use the -j option, PKZFIND automatically jumps to the 
directory in which the file is located. For example, if you type 
pkzfind  -j  resume.doc and PKZFIND finds the file named 
RESUME.DOC in the \work\jobs directory, your screen would look 
similar to the following:

     C:\> pkzfind  -j  resume.doc

PKZFIND opens a new command prompt box, displays the following, 
then jumps to the directory in which the file appears and stops 
searching. The command prompt appears.


     /WORK/JOBS/RESUME.DOC          33792   10-12-94   10:02:28
     
          
     1 file found.

     C:\WORK\JOBS>

Note:  If you are using a different "command prompt interpreter," 
       PKZFIND might not "jump" to the desired location 
       if the command prompt interpreter defaults to a 
       different location.
        
      
Note:  PKZFIND version and copyright information also appears.

Notice that you are now in the directory in which PKZFIND found the file 
(in this example, \work\jobs).



SEARCHING FOR FILES CONTAINED IN .EXE FILES

When you use the -e option, PKZFIND also searches for files that are 
contained in a self-extracting .ZIP file (a self-extracting .ZIP file that
has a .EXE extension). When PKZFIND displays files that are contained in a 
self-extracting .ZIP file, those files appear indented under the name of the 
.EXE file. For example, if you have a file named RESUME.DOC that is 
contained in a self-extracting .EXE file named WORK.EXE, your screen 
would look similar to the following:

     C:\> pkzfind  -e  resume.doc

     /WORK/*JOBS/WORK.EXE

     * RESUME.DOC                  3792          10-12-94        10:02:28

     1 file found.

     C:\>

When PKZFIND searches .EXE files, it has to determine if 
the .EXE file is a "self-extracting" .EXE file. Because of this, some 
files within a self-extracting .EXE file (to search) might be 
inadvertently skipped. To prevent this from happening, you can use the
"-t" option with the "-e" option. 


Note:     PKZFIND version and copyright information also appears.

Note:     To "only" search in .EXE files and not .ZIP files nor files
          outside of .EXE files, use the -e, -z, and -n options
          together.



SEARCHING ONLY FOR FILES CONTAINED IN A .ZIP FILE

When you use the -z option, PKZFIND searches only for files that are 
contained in a .ZIP file. To include self-extracting .ZIP files in your 
search, use the -e option also. In the following example, the file named 
RESUME.DOC is displayed only because it is contained in a .ZIP file:

     C:\> pkzfind  -z  resume.doc



     /WORK/JOBS/TEMP.ZIP
     
          * RESUME.DOC             3792   10-12-94   10:02:28
     
           
     1 file found.
    
         
     C:\>


Note:     PKZFIND version and copyright information also appears.

Note:     To search in .ZIP and .EXE files only, use the -e and -z
          options together.



OPENING THE .ZIP or .EXE FILE IN WHICH FILES ARE FOUND

When you search inside .ZIP or .EXE files for individual files, you 
can have PKZFIND open that .ZIP or .EXE file using the -o option. For
example, if you use the -z option to search inside .ZIP files, and you
also want to open the .ZIP file that contains the individual files,
you would type something similar to the following:

      C:\> pkzfind  -z  -o  resume.doc


You can also use this feature with the More (ynj)? prompt by typing "o"
at the prompt.

If the desired file is found in a self-extracting (.EXE), 
PKZFIND will execute the file. If the .EXE file is a DOS self-extracting 
file, all files in the .EXE file will be extracted. If the .EXE file is 
a Windows self-extracting file, the "extract" dialog box (the box 
that automatically appears for Windows self-extractors) will appear. 

If the desired file is found inside a regular .ZIP file, the application
associated with .ZIP files will be started. If no application is associated
with .ZIP files, nothing will happen.



SEARCHING ONLY FOR FILES NOT CONTAINED IN .ZIP FILES

When you use the -n option, PKZFIND does not look in .ZIP files. For 
example, if the file named RESUME.DOC appeared in the \work\jobs 
directory in its regular form and in compressed form in a .ZIP file, 
PKZFIND displays only the non-zipped version, as shown in the 
following:

     C:\> pkzfind  -n  resume.doc
         
     
     /WORK/JOBS/RESUME.DOC                33792   10-12-94   10:02:28
     
         
     1 file found.
     
     C:\>


Note:     PKZFIND version and copyright information also appears.



SAMPLE SEARCH COMMANDS

This section contains some sample PKZFIND search commands. The 
purpose of these samples is to show you some of the ways you can search 
for files, including the use of PKZFIND options. While browsing through 
these examples, you will notice that there is usually more than one way to 
type a command for the same search. All of these samples use an example 
file named RESUME.DOC.

Each sample contains the following:

     *    The search criteria used.

     *    The command(s) that you can type.

     *    A brief description of the sample.



Sample 1  -  Search on the current drive for a single file.

                    pkzfind  resume 

This is the simplest pkzfind command you can type.


Sample 2  -  Search on the current drive for any file that begins with
             any specific file pattern.

                    pkzfind  resume.*

             The wildcard (*) indicates that the file can end in 
             any text, as long as it begins with "resume."


Sample 3  -  Search on the current drive for any file that ends with the 
             a specific extension.

                    pkzfind  *.doc

The wildcard (*) indicates that the filename can be anything, as long as 
the extension is .DOC.


Sample 4  -  Search for a file in a specific directory under the root 
             directory (\).

                    pkzfind  resume.doc  \work\jobs
               
                    pkzfind  resume.doc  work\jobs
               
                    pkzfind  \work\jobs  resume.doc

                    pkzfind  work\jobs  resume.doc

This sample assumes that you are typing from the root 
directory. Notice that you have the option of whether or 
not to begin the directory path with a backslash (\).


Sample 5  -  Search for a file in a sub-directory of the directory that is 
             immediately above the directory you are in.

                    pkzfind  resume.doc  ..\jobs

                    pkzfind  ..\jobs  resume.doc

The double periods (..) indicate that you want to search 
from the directory that appears above the directory that 
you are in.


Sample 6  -  Search for a file on the current drive and only display the 
             filename (not the size, date, and time).

                    pkzfind  resume.doc -b
                    
                    pkzfind  resume.doc /b
                    
                    pkzfind  -b  resume.doc
                    
                    pkzfind  /b  resume.doc

You can use either the dash (-) or forward slash (/) to 
precede a PKZFIND option.


Sample 7  -  Search on a different drive.

                    pkzfind  resume.doc d:

                    pkzfind  d:  resume.doc

You must always include a colon (:) when specifying a 
drive.


Sample 8  -  Search on a different drive and specifying a directory in 
             which to search.
              
                    pkzfind  d:\work\jobs  resume.doc
                    
                    pkzfind  resume.doc d:\work\jobs


Sample 9  -  Search on a different drive, include directories in your 
             search, and request a continuous listing of files.

                    pkzfind  d:  -cd  resume.doc
                    
                    pkzfind  resume.doc -cd  d:
                    
                    pkzfind  -cd  resume.doc d:
                    
                    pkzfind  -c  -d  resume.doc d:


Sample 10  -  Search for files that are larger than or equal to "xxx" 
              bytes but smaller than or equal to "xxx" bytes

                    pkzfind  /+9500-11000  resume.doc
                    
                    pkzfind  /-11000+9500  resume.doc


