OS/2 Shareware BBS: InfoMgt/InfoMgt.zip/flho002b.zip/readme.inf

OS/2 Help File | 1997-07-30 | 52KB | 1,512 lines

ΓòÉΓòÉΓòÉ 1. Welcome to File Hound ΓòÉΓòÉΓòÉ

Welcome to File Hound!

This guide will introduce you to the features of File Hound and get you started
efficiently finding your documents!  The guide is divided into the following
sections:

     View the License Agreement

     Features

     Installation

     Known Problems and Limitations

     Troubleshooting

     Contact the Author

     Intellectual Property Notices

     File Hound Reference


ΓòÉΓòÉΓòÉ 1.1. License Agreement ΓòÉΓòÉΓòÉ

File Hound Beta 0.2b License Agreement

GRANT OF LICENSE

Aaron R. Gaalswyk (the AUTHOR) grants you a non-exclusive, non-transferable
license to the SOFTWARE (hereinafter defined), free of charge, provided that
you adhere to the terms of this license agreement.

The SOFTWARE is licensed, not sold.  The AUTHOR does not transfer title to the
SOFTWARE to you.  No rights are granted to you other than those listed in this
license agreement.  By installing or USING (hereinafter defined) the SOFTWARE,
you signify your agreement to the terms of this license agreement.

   1. DEFINITIONS

      As used herein, the following definitions shall apply:

        a. "SOFTWARE" shall mean the File Hound 0.2b object code and any
           accompanying files and documentation, including any files generated
           by the USE of the object code.

        b. "USE" shall mean the reading into and out of memory of the SOFTWARE
           and the execution of the SOFTWARE, in whole or in part.

   2. LICENSE

      You may:

        a. USE the SOFTWARE on one or more machines at the same time.

        b. USE the SOFTWARE on a network, provided that each person who USES
           the SOFTWARE complies with the terms of this license agreement.

        c. Make copies of the SOFTWARE or portions thereof for backup purposes.

        d. Make copies of the original distribution archive or repackage the
           files contained in the original distribution archive and
           redistribute those copies to any other party provided that

             1. All files contained in the original distribution archive are
                redistributed intact and unaltered.

             2. Any party which receives the copied or repackaged distribution
                archive complies with the terms of this license agreement,
                signified by installing or using the SOFTWARE.

      You may NOT:

        a. Lease, rent, sublicense, or assign the SOFTWARE, or otherwise
           transfer any rights to the SOFTWARE.

        b. Remove any notices or labels from the SOFTWARE.

        c. Reverse engineer, reverse compile, disassemble, translate, modify,
           create derivative works, or otherwise alter the SOFTWARE.

        d. Copy or redistribute the SOFTWARE other than as listed above.

   3. DISCLAIMER OF WARRANTY

        a. THE SOFTWARE IS PROVIDED ON AN 'AS IS' BASIS. NO WARRANTY IS GRANTED
           TO YOU BY THE AUTHOR, EITHER EXPRESSED OR IMPLIED, INCLUDING NO
           IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
           PURPOSE. THE SOFTWARE IS NOT INTENDED FOR USE IN ANY ENVIRONMENT
           WHICH REQUIRES FAIL-SAFE OPERATION.  SOME JURISDICTIONS DO NOT ALLOW
           THE EXCLUSION OF IMPLIED WARRANTIES, SO THE LIMITATIONS AND
           DISCLAMERS MAY NOT APPLY TO YOU.

        b. THE AUTHOR DOES NOT WARRANT THAT THE SOFTWARE IS FREE FROM CLAIMS BY
           ANY THIRD PARTY OF PATENT, TRADEMARK, COPYRIGHT, TRADE SECRET, OR
           ANY OTHER INTELLECTUAL PROPERTY INFRINGEMENT.

        c. THE AUTHOR IS NOT OBLIGATED TO PROVIDE UPDATES, FIXES, OR
           ENHANCEMENTS TO THE SOFTWARE.  UNDER NO CIRCUMSTANCES DOES THIS
           LICENSE ENTITLE YOU TO ANY UPDATES, FIXES, OR ENHANCEMENTS TO THE
           SOFTWARE.

        d. THE AUTHOR SHALL NOT BE HELD RESPONSIBLE OR LIABLE FOR ANY DIRECT,
           SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES OR LOSS OF PROFITS OR
           SAVINGS RESULTING FROM INSTALLATION OR USE OF THE SOFTWARE,
           INCLUDING BUT NOT LIMITED TO DAMAGES TO HARDWARE AND LOSS OR DAMAGE
           TO RECORDS OR DATA, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
           POSSIBILITY THEREOF.  THE AUTHOR SHALL NOT BE HELD RESPONSIBLE OR
           LIABLE FOR ANY DAMAGES CLAIMED AGAINST YOU BY A THIRD PARTY.

   4. TITLE

      The SOFTWARE is owned by the AUTHOR, and is protected under United States
      copyright laws and applicable treaties.  The AUTHOR reserves all rights
      to prosecute violation of this license in accordance with applicable law.

   5. EXPIRATION OF LICENSE

      License to the SOFTWARE expires on October 31, 1997.  After this date,
      your license to the SOFTWARE is terminated.

   6. TERMINATION

        a. You may terminate this license at your discretion, at any time.

        b. This license is automatically terminated if you fail to comply with
           the terms of this license agreement.

        c. Upon termination of license, you may no longer USE the SOFTWARE.
           You must destroy all copies of the SOFTWARE in your possession and
           on machines where you have administrative access.


ΓòÉΓòÉΓòÉ 1.2. Features ΓòÉΓòÉΓòÉ

What does File Hound do for you?

     Search documents for words, exact strings, patterns, or proximity between
      words.

     Restrict searches to groups of documents.

     File filters display popular document types.

     Launch user-defined applications on found documents.

     Save search results.

     Drag and drop with Desktop.

     Maintain multiple indexes.

     Customize indexing rules, stop words, and excluded documents.

     Automatic periodic indexing and re-indexing.

     Multithreaded indexing and searching.

     ZIP file support.

     Transparent access to remote server objects across a network.

     Remote administration of server objects.

     Restrict access using password authentication for multiple access levels.

     Future toolkit support for building your own client tools, file filters,
      and file store facilities.


