QSFILE (tm)
A QSEARCH (tm) FILE UTILITY
By Rich Olivieri and Vince Deegan
COPYRIGHT 1987 BY EQUIPPERS
ALL RIGHTS RESERVED

>> Permission is granted to use, copy and distribute <<
>> freely this User Supported version only. <<

IS IT RIGHT TO
ASK FOR MONEY?
==============

Many good programs are written and distributed FREE by authors who
are gainfully employed at other jobs, but many of us for one reason or
another have found it necessary to try to make a living at writing good
quality software. Some of us are home-bound due to personal or family
reasons and the writing of software programs allows us a freedom to
support ourselfs and our families. Others are trying to supplement
their incomes through their software. Is it right for these software
authors to ask money for their programs? Well, is it right for anyone to
expect to be paid for their labors? How many of us would put in a month's
worth of work and then tell our bosses..."No thanks, I don't want to be
paid!"

ABOUT THE PRICE!
================
QSFILE is being distributed as User Supported software. If you like it
and would like to register your support of this program then you can send $
15.00 to EQUIPPERS (see the file ORDER.FRM). If you register with the
enclosed form then I will see that you receive the next update to QSFILE FREE.
Registered users will also be notified of new programs that we develop and
receive a $20 % discount on any program they purchase. If you prefer you may
order one of the custom versions of QSEARCH in which case you pay only for the
custom version. In any case please pass QSFILE.ARC on to others...it may be
uploaded to any BBS or information service.

CUSTOM VERSIONS
===============
The high-speed search engine for QSFILE can be adapted to a variety of
applications. If you have a need to keep a file or files of text information
in a free-form then we can add a special interface to QSEARCH that will
give you fast and efficient access to your data. This interface is menu
driven and easy to use. You can specify the structure of the textbase...ie
define the records and fields to be delimited by something other then CR/LF.
Some examples of possible custom versions include:

QSCARD (tm) ...for any application that could use "hyper-text" type card file
with a cross-linked index and random access to the card-file. You can store...
bibliographic data, topic outlines, graphic/text screens, research notes,
recipies, coin/stamp catalogs...etc.

QSNEWS (tm) ...electronic publishing of newsletters with table of contents,
random access to articles, text-archives of past issues, topic indexes etc...

QSLIST (tm) ...for lists of phone numbers, addresses, file catalogs...etc

ONLINE Textbases...

For those who run BBS systems that specialize in providing textbased
information, we can provide a custom version to search file directories, lists,
newsletters, textfiles and do it all online. This special online version
checks for loss of carrier, dead calls etc.

QSKJV - QSEARCH & The King James Bible...

We have put together a version of QSEARCH with the King James Bible which
gives full-text search access to the Bible at very fast speeds. QSKJV comes
with a special menu for selecting Books or a range of books to be searched.
QSKJV is designed especially for use with the ASCII text files of the KJV
Bible that are published by the Informed Christian Network, BUT it can be
modified for other Bible formats. A demo of QSKJV is available on CompuServe
in the IBMSW and RELIGION sigs. You can also request a demo disk from us by
sending $3.00 to:

EQUIPPERS
1303 W. BUCKINGHAM RD #103/162
GARLAND, TX 75040

NOTE: The $3.00 for the demo disk is deducted from the price of QSKJV if you
order the full program.

QSKJV can be ordered with or without the ICN Bibles files...(SEE ORDER.FRM).

FOR PRICES AND INFORMATION ON ORDERING CUSTOM VERSIONS SEE => ORDER.FRM


WARRANTY AND DISCLAIMER:

NO WARRANTY IS STATED OR IMPLIED. QSFILE IS PROVIDED AS-IS AND THE
USER IS RESPONSIBLE FOR DAMAGE OF ANY KIND THAT MIGHT ARISE FROM THE
USE OF QSFILE.

THE USER OF QSFILE IS SOLELY RESPONSIBLE FOR DETERMINING USEFULNESS
AND EFFECTIVENESS OF BOTH PRODUCTS AND AS TO WHETHER EITHER PRODUCT
IS COMPATIBLE FOR ANY PARTICULAR MACHINE.

QSFILE HAS BEEN DEVELOPED WITH TEAMWARE UTILITIES.

============================
== QSFILE INSTRUCTIONS ==
============================

SET UP FILES
============

IF you obtained QSFILE from a BBS or information
service then you should have downloaded QSFILE.ARC...
which contains:

QSFILE.COM - the executable program
QSFILE.DOC - this file
ORDER.FRM - Use this to register QSFILE or order custom
versions.

Place the QSFILE.COM file in the drive and directory of your choice.
If you plan to call QSFILE.COM from other drives and/or directories
then you must include the full path at the DOS COMMANDLINE or include
the QSFILE.COM drive and directory in the PATH within your AUTOEXEC.BAT
file.

