
                          NAME CLEAN
                   Version 1.2b  Jan 29, 1994
            Copywrite (C) 1992, 1993  Jack Chandler

Version 1.2b modifies code structure to prevent problems
when using on database in which name case changes have
been made with PAF2.2 or PAF2.3.  When the case of a name
is changed the new entry is not formatted properly when written
back to the NAME2.DAT file.

This improper format has no effect on the proper operation
of FR.EXE and other utilities included in the PAF packet.
It is not compatible with NAMCLN12.

If NAMCLN12 or NAMCL12A is used on this database, it will
display a _deletion_ of -n records where the n will represent
the number of times the changed name occurred in the data
base.  This will be for each name changed.  The -n indicates
an _addition_ of names to the NAME2.DAT file.

Running NAMCLN12 or NAMCL12A a second timed will remove the
names added by the first pass.

NAMCL12B corrects the improper format of the entry and enters
no extraneous name.  If FR2.3 is later modified to correct this
bug, then NAMCL12B will still function properly.

The original NAMCLEN1 will handle the improper format satisfactorily
but does not correct the format in the NAME2.DAT file.

Version 1.2 corrects potential problem on handling large
databases with NAME2.DAT record numbers greater than 32767.

NAMCLEAN is a PAF utility to remove unused names from you
PAF NAME2.DAT file.

NAMCLEAN is extremely easy to use and requires only normal
precautions to protect your files from damage during the
process.  A good current backup should always be made prior
to modification by any software that changes or writes to your
database.

The files that require backups are NAME2.DAT, INDIV2.DAT, and
MARR2.DAT.  The other files in your database are not effected.

NAMCLEAN can be ran from any location.  Processing speed will
be enhanced if the three files NAME2.DAT, INDIV2.DAT, and
MARR2.DAT are in a ram-drive or on your hard drive.  File access
will greatly increase processing time if those files are on a
floppy disk.

There must be sufficient space left in the location of your data
files to create a .TMP file the size of your NAME2.DAT file.
This .TMP file is erased upon termination of the program.

Run FRCHK on your original files prior to running NAMCLEAN.  If
FRCHK reports problems, then attempt to correct them prior to
running NAMCLEAN.  If you have the 10 June 1990 or later update
to PAF 2.2, you can run FRCHK -f.  This will repair most minor
problems.  The results of NAMCLEAN are unpredictable if your
data fails the FRCHK.

Be sure that you enter the correct location of your data files
and that you use ^P to answer the prompt after the caution
warning.

Processing time for NAMCLEAN is much faster than using GEDCOM
procedures to clean up the NAME2.DAT file.  NAMCLEAN used in
conjunction with RECLAM14 will process my database of 5400
INDIV2.DAT, 2113 MARR2.DAT, and 3600 NAME2.DAT records in about
50 minutes on my 8mhz machine.  GEDCOM takes over 3 1/2
hours to complete this same function.

Processing time is dependent upon the number of name field
entries in your INDIV2.DAT and MARR2.DAT files.  INDIV2.DAT has
24 name fields.  MARR2.DAT has 5 name fields.  This means that
NAMCLEAN accesses, checks, and modifies if necessary 139,253
name pointers in those two files.  It also accesses, cross checks
for duplicity, and writes 3600 names to a new NAME2.DAT file.

NAMCLEAN does not modify any RIN or MRIN numbers.

                      *** NOTE ***

NAMCLEAN modifies your PAF data.  Be sure you have a current
backup before running NAMCLEAN.
                      ************

No registration of NAMCLEAN is required but a small donation of
up to $5.00 would be appreciated if you find this utility of use
to you.

Send donations, comments, and questions to:

                   Jack Chandler
                   812 Vermillion Dr.
                   Henderson, NV  89015

Or contact on GEnie address J.CHANDLER2, or on Fidonet NGC echo.