ΓòÉΓòÉΓòÉ 1.3. Installation ΓòÉΓòÉΓòÉ

Installing File Hound

Hardware and software requirements:

     OS/2 3.0 or 4.0 or higher

     486 processor or higher

     8 MB RAM (12 recommended)

     VGA display (SVGA recommended)

     7 MB hard disk space for installation

     3 MB additional hard disk space for index minimal

     For remote access, a network supporting DSOM

 To install the software, unzip the contents of the distribution file and
 execute the INSTALL.EXE program.  The installation program will guide you
 through the installation steps.

 The installation package includes support for SOM 2.1.4, which will update the
 SOM support on your machine to the latest level.  If you do not require remote
 network accessand you are already running SOM 2.1.4, you do not need to
 install this component. For reference, SOM 2.1.4 files are dated 7-30-96.
 File Hound has not been tested with SOM 3.0, which is presently available for
 download from IBM.  If you wish to run File Hound on SOM 3.0, please contact
 the author.  If there is sufficient demand, a SOM 3.0-friendly release may be
 provided.

 Please note that you may install the two components in any directories you
 choose.  The defaults, C:\SEARCH and C:\SOM, are merely suggestions.  Do Not,
 however, install the SOM update over any existing SOM files, such as
 C:\OS2\DLL.

 Installation of the SOM update makes the following additions to your
 CONFIG.SYS:

     LIBPATH=%INSTALLDIR%\LIB

     SET PATH=%INSTALLDIR%\BIN

     SET DPATH=%INSTALLDIR%\MSG

     SET SOMDMESSAGELOG=%INSTALLDIR%\SOMD.LOG

     SET SOMIR=%INSTALLDIR%\ETC\SOM.IR

     SET SOMRUNTIME=%INSTALLDIR%

     SET SOMBASE=%INSTALLDIR%

     REM SET SOMSOCKETS=TCPIPSockets

     SET SOMDTIMEOUT=90

 Before you can use File Hound in "remote" mode, to access servers across the
 network, you must first un-REM the SOMSOCKETS statement in the CONFIG.SYS.  Be
 sure that Workgroup DSOM is properly configured before doing so, or else the
 program will not behave correctly.

 Note:  If your machine is already configured for workgroup DSOM, additional
 changes may be necessary. Please consult your system administrator for
 assistance.

 DSOM also requires two additional manual changes to your CONFIG.SYS :

 SET HOSTNAME
   The name of the machine as known by other computers on the network, or any
   name if you are not on a network.

   Example: SET HOSTNAME=MYCOMPUTER;

 SET USER
   The name of the user running the client program. This can be anything, but
   it must be set.

   Example: SET USER=SUSAN;


ΓòÉΓòÉΓòÉ 1.3.1. Networking with DSOM ΓòÉΓòÉΓòÉ

OS/2's Distributed SOM (DSOM) comes in two flavors: Workstation DSOM and
Workgroup DSOM.  OS/2 ships with Workstation DSOM, which lets you work with
distributed objects on a single computer.  Workgroup DSOM, on the other hand,
lets you do this as well as access remote objects across a network.

Workgroup DSOM may run on top of three network protocols:

 TCP/IP 2.0 or 3.0
   OS/2 3.0 and 4.0 come with TCP/IP included, so File Hound sets up DSOM to
   use TCP/IP as the default. DSOM TCP/IP support is enabled in the CONFIG.SYS
   by the statement SET SOMSOCKETS=TCPIPSockets.  This will only work if you
   have a permanent IP address which corresponds to the  HOSTNAME variable in
   your CONFIG.SYS.  Before you start either the server or client, the TCP/IP
   protocol stack must be running.

 Netware IPX/SPX (Netware Client 2.1.0)
   DSOM can use Netware, as long as you have an ipxaddrs file which maps
   Internet addresses to Novell IPX/SPX addresses. DSOM Netware support is
   enabled in the CONFIG.SYS by the statement SET SOMSOCKETS=IPXSockets. The
   SET ENV variable must be set to the directory where you have your hosts and
   ipxaddrs files.  You must also run the ipxconf utility.

 NetBIOS (IBM Lan Requestor 4.0)
   DSOM can use NetBIOS, which is enabled in the CONFIG.SYS by the statement
   SET SOMSOCKETS=NBSockets. NetBIOS support of course requires that you have
   MPTN installed.  You must also run the nbconf utility.

 Warning: The setup steps listed above for Netware and NetBIOS are going purely
 by the documentation available to the author at this time.  The author has not
 tested it, and recommends you run to your IBM contact for proper instructions
 on how to enable DSOM on top of Netware or NetBIOS.


ΓòÉΓòÉΓòÉ 1.4. Known Problems and Limitations ΓòÉΓòÉΓòÉ

     The Results viewer is very slow when loading large files.  There is no
      limit on file sizes which may be indexed, but 250K is probably the
      practical limit for the internal viewer for now.  If you are indexing
      large files, you should use the "Replace internal viewer" option on the
      second Properties View Viewers page.

     Printing is not yet supported.

     The program cannot yet save links to remote files.


ΓòÉΓòÉΓòÉ 1.5. Troubleshooting ΓòÉΓòÉΓòÉ

Best effort is made to ensure that File Hound is free of major problems.
Unfortunately, no software is totally bug-free, and File Hound is no exception.
If you experience any problem with the software, please contact the author, so
that the problem may be remedied.  Several types of bugs may be present:

     The software crashes.

     A feature does not work properly.

     A feature is not intuitive.

     The documentation is wrong.

 To best aid the author in determining the cause of the problem, please consult
 the following checklist:

   1. What kind of problem is it?

   2. What version of OS/2 are you using?  Is there anything special about your
      setup which may be affecting the software, such as the version of SOM
      installed or special changes you have made to the CONFIG.SYS?

   3. Under what circumstances does the problem occur? Is it reproduceable? If
      possible, please provide instructions on how to reproduce the problem.

   4. If the software is crashing,

          Can you determine whether the problem is in the client or server?

          Does the system show a popup-dialog which lists an error id, such as
           SYS3175 or SYS3171?  Does the dialog list the thread ID (TID)?

          Are there any entries in your DSOM error log?

          If the software has created an exception dump, C:\SASERROR.TXT, what
           are its contents?