EXAMPLES:
B>A:QSFILE "SEARCH" *.TXT <-- This will invoke QSFILE from drive A:
and search files matching *.TXT in
the ROOT directory of drive B:

C:\BIBLE>QSFILE <-- This will call QSFILE if the
QSFILE.COM file is in the \BIBLE
directory or if the QSFILE drive and
directory is in the PATH statement.

NOTE: The file(s) to be searched must be in the current directory.

NOTE: To set the drive and directory of QSFILE.COM in the
PATH statement make sure your AUTOEXEC file contains
the following line:

PATH=C:\DIRECTORY
^ ^---- name of the directory
^------ drive
^--------------------------^
^
Substitute your drive & directory

TO RUN QSFILE
===============

FROM DOS COMMANDLINE:

QSFILE /W40GMCFHN "SEARCH PHRASE" FILE-PATTERN OUTPUT-FILE

/W40GMCFHN - These are switches or toggles.

W40 - This sets the format width for the word wrapping to
40 cols. The W switch must be followed by a two digit
number in the range of 40 to 80. The default width is 78
columns.

G OR M - Selects optional color set for Green monitors and
monochrome monitors. NOTE: QSFILE automatically
sets the monochrome color set if a monochrome card is
installed.

C - Means CASE is ON or significant ie
Caps will only match Caps

DEFAULT is CASE is OFF
Caps will match caps, Caps and CAPS

F - Send Results to an output file.

DEFAULT is OFF ie send results only to the screen.

The FILENAME for the output file is built from
the search phrase. This default output filename can
be overridden at the command line by specifying a filename
following the FILE-PATTERN.

H - This restricts the search to wHole words only.
Default is OFF, ie. ROOT searches

N - No pause...ie QSFILE will just search each file, count the
finds and print a summary at the end. Text of finds will not
be printed to the screen, but can be printed to a file or PRN
if the /F switch is on.

"SEARCH PHRASE" - The search phrase can consist of a word or a phrase and
must be enclosed in double quotes " ".

FILE-PATTERN - Any valid DOS filename with or without wildcards can be
entered for a FILE-PATTERN. Wildcards will be expanded
according to MSDOS rules.

EXAMPLES:
cat*.txt
i?m.*

OUTPUT-FILE - The filename for the output file can be specified here
if the /F switch is also specified. The output filename
can be PRN to direct the output to a printer.


GENERAL FEATURES
================

HIGHLIGHTING - QSFILE will highlight the search string within
context line that is printed. Also the very
first word of each line is highlighted to show
where that line begins. Highlighting the first
word of each line printed is helpful when the
line is wrapped to the next row.

SCREEN PAUSES - QSFILE will pause only when it finds a match and
when the screen is filled. At the screen pauses
you can choose to abort the search, continue
with screen pauses or continue without screen
pauses. Pauses can be suppressed with the /N.

SEARCH SUMMARY - At the end of a search QSFILE will display a summary
of the cummulative total of matches and the totals
of matches by file. This screen can be printed using
the Prt Sc key. This summary is also printed to file
when you send the results of the search to a file.

SPEED - QSFILE will search most files at a rate of 40,000 bytes
per second. Higher rates are possible with some
files, when CASE is OFF or if with faster hardware.
The 40k+ rate is based on using a hard disk drive and
an ARC X-Turbo IBM/XT Clone running at the 4.77 Mhz
speed. Using this same system, a rate of 64k or more
has been achieved when running at the 7.14 Mhz speed.
One user has reported that a 4.4 megabyte file was
completely searched in 36 seconds using an AST AT.

TIMING OF SEARCHES - The time that is reported by QSFILE is only the actual
time it takes to read and search a file. The time
does not include time taken for screen pauses.

TO ABORT A SEARCH - At anytime during a search [between pauses] you
may abort the search by pressing any key. The
program will pause and ask if you want to abort
the search. If you answer 'Y' for yes then the
program will return to the Bible menu or to
DOS if it was started from command line.

TYPES OF FILES - QSFILE will search any PCDOS/MSDOS text file ie a file
containing ASCII text where each line ends with
a CR/LF sequence and is not longer than 255 characters.
QSFILE will also search binary files for ASCII strings,
but will only print 255 characters of the file for
each match. QSFILE will may not be able to search some
files which are not typical DOS text files such as system
and hidden files.

WORD WRAPPING - Each time the search string is found in the target
file, a portion of the context is printed to the
screen. For text files this portion consists of lines
of text bounded by CR/LF sequence. If the line to be
display is longer than the specified WIDTH (40 to 80 cols)
then the line is wrapped to the next row. With text files
this wrapping occurs at whole words so that no word is
broken.

Word-wrapping is turned off when a file with an
extension of .COM, .EXE, or .ARC is searched, when
the size of the line to be printed is longer than
255 characters or when the line does not contain any
spaces. When word-wrapping is off the line to be
printed is wrapped to the next row, but this may cause
some words to be broken.