home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / vrac / matchit6.zip / IMP_MTCH.DOC < prev    next >
Text File  |  1994-02-19  |  5KB  |  96 lines
  1. IMP_MTCH.EXE - Soundex Match Door Datafile Importer for "The MatchIt Door"
  2. (C) Copyright 1993,1994 by Mark McKay,
  3. The Skeleton Closet BBS (Mark & Debbi McKay sysops),
  4. Fidonet 1:275/138,139,140
  5. (804-671-8547,804-499-5150,804-473-2217)
  6.  
  7. ┌─────────────────────────────────────────────────────────────────────────────┐
  8. │▓▓▓▓▓ Disclaimer/Legal Stuff ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  9. └─────────────────────────────────────────────────────────────────────────────┘
  10.  
  11.   Although this program has been tested, this software has no warranty,
  12.   either expressed or implied.  The use of this software is at the user's own
  13.   risk.  Mark McKay shall in no way be responsible for any special, incidental,
  14.   consequential or other damages resulting from the use and/or misuse of this
  15.   software.  Every effort has been made to test this software and its
  16.   documentation for possible errors, but no guarantee to that effect is made.
  17.   There are no written or implied guarantees of updates to this program.
  18.  
  19.   This program must be distributed AS IS in it's original archive.  This
  20.   program may not be distributed as part of any other software package without
  21.   the expressed written consent of the author, Mark McKay.  It may not be
  22.   altered or reverse engineered in any way, shape or manner.
  23.  
  24.   The usual I don't promise it will do anything and if it messes up/you mess
  25.   it up, you own the pieces.  If you use it, you alone are liable for the
  26.   results.
  27.  
  28.   There are no promises either expressed or implied of updates to this
  29.   program.
  30.  
  31. ┌─────────────────────────────────────────────────────────────────────────────┐
  32. │▓▓▓▓▓ Quick Notes ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  33. └─────────────────────────────────────────────────────────────────────────────┘
  34.  
  35. This file is a utility for registered users of "The Matchit Door" only.
  36.  
  37. Matchit is a Soundex based Genealogy door to allow users to enter up to 10
  38. ancestor names (with location and time frame) to be added to a database all
  39. users of the door can access to look for common ancestors you are searching
  40. for.
  41.  
  42. To use IMP_MTCH.EXE you need someone else to do the following:
  43.  
  44.  1. Copy their MATCHIT.DAT file to another directory.
  45.  2. Rename the copy of MATCHIT.DAT to MATCHIT.IMP.
  46.  3. Archive the MATCHIT.IMP file into a file with a filename specific
  47.     to the user.
  48.  
  49. Once you get someone elses MATCHIT.IMP file in an archive do the following:
  50.  
  51.  1. Unarchive the file into your MATCHIT directory.
  52.  2. Run IMP_MTCH.EXE.
  53.  3. That's it.
  54.  
  55. What IMP_MTCH.EXE does:
  56.  
  57.  1. It checks the amount of memory you have free.
  58.  
  59.  2. Then checks for a MATCHIT.IMP file in the MATCHIT directory.
  60.     If one isn't found, then the program exits doing nothing.
  61.  
  62.  3. Then checks the number of records in your MATCHIT.DAT and in the
  63.     MATCHIT.IMP.  If both combined are larger than the size limit
  64.     of the MATCHIT.DAT file, 5000 records, then the program exits
  65.     doing nothing.
  66.  
  67.  4. Then checks to make sure you have enough memory to make the duplicate
  68.     record in memory.  If you don't have enough memory, the program
  69.     exits doing nothing.
  70.  
  71.  5. Once it's sure it has enough memory to work and won't add too many
  72.     records it creates a duplicate database in memory from your
  73.     MATCHIT.DAT file.  Only the person's name and where they are from
  74.     are stored in memory to allow for more records to be imported.
  75.     The downside of this is if you have 2 people with the same name from
  76.     the same place, the record will not be added to your Database.
  77.     The work around is to have your users edit there record in MATCHIT
  78.     itself and include a middle initial.  This way the records will be
  79.     different and can be added to other databases.
  80.  
  81.  6. Once the duplicate database is in memory, IMP_MTCH reads the
  82.     MATCHIT.IMP file record by record.  If the record is not in your
  83.     MATCHIT.DAT, it is added to the end of the file and IMP_MTCH will
  84.     show you the user name it added and where they are from.  All files
  85.     imported will be set to "NOT ON THE BBS" so people don't try sending
  86.     messages to someone that isn't on your BBS.
  87.  
  88.  7. Once the MATCHIT.IMP is imported, IMP_MTCH will inform you as to
  89.     how many duplicates were ignored and how many records were added.
  90.  
  91.  8. Finally the MATCHIT.IMP file is deleted.
  92.  
  93. IMP_MTCH is easy to use.  It requires zero configuration files and accepts
  94. no commandline parameters.  All you need to do is run it.  It requires no
  95. operator action what-so-ever.  Just sit and watch.
  96.