ΓòÉΓòÉΓòÉ 1.6. Contacting the Author ΓòÉΓòÉΓòÉ

How To Contact The Author

     Email:

        -  Compuserve: 74063,621

        -  Internet: [e-mail]

     Mail:

            Aaron Gaalswyk
            7160 Lamar Ave. S.
            Cottage Grove, MN 55016
            USA
            Earth

     WWW: http://www.spacestar.net/users/gaalswyk


ΓòÉΓòÉΓòÉ 1.7. Intellectual Property Notices ΓòÉΓòÉΓòÉ

Intellectual Property Notices

     IBM, OS/2, and SOMObjects are registered trademarks of International
      Business Machines Corporation

     Windows is a registered trademark of Microsoft Corporation

     NetWare and IPX are registered trademarks of Novell Corporation

     WordPerfect is a registered trademark of Corel Corporation

     File Hound incorporates compression code by the Info-ZIP group. There are
      no extra charges or costs due to the use of this code, and the original
      compression sources, as well as executables for Zip and UnZip, are freely
      available from ftp://ftp.cdrom.com/pub/infozip/ on the Internet.  You can
      also visit their site at http://www.cdrom.com/pub/infozip/Info-Zip.html
      on the WWW

     File Hound Copyright (c) 1996-1997 Aaron R. Gaalswyk


ΓòÉΓòÉΓòÉ 1.8. Reference ΓòÉΓòÉΓòÉ

File Hound Reference

     Searching for documents

     Viewing search results

     Indexing documents

     Configuring File Hound


ΓòÉΓòÉΓòÉ <hidden> Open new Search View ΓòÉΓòÉΓòÉ

Open a new Search View.


ΓòÉΓòÉΓòÉ <hidden> Go to Primary View ΓòÉΓòÉΓòÉ

Switch focus the the Primary View button bar.


ΓòÉΓòÉΓòÉ <hidden> Open Properties View ΓòÉΓòÉΓòÉ

Open the Properties View.


ΓòÉΓòÉΓòÉ <hidden> Open Index View ΓòÉΓòÉΓòÉ

Open the Index View.


ΓòÉΓòÉΓòÉ 1.9. Help for Search View ΓòÉΓòÉΓòÉ

File Hound is capable of searching for documents on multiple server databases
or on the local machine.  Because document searching is aided by an index, it
is necessary at the very least to provide search terms over which the server
will select documents.  A more refined search includes these basic terms, as
well as a specific string, regular expression, or proximity of two words.
Searching over these additional fields will increase the relevancy of the
selected document list, but at the cost of longer search time.  Additionally,
you may enter other parameters which narrow the search to specific documents or
groups of documents.  A simple document search may be initiated by the
following steps:

   1. Select the server where you wish to search from the pull-down list. If
      the client is not network-attached, this option is non-functional.

   2. Fill out any of the  Required Parameters fields and/or at least one of
      the proximity fields.

   3. Select the Search! button from the menu bar or pull-down menu.

 A more refined search may be initiated by additionally doing any of the
 following:

     Fill out any of the Exact, Pattern, or Proximity fields.

     Provide a list of folders, files, or file patterns over which to search.

     Include a document group or groups from the Groups list.


ΓòÉΓòÉΓòÉ 1.9.1. Required Parameters fields ΓòÉΓòÉΓòÉ

The Required Parameters fields are used to enter the basic terms over which the
server is to query the index.  Each field may have any number of term or no
term at all, but at least one field must have at least one term, unless you are
doing a proximity search. Terms which are part of the server's stop list are
ignored, and are not useful to the search.

      Must Have The Must Have field is used to enter terms which must be
      present in a relevant document.  Any document which does not contain all
      the terms will be eliminated from consideration.  Thus more terms will
      increase the relevancy of selected documents, but will decrease their
      number.

      May Have The May Have field is used to enter terms which may be present
      in a relevent document.  Increasing the number of terms entered here will
      increase relevancy of selected documents.  This is generally the most
      useful field, since it lets you query the index for unfamiliar documents
      using a number of possibly relevant terms.

      Not Have The Not Have field is used to enter terms which must not be
      present in a relevant document.  Any document which contains any of the
      terms may be eliminated from the search.  Thus more terms will increase
      the relevancy of selected documents, but will decrease their number.


ΓòÉΓòÉΓòÉ 1.9.2. Exact, Pattern, and Proximity fields ΓòÉΓòÉΓòÉ

 Proximity
   The Proximity fields are used to search documents for words near each other.
   A proximity entry is completed by filling each entry field with one word,
   and turning the spin button to the required proximity value.  The order of
   the words makes no difference, and they are case-insensitive.  As an
   example, one might enter the words "Microsoft" and "Gates" with a value of
   5, which will search documents for the word "Microsoft" within 5 words
   before or after "Gates".

 Exact
   The Exact field may contain any combination of printable single-byte
   characters, including a space.  For instance, if you are a historian of U.S.
   presidential campaign speechs, you might formulate a search with a  Must
   Have parameter of "Clinton" and an Exact entry of "I feel your pain".
   Strings are case-insensitive.

 Pattern
   The Pattern field is used to search documents for a regular expression
   conforming to IBM's extended REGEX interface.  Pattern searches are
   relatively slow, so should be used with caution.


ΓòÉΓòÉΓòÉ 1.9.3. Files and Levels ΓòÉΓòÉΓòÉ

The Files section of the Search View interface is used to select specific files
or file patterns over which to limit a search.  The spin button to the left of
each entry field identifies the file store "facility" on which the file(s) is
stored. The entry field may identify the full path of the file, such as
"C:\CONFIG.SYS" or may use wildcards, as in "*.txt" or "e:\docs\*".

