README.TXT
==========
Thank you for your interest in our Find-Member Utility. Please read this
document carefully. It will help you to upload the utility to your AS400
and install it there within a few minutes.


OVERVIEW
--------
The Find-Member Utility lets you search for specific member(s) across
files and libraries. The standard AS400 wildcard characters are supported
when you start a search; in other words, you can search for a specific member,
supply a generic name or search for *ALL members. Same goes for the files
you search through. Libraries included in the search can be your *LIBL, 
*ALLUSR, your current library or a particular library name.

You can either print the found member names or have them come up in a subfile.
In the subfile, you can browse, edit, print, copy, rename or delete the members. 
You can also compare them with the IBM CMPPFM command or find a particular 
string by searching across them.

Though intended as a tool to help you manage your source-file members, the utility
can be used on all AS400 file-members, that means you can use it track members in
physical files (PF) too, not just in source-files (PF-SRC). Some IBM supplied 
functions that can be called from the utility are not supported if you load 
physical file members. For instance, you can't edit them with SEU.


INSTALLATION
------------
You downloaded FNDMBR.ZIP and opened it and found 2 files. The first one is
README.TXT which is currently displayed. The second file, FNDMBRSF.FILE, is an
AS400 save-file (*SAVF). Please follow the steps described below exactly to
upload this save-file to your AS400.

In WinZip (or the compatible utility you use) select FNDMBRSF.FILE and click on
EXTRACT. Specify the directory to extract to, then click the EXTRACT button.
After that has been completed, you should see FNDMBRSF.FILE in the directory you
indicated.

Next, you must establish an FTP-connection from the PC you are working on to your
AS400. Both your PC and your AS400must be on a TCP-IP network in order to enable
that connection. Using FTP, you will upload the save-file to your AS400.

Go to a DOS-prompt. Type in the following commands: (Note: Replace all parameters
in the example below with your actual system values. In the examples, these parms
start with My... So instead of MyAS400, enter the name of your AS400; instead of
C:\MyDirectory, enter the name of the directory where you actually downloaded the
file, etc.)

FTP MyAS400 

You will be prompted to sign on. Enter your User-ID and password when prompted.
You will then get the FTP-prompt (>). Once you see the FTP-prompt, continue by
entering the commands below:

> quote site namefmt 1
> lcd C:\MyDirectory
> cd MyLibrary.lib
> binary
> put FNDMBRSF.FILE FNDMBRSF.SAVF
> bye

Next go to the AS400. If everything went well up to this stage, there will be a 
new save-file in the library you indicated in the FTP-transfer (the 'MyLibrary'
parameter). The name of the save-file is FNDMBRSF. To verify that, enter the
following command on an AS400 command-line:

DSPSAVF FILE(MYLIBRARY/FNDMBRSF)

You should get a display of the contents of the save-file. Note: If you don't,
then don't continue from this point, but go back and fix the error. Most likely,
your FTP-transfer didn't run normally. Important is that you use 'Binary' and
the '.SAVF' extension, as indicated.

Also note: If your shop uses another product, not FTP, to upload files from
a PC to an AS400, you can of course use this product, but again, you must make
sure the file is uploaded as a save-file.

When the save-file is uploaded correctly, you are ready to install the product 
on the AS400. First, restore all objects using the standard AS400 commands. Enter
this command on an AS400 command-line:

RSTLIB SAVLIB(FNDMBR) DEV(*SAVF) SAVF(MYLIBRARY/FNDMBRSF) RSTLIB(MYLIBRARY)

Again, please substitute MYLIBRARY with the name of the actual library you use.

Make sure the system restores all 19 objects contained in the save-file before
you continue.

Finally, run the install-program. Add the library you restored the objects into
to your library list (MYLIBRARY). Then enter this command on an AS400 command-line:

CALL PGM(FNDMBRINS) PARM(MYLIBRARY MYNEWLIBRARY)

You must supply 2 library-names as parameters to this program. The first one tells 
the program where to find the restored objects. The second one tells it where to
install the utility. Again, please substitute the names according to your environment.
Note that both library-names can be the same.

That's it. You're ready to roll !


RUN IT
------
To run it type FNDMBR on a command-line and hit F4. The menu below will show:


================================================================================
                        Find member across files (FNDMBR)                       
                                                                                
 Type choices, press Enter.                                                     
                                                                                
 Member Name  . . . . . . . . . . > *ALL          Name, generic*, *ALL          
 Look in Files  . . . . . . . . . > *ALL          Name, generic*, *ALL          
 Look in Libraries  . . . . . . . > PRDENV        Name, *LIBL, *USRLIBL...      
 Member Source     Type . . . . . > CL            BND, C, CBL, CBLLE, CL...     
                + for more values > CLLE                                        
 Sort-Sequence  . . . . . . . . .   2             1=Lib/File/Mbr:2=Mbr/File/Lib 
 Output . . . . . . . . . . . . .   *DSP          *DSP, *PRT                    
 Submit . . . . . . . . . . . . .   *NO           *YES, *NO                     
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
 F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    
 F24=More keys                                                                  
================================================================================                                                                                

Enter any combination of members and files you want to scan. Generic names are supported.
For instance, searching for members XYZ$* in QRPGSRC in *ALLUSR will retrieve all RPG-
programs that start with XYZ$ and are in a file named QRPGSRC across the entire system
(*ALLUSR works like it does on standard AS400 commands).

After you hit ENTER, the files and members will be scanned for according to your selection
and presented on the screen if output = *DSP. From there, you can perform most normal SEU-
functions. 

If output = *PRT is selected, all files and members according to your selection will be
printed.
                                          

STATUS
------
The version you downloaded is a fully functional product. As shareware, it will
come up with a 'nag'-screen every time you start it, but will function at full
capacity. If you decide to use it for inhouse or commercial development, version-
control or maintenance, please register it. See below for details.


REGISTERED VERSION
------------------
The registered version of FNDMBR costs US$ 59. You can register it anytime by
going to our website. Please have a valid credit-card at hand.

To register FNDMBR, point your browser to:

	http://www.famtech.ca/noframes/fndmbr-summ.html

and follow the registration link. Upon successful registration, we will e-mail 
you the serial number and the registration name (which you provide when you order
the product). You should enter these details into the utility. Use F22 to do that 
when it is active. The program will validate the number/name combination based on 
an algorhytm and inform you if it is correct or not.

Advantages of registration: You sleep better at night, because you have been
honest :-) -- seriously: Your queries and requests for support will be treated
with highest priority. You will be entitled for free upgrades of the product.


CONTACT
-------
FNDMBR was developed by

	Famtech Information Services Ltd.
	95 Bob O'Link Avenue
	Concord, Ontario, L4K1H1
	Canada

	Tel. (001)-416-801-3136
	Fax  (001)-905-761-1565
	http://www.famtech.ca

Please contact us at support@famtech.ca if you have questions regarding this
product. We will provide the kind of support that is common for shareware-
products. We will respond to your e-mails and do our best to find a working
solution to your question or problem. But we cannot guarantee a fixed response-
time or ensure you that we have a solution for any problem (including bugs)
that you may report.



(c,1999,2001) Famtech Information Services Ltd.