File: README.TXT in the FNLOC.ZIP archive


|----------------------------------|
|	Kingdom Software Consultants Ltd |
|	ABC Function Locator		 |
|	Angus M Wood 100545,720		 |
|----------------------------------|


Compatibility: Access(tm) version 2.0 only, any JET version.
	       This should work under Windows95(tm), I've not tried it.

This archive contains:
	LOCATE.MDA	-	ABC Function Locator add-in
	README.TXT	-	(this file)


Thanks for taking the time to download this file, I hope you will 
find the system of use.


			DESCRIPTION
			^^^^^^^^^^^
The system, when installed as an add-in, can be used to scan any database
and compile a list of all the Access Basic Functions/Subs matching a user-
defined pattern. Version 2.0 and 1.1 databases may be scanned, as the same
format is used in both.

			INSTALLATION
			^^^^^^^^^^^^
Unzip the archive and place add-in [LOCATE.MDA] in your add-ins
directory. For people that don't use an addins directory, place
the files in the Access directory.
To make an addins directory, create a directory, and move in to it
all the .MDA files that are currently in your Access directory, 
except SYSTEM.MDA and UTILITY.MDA. Then edit the MSACC20.INI file
in your windows directory so that the [Libraries] section paths point
to the new location. Because WIZARD.MDA is now in that subdirectory
all addins that you add using the Add-in manager will be copied to
that subdirectory.
This saves a lot of clutter building up in the Access directory, and
makes things easier to find.

Use the Add-Ins manager to install the Function Locator, 
-or-
add a line to then MSACC20.INI [Menu Add-Ins] section, that reads;
&Locator==locate_Entry()
and to the [Libraries] section that reads;
C:\ACCESS2\ADDINS\locate.mda=rw


			 OPERATION
			 ^^^^^^^^^
Open the locator from the File > Addins > Locator menu, and the main form 
will appear. 

-----------------------------------------
|  Filter Mask or *			|   <-- Leave as * to list all.
|					|
|  Dir to search for databases	 ...  |   <-- enter directory to search or use
|					|	build button.
|  +----------------+			|
|  |		    |	<---------------| ----- Multi select list box showing all
|  |		    |			|	databases in selected directory.
|  |		    |			|
|  |		    |  Scan All btn <-| ----- Scan all databases in MSLB
|  |		    |			|
|  |		    |			|
|  |		    |  Start Scan btn	| <---- Scan selected databases in MSLB
|  |		    |			|
|  |		    |			|
|  +----------------+  Close btn	|
|					|
|					|
-----------------------------------------

The results of the search will be imported into your current database into a 
table called "tbl_FnLocatorResults" in the format;
Database name				Module name	Routine name
e.g.
strDBName				strObjectName	strRoutineName
c:\comms\cserve\uploads\att\ATT.MDB	basEvents	evt_DoUserEvent


The scan will fail to look at modules whose text is greater than 64K, due to the
methodology used. Also the system may run out of memory sometimes.
I'll fix both of these in the next version.


		      OTHER INFORMATION
		      ^^^^^^^^^^^^^^^^^
The build button beside the Directory edit box uses SWU2016.DLL, the 
setup wizard utilities DLL. If you do not have the ADT, is is unlikely
that you have this DLL, if it can not be found, the build button will 
be disabled and you must enter the directory by hand.

Most of the system is unsecured, the bit that *is* secured is the
actual scanning function. Why ?  Well, it took me a weekend with a hex 
editor, going over the system tables to figure out the format of the
compiled modules and write an interpreter function. If you want to know
how it is done, you can either;
 (A) Dump the MSysObjects table into a file and go over it as I did, or
 (B) Mail me with a proposition.
I know some people out there have already figured it out. This is not any
sort of breakthrough.

YOU ARE COMPLETELY PROHIBITED FROM CHARGING PEOPLE FOR THIS SYSTEM, 
SAVE THE NORMAL MEDIUM/DOWNLOAD/FTP FEE. IF YOU WISH TO INCLUDE THIS 
SYSTEM IN ANY "VALUE-ADDED" DISTRIBUTION, PLEASE INFORM ME FIRST.

All the usual disclaimers apply, suffice it to say that if you use it and
it causes a war, I don't want to be sued.

I do not speak for my employer, and all the references to Kingdom Software 
Consultants Ltd are purely a shameless plug, and in no way mean that KSC
take any responsibility for this system.

Any comments / questions / fan or hate mail to Angus M Wood at 100545,720 [CIS]
or 100545.720@compuserve.com [Internet] 
I would like to hear if you have any suggestions for improvement, or if you find
any bugs.

-EOF-