Facility note:  The file store facility defaults to "FileSystem," which is the
local file system of the server.  In the future, additional facilities may be
added, such as access to a Lotus Notes database.


ΓòÉΓòÉΓòÉ 1.9.4. Document Groups ΓòÉΓòÉΓòÉ

File Hound is capable of defining document groups which may be stored and
conveniently reused for many searches.  A document group may define specific
folders to search, as well as file patterns which are to be included or
excluded in the search. A document group may also inherit parameters from other
groups. A document group may be added to a search by selecting Add to Search
from its popup menu or dragging it with the mouse to the Selected Groups
container.  The Group Properties notebook has the following pages:

     Title

     Specific

     Include

     Exclude

     Parent


ΓòÉΓòÉΓòÉ 1.9.4.1. Title Page ΓòÉΓòÉΓòÉ

The name of the document group may be changed by altering the text of the Title
entry field.


ΓòÉΓòÉΓòÉ 1.9.4.2. Specific Page ΓòÉΓòÉΓòÉ

This page lists the precise folders (a.k.a. directories) over which to search
for relevant documents.  A new folder may be added by entering its name in the
entry field and pressing Add.  An existing folder may be removed by selecting
its name in the list and pressing Remove.


ΓòÉΓòÉΓòÉ 1.9.4.3. Include Page ΓòÉΓòÉΓòÉ

This page lists the file patterns over which to search for relevant documents.
A file pattern may identify the full path of the file, such as "C:\CONFIG.SYS"
or may use wildcards, as in "*.txt" or "e:\docs\*". A new file pattern may be
added by entering its name in the entry field and pressing Add.  An existing
file pattern may be removed by selecting its name in the list and pressing
Remove.


ΓòÉΓòÉΓòÉ 1.9.4.4. Exclude Page ΓòÉΓòÉΓòÉ

This page lists the file patterns which are to be excluded from the search. A
file pattern may identify the full path of the file, such as "C:\CONFIG.SYS" or
may use wildcards, as in "*.txt" or "e:\docs\*". A new file pattern may be
added by entering its name in the entry field and pressing Add.  An existing
file pattern may be removed by selecting its name in the list and pressing
Remove.


ΓòÉΓòÉΓòÉ 1.9.4.5. Parent Page ΓòÉΓòÉΓòÉ

This page lists the document groups from which the given group is to inherit
its parameters.  This lets you construct more complex document groups based on
other groups, reducing duplication of effort.  For instance, you might have a
"Press Releases" group and a "Announcement Letters" group, then create a
"Public Relations" group which inherits from both.  A parent group may be added
by selecting it from the pull-down list and pressing Add or dragging a parent
group object onto the relevant child group object.


ΓòÉΓòÉΓòÉ <hidden> Sort by ΓòÉΓòÉΓòÉ

The documents returned by a search may be sorted a number of ways.  You may
specify the initial sort order in the Search View, and then change it later in
the Results View.

 Rank
   Sort from highest rank to lowest.  A higher rank indicates a more probable
   match.

 File Name
   Sort alphabetically by file name.

 File Path
   Sort alphabetically by path and file name.

 Extension
   Sort alphabetically by file extension (if any).

 Age Ascending
   The newest files are listed first.

 Age Descending
   The oldest files are listed first.

 Size
   Sort from smallest to largest file size.


ΓòÉΓòÉΓòÉ <hidden> Server List ΓòÉΓòÉΓòÉ

This contains a list of available servers.  If the client is not
network-attached, the list is non-functional.


ΓòÉΓòÉΓòÉ <hidden> Display first ΓòÉΓòÉΓòÉ

You may trim the maximum number of returned documents by raising or lowering
this selection.


ΓòÉΓòÉΓòÉ <hidden> Start search ΓòÉΓòÉΓòÉ

Begin searching with the specified parameters.


ΓòÉΓòÉΓòÉ <hidden> Clear ΓòÉΓòÉΓòÉ

Clear all entries in the search fields or reset to their initial values.


ΓòÉΓòÉΓòÉ <hidden> Refine last query ΓòÉΓòÉΓòÉ

Retrieve the parameters used for the last query, if any.  Using this feature,
it is not necessary to re-type all the previous parameters when you wish to
start a new search similar to the last.


ΓòÉΓòÉΓòÉ 1.10. Help for Index View ΓòÉΓòÉΓòÉ

Before File Hound can conduct searches, you must provide it with a list of
documents which are eligible for searching.  File Hound extracts the
significant terms present in the documents, and catalogs them in an index.
Typically, the space required for the index is 5% to 8% of the size of the
referenced documents.

The indexing process may be customized in numerous ways:

     Provide file extensions, for example "*.exe," which do not make sense to
      search.

     Give stop words, which are common words present in most documents.  These
      words are ignored by the indexing engine, so do not bloat the index.

     Set limits on the minimum and maximum word size.

     Define which characters are valid parts of words.  For instance, if
      numbers are valid, then "two4one" will be indexed as one term, whereas if
      numbers are not valid, then "two" and "one" will be placed in the index.

     Enable periodic re-indexing of currently-indexed documents as well as
      monitor selected folders for new documents.

 The Index View is used to add documents to the index, as well as immediately
 update specific documents or the entire index.  Documents may be added to the
 index by completing the following steps:

   1. Select the server where you wish to index on from the pull-down list. If
      the client is not network-attached, this option is non-functional.

   2. Verify the that facility spin button refers to the correct file store.

   3. Navigate the folder structure of the Browse Files list to find documents
      or entire folders you wish to index.

   4. Add these folders to the Index Selections list on the right side of the
      Index View.  This may be accomplished several ways:

          Drag them to the selection list with the mouse.

          Double-click on a file.

          Select either Add or Add subfolders.

   5. Select the Index! button from the menu bar or pull-down menu.

 Files which have been queued to the index will be processed unless the server
 object containing the index is shut down.  At that point all queued files
 which have not been processed will be purged from the queue.  All processed
 files will be saved.  Closing the Index View will not interrupt the indexing
 process so long as you do not close the program which contains the index.


