Professional Documents
Culture Documents
-------------------------
Users Guide and Reference
-------------------------
Version 4.4E
March 1991
���������Ŀ
���������Ŀ � (tm)
� �o �������������������
� ���������Ŀ � Association of
� � ��� Shareware
���ij o � Professionals
���ij � ���������������������
����������� * Member *
Patri-Soft
Table of Contents
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 1
Features. . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Using PSEARCH . . . . . . . . . . . . . . . . . . . . . . . . 3
Using PSEARCH Menu Mode. . . . . . . . . . . . . . . . . . 3
Function Selection Menu . . . . . . . . . . . . . . . . 3
Text Search Entry Display . . . . . . . . . . . . . . . 5
File Name Search Entry Menu . . . . . . . . . . . . . . 6
Special Editing Functions . . . . . . . . . . . . . . . 7
Advanced Options Entry Menu . . . . . . . . . . . . . . 8
PSEARCH output data display . . . . . . . . . . . . . . 9
PSEARCH Command Line Mode. . . . . . . . . . . . . . . . . 11
Command Parameters. . . . . . . . . . . . . . . . . . . 11
Setting Default parameters in the DOS Environment. . . . . 22
Screen Colors and Monitor Support . . . . . . . . . . . . . . 23
Pausing the Search. . . . . . . . . . . . . . . . . . . . . . 23
Bonus Features for Registered Users . . . . . . . . . . . . . 23
Maintenance History . . . . . . . . . . . . . . . . . . . . . 24
Registering PSEARCH and other Patri-Soft Utilities. . . . . . 27
Site Licenses . . . . . . . . . . . . . . . . . . . . . . . . 28
VISA/MasterCard Telephone Registration Orders . . . . . . . . 28
PSEARCH Registration form . . . . . . . . . . . . . . . . . . 29
Reporting Problems . . . . . . . . . . . . . . . . . . . . . 30
i
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 1
--------------------------------------------------------------------
Introduction
------------
When you need to find a file on your disk but do not know its
filename or even directory, you most always know something unique
about this file. If not, you would probably not be searching for
it. This unique information might me a person's name, a product
name, a type of process, or even a location. Whatever it is,
PSEARCH can take this information and use it to search all files on
the disk to identify one or more files that contain this unique
data.
Since PSEARCH can reduce your search from a list of 2000 files to
just a few files, your job of locating a file becomes effortless.
Quick examination of a few files easily lets you know if the
desired file is on your disk.
PSEARCH goes farther than searching for data. Once files are found,
you can automatically invoke other DOS programs and utilities to
process them. PSEARCH becomes a powerful driver for other programs.
Here are a list of some of the many possible uses for PSEARCH.
** Look for word "Mrs" in any file and preserve case in search.
** Find 123 files containing the word "BUDGET" and print their name.
** Search for a file name even if it has been archived into .ZIP,
.ARC or .LZH formats.
Using PSEARCH
-------------
PSEARCH may be executed directly from the DOS prompt or using menus
that guide you through the process of entering search
specifications. Both techniques use the same 'PS' command. PSEARCH
determines the difference in modes by the presence or absence of
command line parameters. When no command parameters are used, menu
operation is selected.
To start PSEARCH using the menu mode, enter the PS command at the
DOS prompt and press the <Enter> key. The following menu will
be displayed...
--------------------------------------------------------------------
PSEARCH - File Searcher Copyright 1991 by Patri-Soft
F U N C T I O N S E L E C T I O N
--------------------------------------------------------------------
PSEARCH Main Menu
Exit to DOS. You may exit PSEARCH menu mode by either selecting
the Exit menu item or by simply pressing the <ESCAPE>
key from menu mode.
--------------------------------------------------------------------
PSEARCH - File Searcher Copyright 1991 by Patri-Soft
Text(1): _____________________________________________
Text(2): _____________________________________________
Text(3): _____________________________________________
Text(4): _____________________________________________
Text(5): _____________________________________________
Once all data is entered, you may immediately start the search by
pressing the <F10> key, or may specify advanced search options by
pressing the <F9> key. The advanced options entry menu allows
further specifications to be made. You may use the <F3> key to
temporarily exit to a PSEARCH window to execute DOS commands. You
may enter any DOS command in this window.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 6
--------------------------------------------------------------------
The F10 key may be pressed from any location on this display. If
you use the <Enter> key to proceed through each item on the
display, pressing <Enter> on the last item will begin the search.
--------------------------------------------------------------------
PSEARCH - File Searcher Copyright 1991 by Patri-Soft
This entry screen works like the Text Entry display discussed earlier.
See the command parameter descriptions for more information about the
parameters you may enter.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 7
--------------------------------------------------------------------
--------------------------------------------------------------------
PSEARCH - File Searcher Copyright 1991 by Patri-Soft
--------------------------------------------------------------------
PSEARCH - File Searcher Copyright 1991 by Patri-Soft
Searching *.* for (this) Opt ==> SHOW MULT ANYCASE MORE
--------------------------------------------------------------------
Searching *.* files for string (this)
** More? <Enter> for more, <C> for continuous, <ESC> terminate ***
--------------------------------------------------------------------
Path(#1) C:\WP 27 FILE= WILLAM.BRO
--------------------------------------------------------------------
PSEARCH Output Display
The top and bottom portion of the output display are reserved for
statistical information to keep you aware of what PSEARCH is
searching during processing. The center portion of the display
shows the data found that matches the search specifications.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 10
--------------------------------------------------------------------
For each found text match, PSEARCH displays the file name and data
matching the search criteria. The filename is shown on a line
before the matching text. This line also shows the date and time
the file was last updated or created and the size of the file in
characters. If DOS attributes are present in the DOS directory
entry for the file, they are also shown.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 11
--------------------------------------------------------------------
Command Parameters
------------------
COMMAND FORMAT:
[fspec]
Enter the DOS file specification for the directory and file
names to be searched. If no directory name is specified the
current directory will be searched. If the /S option is
specified, the directory name portion of this parameter is
not used.
Like DOS, use the '*' to indicate the last part of a filename
or filename extension may be any set of characters. Also
like DOS, use the '?' to indicate that any single position of
a filename may be any character.
1. *.EXE
2. TEST*.*
3. *TEST*.*
4. DO?FIX.*
5. PC*XX.*
6. C:\DOS\*.*
7. \TEST\*.*
8. !WD*.*
9. ~WORD.*
/AO Archive type files Only - If you have files on your system
that are compressed into archive files with DOS extension
names of .ZIP, .ARC, or .LZH, PSEARCH is to search only these
files. This parameter is only useful for file name searching.
PSEARCH does not decompress these file contents for text
search requests.
Use /AT:U to locate all files that have been updated since
your last backup was done.
Exact case searching is useful for those cases where you know
the text is specified in an exact way. It potentially
reduces the number of false matches that may be encountered
during the search.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 14
--------------------------------------------------------------------
/DR:cd
/DS Directory path search. Normally PSEARCH will search only the
current directory or the entire disk of /S is also specified.
The /DS parameter indicates PSEARCH is to search the
specified or current directory and all of its subordinate
directories for files.
PS C:\WP\*.*/t:emergency/ds
Like DOS, use the '*' to indicate the last part of a filename
or filename extension may be any set of characters. Also
like DOS, use the '?' to indicate that any single position of
a filename may be any character.
You must tell PSEARCH what you want selected for search, and
what you want excluded. PSEARCH supports both of these, making
use of the SEL and EXC commands. Placing a SEL in front of the
filename or pattern tells PSEARCH to select that file, while
putting an EXC tells PSEARCH to exclude it. If nothing is
specified, PSEARCH assumes EXC.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 16
--------------------------------------------------------------------
1. EXC *.EXE
2. *.COM
3. EXC TEST*.*
4. EXC *TEST*.*
5. EXC DO?FIX.*
6. ESC PC*XX.*
7. EXC C:\DOS\*.*
8. EXC \TEST\*.*
9. EXC D:\GAMES**\*.*
10 SEL TEST.XXX
11 SEL FIND.EXE
10. Even though all files containing the word TEST are
excluded, using a SEL statment tells PSEARCH to search
just that filename or pattern.
11. Same concept as above. Even though all the *.EXE files
are excluded, the SEL statement forces PSEARCH to look
in that file.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 17
--------------------------------------------------------------------
Activating exclude --
/FP Find Prefix - (use with /T:) Indicates that matching text
must be at the end of an existing word. Designed primarily
for word searches, find prefix qualifies the search to help
you find exactly the match you want.
/FS Find Suffix - (use with /T:) Works like find prefix, except
finds the matching text only if it preceeds an existing word.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 18
--------------------------------------------------------------------
/FW Find Word - (use with /T:) The text to be searched for is a
word. Only select text that is a complete word. A word is
defined as any string of characters and numbers that is not
preceded or succeeded with other characters or numbers.
/L Line numbers. When you are searching DOS text files for
specific text (/T: parm used), use the /L parameter when you
want PSEARCH to determine and display the number of the line
associated with the text displayed.
DOS text files are those files that have a carriage return
and line feed at the end of each line of text. A good
example of these is DOS batch command files (*.BAT). Word
processing files often do not use this format and so line
number specifications are not often useful for them.
/NO No mOre - Normally PSEARCH will stop at the end of each full
display of lines. You may press <ESCAPE> to terminate
processing, <C> to disable more and display without stopping
again, or press any other key to display another page of the
display and stop again. /NO disables this feature.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 19
--------------------------------------------------------------------
/O:nnn Olddays - Indicates that only files older than nnn days are
to be selected for processing. /O:365 will cause files over
one year old to be selected.
/R:nnn Near specification for multiple text searches. You may use
the /R parameter when you have also specified multiple /T:
parameters to cause PSEARCH to search for multiple sets of
text. /R specifies a number of characters that may exist
between the first characters of the text to be searched. In
other words, the text will only be considered a match if it
is within n characters of all other text specified.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 20
--------------------------------------------------------------------
PS *.*/t:jones/t:near/r:50/ta
/RT Related text. During text searches /RT will cause PSEARCH
to attempt to display up to 10 lines of text related to the
matching text being shown. In many cases, less than 10
lines of text may be shown when PSEARCH detects unprintable
data or changes in paragraph structure.
/T:text to be searched
Text - Specifies the text to be found for text search
requests. The text string may contain any characters. A
terminating command line or the following slash character
will signal the end of the text to be searched. If this is
the last parameter on the command any trailing spaces will
not be included in the search. To include trailing spaces,
terminate the string with an ending slash character.
Examples:
Examples:
/XF:xxx eXecute File - Works like /X except that the command is not
executed, it is generated and placed in a DOS batch command
file named PSCMDS.BAT in the current directory. This file may
be edited before it is executed.
Use the DOS SET command to specify the parameter name and contents
to be used by PSEARCH each time it is started. The following
example indicates the /EX exclude parameter specification is to be
automatically provided to PSEARCH each time it is used in the
command mode.
SET PSEARCH=/D/M
Even if the Pause parameter is not specified, you may pause the
search at any time by pressing any keyboard key. At the end of the
next process PSEARCH will pause. You will then have the opportunity
to continue processing, use a function key, or exit from PSEARCH.
------------------------------------------------------------------
Enhancements...
-- Add ability to search up to 5 text strings
-- AND/OR capability on text strings
-- New exclude file allows user to specify file names
-- New menu structure
-- Near parameter to force multiple text matches to be within
n characters of each other.
-- /NW implements no window mode for those that need or prefer
DOS style displays.
-- /DS parameter allows a single directory path including all
subordinate directories to be searched.
-- The limit of the number of directories that can be searched
greatly enhanced. The maximum number of directories is
related to the amount of free memory available to PSEARCH.
Items removed...
-- The Peak feature has been removed.
-- The 5 text strings replaces the ability to specify a ?
in the text search string.
-- The exclude file replaces the /SK command to skip
.COM and .EXE files.
PSEARCH Users Guide/Reference Copyright 1991 Patri-Soft Page 26
--------------------------------------------------------------------
Version 4.1 February 26, 1990
-- System lockup during speaker beeps. Also improper beeps.
-- Set sounds off as default
-- Set pause at full screen (more) as default in command mode
You may use the order form on the next page when registering.
Patri-Soft
P.O. Box 8263
San Bernardino, CA 92412
You may place a telephone order for the utilities using your credit
card by calling Nelson Ford's Public (Software) Library.
REGISTRATION
------------
When you register the below versions, you will receive registration
codes along with the latest version of the utility.
Name: __________________________________________________
Company: _______________________________________________
Address: _______________________________________________
_______________________________________________
Method of Payment:
____________________________________________________________
If BBS (name/number)____________________________________________
Name: __________________________________________________________
Company: _______________________________________________________
Address: _______________________________________________________
_______________________________________________________
Zip: ______________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
Suggested solution:
________________________________________________________________
________________________________________________________________