ΓòÉΓòÉΓòÉ <hidden> Browse Files ΓòÉΓòÉΓòÉ

You can select documents and folders to be indexed by navigating this list.
Double-click on a document to add it to the Index Selections list, which may
then be queued to the index.  Double-click on a folder to navigate into it.
Double-click on the ".." icon at the top of the list to go to the enclosing
folder.


ΓòÉΓòÉΓòÉ <hidden> Index Selections ΓòÉΓòÉΓòÉ

The documents and folders in this list will be queued to the index when you
press the Index! button.


ΓòÉΓòÉΓòÉ <hidden> Facility ΓòÉΓòÉΓòÉ

The file store facility defaults to "FileSystem," which is the local file
system of the server.  In the future, additional facilities may be added, such
as access to a Lotus Notes database.


ΓòÉΓòÉΓòÉ <hidden> Root folder ΓòÉΓòÉΓòÉ

Use this the return the root folder of the file store in the Browse Files list.


ΓòÉΓòÉΓòÉ <hidden> Add subfolders ΓòÉΓòÉΓòÉ

Add the selected documents, folders, and all sub-folders below the selected
folders from the Browse Files list to the Index Selections list.


ΓòÉΓòÉΓòÉ <hidden> Add ΓòÉΓòÉΓòÉ

Add the selected documents and folders from the Browse Files list to the Index
Selections list.


ΓòÉΓòÉΓòÉ <hidden> Remove ΓòÉΓòÉΓòÉ

Remove selected documents and folders from the Index Selections list.  If you
have not already pressed the Index! button, they will not be queued to the
index.


ΓòÉΓòÉΓòÉ <hidden> Select all files and folders ΓòÉΓòÉΓòÉ

All files and folders in the Browse Files list are selected. If you intend to
index an entire folder, it may be easier to add or drag that folder to the
Index Selections list rather than selecting its contents.


ΓòÉΓòÉΓòÉ <hidden> Deselect all files and folders ΓòÉΓòÉΓòÉ

All files and folders in the Browse Files list are deselected.


ΓòÉΓòÉΓòÉ <hidden> Select all index selections ΓòÉΓòÉΓòÉ

All files and folders in the Index Selections list are selected. You may press
the  Remove button or the Del key to remove the selected files from the list.


ΓòÉΓòÉΓòÉ <hidden> Deselect all index selections ΓòÉΓòÉΓòÉ

All files and folders in the Index Selections list are deselected.


ΓòÉΓòÉΓòÉ <hidden> Indexing progress ΓòÉΓòÉΓòÉ

The progress indicator shows the fraction of files queued to the index which
have already been processed.


ΓòÉΓòÉΓòÉ <hidden> Indexing log ΓòÉΓòÉΓòÉ

As the indexing engine completes indexing documents, the status log is updated
in increments of 5 documents if remote access is enabled, or every 1 document
if remote access is disabled.


ΓòÉΓòÉΓòÉ <hidden> Server list ΓòÉΓòÉΓòÉ

This contains a list of available servers.  If the client is not
network-attached, the list is non-functional.


ΓòÉΓòÉΓòÉ <hidden> Start indexing ΓòÉΓòÉΓòÉ

All documents and folders in the Index Selections list will be queued to the
index.


ΓòÉΓòÉΓòÉ <hidden> Clear selections ΓòÉΓòÉΓòÉ

Clear all documents and folders from the Index Selections list.  You may also
select them individually and either press  Remove button or the Del key.


ΓòÉΓòÉΓòÉ <hidden> Refresh index now ΓòÉΓòÉΓòÉ

Any documents in the index which have been altered since last indexed will be
queued to the index, and the index updated to reflect those changes.  Any new
documents in folders listed one the Periodic Properties Page 2 will also be
added to the index. References to documents which no longer exist will be
removed from the index.


ΓòÉΓòÉΓòÉ 1.11. Help for Results View ΓòÉΓòÉΓòÉ

When a search returns a number of documents, File Hound displays the results in
the Results View, which may be used to perform a number of operations on the
resultant document list:

     Sort the documents according to various criteria.

     Save links to all or selected documents.

     Scroll through matching search terms.

     Perform quick string matching searches.

     Open documents with user-defined editor or helper applications.

     Drag any documents onto another program or the Desktop.


ΓòÉΓòÉΓòÉ <hidden> Results list ΓòÉΓòÉΓòÉ

This lists all the documents returned from the search.  Each document displays
a rank, name, path, size, and write dates and times, which may be used to sort
list.  Documents may be dragged from the list onto the Desktop or onto other
programs to view or change them.  If you drag a document located in a Zip
archive or on a remote server, it will first be extracted to the client's
temporary area.


ΓòÉΓòÉΓòÉ <hidden> Text area ΓòÉΓòÉΓòÉ

The text area displays the ASCII text extracted from each document.  The
scrollbars on the right and bottom can be used to navigate through the
document.


ΓòÉΓòÉΓòÉ <hidden> Save all ΓòÉΓòÉΓòÉ

Create a folder on the Desktop and save links to all of the documents in the
Results list.  Documents on remote servers may not be linked to.  Documents
within Zip archives will be extracted to a temporary directory and linked to
there.  All documents in the File Hound temporary area will be deleted whenever
the program is started.


ΓòÉΓòÉΓòÉ <hidden> Save selected ΓòÉΓòÉΓòÉ

Create a folder on the Desktop and save links to all selected documents in the
Results list.  Documents on remote servers may not be linked to.  Documents
within Zip archives will be extracted to a temporary directory and linked to
there.  All documents in the File Hound temporary area will be deleted whenever
the program is started.


ΓòÉΓòÉΓòÉ <hidden> Previous match ΓòÉΓòÉΓòÉ

Scroll to and highlight the next matching term in the current document.


ΓòÉΓòÉΓòÉ <hidden> Next match ΓòÉΓòÉΓòÉ

Scroll to and highlight the previous matching term in the current document.


ΓòÉΓòÉΓòÉ <hidden> Previous file ΓòÉΓòÉΓòÉ

Go to the previous file in the Results list.  The first matching search term
will automatically be highlighted and scrolled to.


ΓòÉΓòÉΓòÉ <hidden> Next file ΓòÉΓòÉΓòÉ

Go to the next file in the Results list.  The first matching search term will
automatically be highlighted and scrolled to.


ΓòÉΓòÉΓòÉ <hidden> Find next string match ΓòÉΓòÉΓòÉ

Scroll to and highlight the next string which matches the string specified in
the search field at the bottom of the Results View.


ΓòÉΓòÉΓòÉ <hidden> Find previous string match ΓòÉΓòÉΓòÉ

Scroll to and highlight the previous string which matches the string specified
in the search field at the bottom of the Results View.


ΓòÉΓòÉΓòÉ <hidden> Search for strings ΓòÉΓòÉΓòÉ

You may search for any string in the current document by typing in the entry
field. After 3 characters are typed, the text in the entry field will be
colored blue to indicate a match, which is scrolled to, or red to indicate no
match present in the document.  You may scroll to the next and previous matches
by pressing the arrow buttons on the left and right.


ΓòÉΓòÉΓòÉ <hidden> Open with default association ΓòÉΓòÉΓòÉ

Open the current document with its default association.  This is akin to
double-clicking on the document's icon in the Workplace Shell.  If the document
is located on a remote server, it will be copied to the client's temporary area
before opening it.


ΓòÉΓòÉΓòÉ <hidden> Edit current document ΓòÉΓòÉΓòÉ

Edit the current document using the editor specified on the Second Viewers
Properties page. If the document is located on a remote server, it will be
copied to the client's temporary area before opening it.


ΓòÉΓòÉΓòÉ 1.12. Help for Properties View ΓòÉΓòÉΓòÉ

The Properties View may is used to control most aspects of the File Hound
runtime functions.  The following pages are defined:

 Viewers
   Specify editor and helper applications which may be launched from the
   Results View for editing and viewing documents.

 Password
   Set password protection for client program startup.

 Servers
   Enable or disable remote access (DSOM) and add or remove remote servers.

 Permissions
   Specify access permissions for this client on remote servers, and manage
   permissions for clients on remote servers.

 Indices
   Manager multiple indexes.

 Stop Words
   Define stop words for indexing.

 Extensions
   Prevent indexing of files with certain extensions.

 Periodic
   Periodically re-index already-indexed documents and monitor specified
   folders for new files.

 Indexing
   Control valid tokens for words, minimum and maximum word length, and
   indexing priority.

 Files
   View and optionally remove currently-indexed documents.

 Filters
   View available file filters.


ΓòÉΓòÉΓòÉ 1.12.1. Password Properties Page ΓòÉΓòÉΓòÉ

A startup password can be defined which will prevent other people from using
the software without entering the correct password.  The password is encrypted
on disk and is also used to encrypt passwords for accessing server objects, as
defined on the Permissions Properties Page.

 Require password when started
   Enable password authentication when the program is started.

 Password
   A password should be 5 to 15 alpha-numeric characters.  The password must be
   entered twice, to verify it is correct.

 OK
   Save changes to the password.

 Refresh
   Refresh the password status with the saved entry.

 Default
   Clear and disable startup password.


ΓòÉΓòÉΓòÉ 1.12.2. Viewers Properties Pages ΓòÉΓòÉΓòÉ

These pages let you specify applications which may be launched on found
documents.

     Helper Applications

     Primary Editor


ΓòÉΓòÉΓòÉ 1.12.2.1. Helper Applications ΓòÉΓòÉΓòÉ

The Helper Applications page defines the "helper" applications which you can
launch on any found document by selecting it from the File:Open As menu of the
Results View.

 Name
   The name as you want it to appear on the Results View's menu.

 Path to Program
   The path to the executable program.  If it is a Microsoft Windows 3.1
   program, the Path to Program should specify "winos2.com" instead of the
   program executable.

 Parameters
   Any parameters you wish to pass to the program, besides the file name.
   Parameters are passed before the file name.  If the program is a Microsoft
   Windows 3.1 program, the only parameter should be the path to the program,
   for instance "write.exe".

 Remove
   Remove the selected program from the viewer list.

 Add
   Add the program with entered name, path, and parameters to the viewer list.

 Browse
   Locate the executable on your hard drive.

 Clear
   Clear the entries in the Name, Path to program, and Parameters entry fields.

 Default
   Remove all programs from the viewer list.

 Refresh
   Refresh the viewer list.


ΓòÉΓòÉΓòÉ 1.12.2.2. Primary Editor ΓòÉΓòÉΓòÉ

The Primary Editor page defines the editor which is called from the Results
View when you select File:Edit current from the menu.  You may also replace
File Hound's internal text viewer with this editor by selecting Replace
internal viewer.

For example, to use HyperView PM, you would enter HVPM.EXE in the Path to
Program field and /K in the Parameters field.

 Path to Program
   The path to the executable program.

 Parameters
   Any parameters you wish to pass to the program, besides the file name.
   Parameters are passed before the file name.

 Browse
   Locate the executable on your hard drive.

 Change
   Save any changes to the editor or parameters.

 Default
   Revert to the default File Hound editor.

 Refresh
   Refresh the view with the saved editor.


ΓòÉΓòÉΓòÉ 1.12.3. Servers Properties Page ΓòÉΓòÉΓòÉ

File Hound uses IBM's System Object Model (SOM) to communicate between a client
and a server.  Each server is itself a SOM object, which may exist either
inside the client program if you are not on a network; or it may run in a
separate server process, which is accessible to the client on the machine where
the server resides, as well as to other clients across the network
simultaneously. Keep in mind that if you have not enabled remote access, then
the server and the client ARE the same program, so references to "client" and
"server" in the Online Help should be interpreted accordingly.

     Server on this machine

     Remote servers

     Add new remote server

     Default server

 Refresh
   Refresh the view with the current server list.

 Default
   Remove all remote servers, and revert to the default local server name and
   alias.

      CAUTION:
   Changing the server name will render remote clients unable to access to this
   machine without re-applying the generated distribution file.


ΓòÉΓòÉΓòÉ 1.12.3.1. Server on this machine ΓòÉΓòÉΓòÉ

 Local Alias
   This is how the local client is to reference the local server.  For
   instance, you could change the alias to "Susan's files".  Then, whenever
   "Susan's files" is selected in a pull-down menu, you will be acting on the
   local server. This setting has no effect on how remote clients perceive this
   server.

 Server Name
   This is the unique name stored in the DSOM Implementation Repository.  If
   the program is only used for local access, the choice of this name does not
   matter. On the other hand, if this server is to be visible to other clients
   on the network, then the Server Name MUST BE UNIQUE.

 Use DSOM
   When this is checked, the server object runs in a separate process and is
   visible not only to this client, but also other clients on the network.
   This settings has no effect on this client's ability to access remote
   servers.

 Change
   Update the configuration to reflect any changes made to the Local Alias or
   Server Name.  If a change has been made to the Server Name, a new
   distribution file will be generated in the base directory where the program
   is installed.  The distribution file will be of the form, "*.sid", where "*"
   is the Server Name truncated to 8 characters.

      CAUTION:
   Changing the server name will render remote clients unable to access to this
   machine without re-applying the generated distribution file.


ΓòÉΓòÉΓòÉ 1.12.3.2. Remote servers ΓòÉΓòÉΓòÉ

This section lists the remote servers which have been defined to this client.
Before you can perform an function on these servers--for instance
searching--you must define your access permissions.

 Remove
   Remove the selected server from the list of available remote servers.


ΓòÉΓòÉΓòÉ 1.12.3.3. Add new remote server ΓòÉΓòÉΓòÉ

This section lets you define a remote server for which this client is to have
access to.  Each server has its own distribution file, which contains
information that DSOM needs to make that server available to remote clients.
This file must be transferred to the client machine before that client can see
the said server for remote access.

 Local Alias
   This is how the local client is to reference the remote server, and can be
   any name you choose.  For instance, you could change the alias to "Bob's
   Computer".  Then, whenever "Bob's Computer" is selected in a pull-down menu,
   you will be acting on that server.

 Server Name
   Specify the exact, unique name of the server to add.  It must match the
   server name contained in the distribution file.

 Distribution File
   Specify the path to where the distribution file is located.  This file is
   only used when adding a new server, and need not be retained on the client
   machine.

 Add
   Add the new server with the given parameters in the Local Alias, Server
   Name, and Distribution File fields.

 Clear
   Clear the New Word, Server Name, and Distribution  File entryfields.


ΓòÉΓòÉΓòÉ 1.12.3.4. Default Server ΓòÉΓòÉΓòÉ

 Select server
   The default server is the server which is initially loaded in the
   Properties, Search, and Index views.  If remote access is disabled, the
   default is always the local server object.

 Connect on startup
   Immediately connect to the default server when starting the client.  This
   will increase load time, but you will not have to wait when it connects
   later.

 Connect when needed
   Defer connecting to the server until it is required.  This setting may be
   useful, for instance, if you place File Hound in your Startup Folder.


ΓòÉΓòÉΓòÉ 1.12.4. Permissions Properties Pages ΓòÉΓòÉΓòÉ

File Hound includes basic authentication security for access to server
functions.  Be advised that while the access permission files are encrypted,
communication between clients and servers is NOT SECURE. Thus you should not
transmit confidential data over a non-trusted network.

     Page 1 - This client

     Page 2 - Each server


ΓòÉΓòÉΓòÉ 1.12.4.1. Permissions for this client ΓòÉΓòÉΓòÉ

The Servers list shows the servers which are currently available for this
client to access.  For each server, you may enter your username and password,
along with the Access level with which you wish to access the server.  An
administrator should already have assigned a username, password, and
accesslevel using the Permissions for users on each server page.


ΓòÉΓòÉΓòÉ 1.12.4.2. Permissions for users on each server ΓòÉΓòÉΓòÉ

This page may be used by administrators to manage users on various servers.The
Servers list shows the servers which are currently available for this client to
access.  The Users list shows the currently-defined users for the selected
server.

 Add
   Add a new user to the selected server, with the given username and password.

 Remove
   Remove the selected user from the selected server.

 Change
   Update the password and access level of the selected user.

 Refresh
   Retrieve the current list of users on the selected server.


ΓòÉΓòÉΓòÉ 1.12.5. Indices Properties Page ΓòÉΓòÉΓòÉ

File Hound has the capability of maintaining multiple indexes on each server.
Only one index is active at any given time, and the existance of indexes is
transparent to the rest of the program.

 Set Current
   Marks the selected index as the current active index on the server.

 Remove
   Remove all traces of the selected index from the server.  You cannot remove
   the "default" index.

 Purge
   Remove all files in the selected index, and reclaim all disk space occupied
   by the index.

 Add
   Add a new index to the server. Type a name in the entryfield and press Add
   to update the index list.

 Clear
   Clear the new index entryfield.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or edit the index list.  You may
   only update the index list on a server on which you have Administrator
   access permissions.


ΓòÉΓòÉΓòÉ 1.12.6. Stop Words Properties Page ΓòÉΓòÉΓòÉ

File Hound includes a base list of common English words.  Such words are
usually non-specific, transitional words which add little contextual value to a
document, and thus are not useful for searching.  Several benefits are derived
from excluding these words from indexing and searching:

     The index size is reduced.

     Searching and indexing efficiency are improved.

     Searching produces more relevant documents.

 The Stop Words Properties page allows user editing of the stop list on any
 server, local or remote, at any time.  If you edit the stop list, you are
 advised to purge and re-index any indexes on the affected server.

 Remove
   Remove the selected word from the stop list.

 Add
   Add a new word to the stop list.  Type a word in the entryfield and press
   Add to update the stop list.

 Clear
   Clear the new word entryfield.

 Default
   Revert to the original File Hound stop list.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or edit the stop list.  You may
   only update the stop list on a server on which you have Administrator access
   permissions.


ΓòÉΓòÉΓòÉ 1.12.7. Extensions Properties Page ΓòÉΓòÉΓòÉ

The Extensions Properties page allows user editing of the list of file
extensions a server uses to exclude files from indexing on any server, local or
remote, at any time.  File Hound provides a base list of extensions which do
not make sense to search, such as executables, operating system files, and
graphics files. Extensions may include wild cards, for instance "IX*" and
"?ex".

 Remove
   Remove the selected extension from the exclude list.

 Add
   Add a new extension to the exclude list.  Type an extension in the
   entryfield and press Add to update the exclude list.

 Clear
   Clear the new extension entryfield.

 Default
   Revert to the original File Hound extension exclude list.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or edit the extension exclude
   list.  You may only update the extension exclude list on a server on which
   you have Administrator access permissions.


ΓòÉΓòÉΓòÉ 1.12.8. Periodic Properties Pages ΓòÉΓòÉΓòÉ

With File Hound, you may enable a server to periodically update the index and
optionally monitor specific folders (directories) for new files, which are
automatically added to the index.  The Periodic Properties pages let you
configure the periodic indexing behavior of any server, local or remote, at any
time.

To use the periodic indexer effectively, File Hound should be running at all
times. One way to accomplish this is to add it to your Startup Folder.  It is
also a good idea to select Connect on startup from the Servers Properties Page.

     Page 1 - scheduling

     Page 2 - folders


ΓòÉΓòÉΓòÉ 1.12.8.1. Periodic Indexing: Scheduling ΓòÉΓòÉΓòÉ

 Enable periodic indexing
   Enable or disable periodic indexing.  The server's periodic indexing service
   will be started with the current settings for daily or interval scheduling.

 Daily
   Update the index once per day at the given time.

 Interval
   Update the index whenever the Increment number of days, hours, and minutes
   has elapsed, starting at the give start date and time.  The Increment timer
   must be set between one hour and one month.

 OK.
   Update the server with the current settings.  Changes will not take effect
   until OK is pressed.

 Default
   Revert to the default File Hound periodic indexing settings.  Any chosen
   monitor folders are deleted, and periodic indexing is disabled.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or configure periodic indexing.
   You may only view or update periodic indexing on a server on which you have
   Administrator access permissions.


ΓòÉΓòÉΓòÉ 1.12.8.2. Periodic Indexing: Folders ΓòÉΓòÉΓòÉ

 Monitor following folders
   All folders in the list are checked whenever the periodic indexing interval
   expires. Any new documents are automatically added to the index and become
   available for searching.

 Remove
   Remove the selected folder from the monitor list.

 Add
   Add a new folder to the monitor list.  Select the file store from the
   facility spin box, type the fully-qualified path of the folder, and press
   Add to update the monitor list.

 Clear
   Clear the new folder entryfield.

 Default
   Revert to the default File Hound periodic indexing settings.  Any chosen
   monitor folders are deleted, and periodic indexing is disabled.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or configure periodic indexing.
   You may only view or update periodic indexing on a server on which you have
   Administrator access permissions.


ΓòÉΓòÉΓòÉ 1.12.9. Indexing Properties Page ΓòÉΓòÉΓòÉ

 Tokens
   File Hound's indexer analyzes documents with regard to their word content.
   By default, only alphabetic letters are considered parts of words, but other
   "tokens" may be optionally considered.  By selecting any character(s) in the
   list, then pressing OK, the indexer will see that character as a letter
   token.  For instance, if you enable the hyphen character, then
   "middle-class" will be indexed as one word; otherwise it would be indexed as
   "middle" and "class." If you edit the indexing tokens, you should purge and
   re-index any indexes on the affected server.

 Word sizes
   Minimum and maximum word sizes may be defined so that the indexer disregards
   words which are shorter than the minimum or longer than the maximum.
   Typically, words shorter than 3 or 4 characters are not useful for
   searching.  Exceptionally long words may represent nonsensical strings in
   the text, and thus should be ignored.

 Indexing priority
   You may customize the priority of the indexer.  This option is provided as a
   convenience for advanced users, and typically does not need to be altered.
   Increasing the priority will increase the indexing speed, but selecting
   Foreground or Server priorities will adversely affect other programs you are
   running.  The default is the maximum idle-time priority.

 OK
   Update the server with the current settings.  Changes will not take effect
   until OK is pressed.

 Default
   Revert to the default File Hound indexing settings.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or configure indexing.  You may
   only view or update indexing on a server on which you have Administrator
   access permissions.


ΓòÉΓòÉΓòÉ 1.12.10. Files Properties Page ΓòÉΓòÉΓòÉ

The Files Properties page lets you view and optionally remove documents from
the server's current index.  Additional index management tools are located on
the Indices Properties page.

 Remove
   Remove the selected document or documents from the index. Once a document is
   removed, it is not available for searching until it added to the index
   again.

 Remove all
   Purge the current index of all documents, reclaiming all space occupied by
   the index.

 Select all
   Select all documents in the document list.

 Deselect all
   Deselect all documents in the document list.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view or manage indexed files.  Any
   user may view indexed files, but only an Administrator user may alter the
   index.


ΓòÉΓòÉΓòÉ 1.12.11. Filters Properties Page ΓòÉΓòÉΓòÉ

 Current filters on server
   File Hound uses filters to process documents and display in the Results
   viewer.  Document types are determined by their content, not by file
   extension.  If File Hound cannot find a filter for a document, it is treated
   as ASCII text.

 Refresh
   Refresh the view with any recent changes on the server.

 Servers
   Select the server on which you wish to view available file filters.


ΓòÉΓòÉΓòÉ <hidden> Server Access Permissions ΓòÉΓòÉΓòÉ

File Hound defines 3 levels of permissions, which specify what types of
functions a user is allowed to perform on a server.

 Normal User
   Allows the user to search and retrieve documents, and view the stop list,
   extension exclude list, currently-indexed documents, and available file
   filters.

 Privileged User
   Allows the user all permissions granted to a Normal User, as well as
   indexing files.

 Administrator
   Allows the user unrestricted access to the server.  This includes changing
   permissions for users, managing indexes, and adjusting the stop words,
   extension exclude list, and periodic indexing service.