
                          Ŀ       Ŀ
                                 T H E       
                                Ŀ       
                                            
                                               
                              M I G R A T E    
                                               
                                Ŀ Ŀ      
                                Ŀ  
                             L I B R A R Y   
                                         



Thank You for taking the time to download this Function Library for use with
Nantucket's Clipper '87 Compiler.  We believe that you'll enjoy the use of it
and will feel comfortable enough with it to pass it along to a friend or
another member of the Clipper Community.


INTRODUCTION.

Working with data can really be easy if you have the right tools.  I used to
spend a significant amount of time converting and manipulating raw data while
working in the Financial Services Industry.  I needed the right tools but none
were available that would link into my applications.  I was forced to use
products like CrossFile which have restrictive licence agreements, or spend
hours working with dBASE or FOXplus.  I therefore developed my own functions
to handle what was and still currently is restricted in use and must be invoked
from DOS or Shelled-out to, from my applications, via Gambit's Overlay().
I am pleased to have you share in this development, and would appreciate any
comments or anomolies you experience with these functions.  The Library is
incomplete and merely a sample of the complete Function Library!  We encourage
you to order the complete Library and the source code for only $10.00 (U.S).


THE LIBRARY.

The functions are:  ASC2DBF() and DBF2ASC().  The first function is complex;
the second, a slam-dunk!


1.  This function accepts a comma delimited ASCII file as input and returns
    true if it successfully converts the input file into a dBASE III+ format
    file.  The function makes two passes thru the data; the first to build the
    structure for the database file, the second to actually convert the data.


    ASC2DBF( <source> , <target> [,<show>] )


                 Data
     Parameter   Type        Sample          Description
                
       source:    C      "{filename.ext}"    dBASE File.
       target:    C      "{filename.ext}"    ASCII File.
         show:    L       .T.  (default)     Standard Output.





2.  This function is very straightforward, what it does is simply accept a
    dBASE III+ as input and convert the data to a comma delimited ASCII file
    format.  This function takes about 1/4th the time to convert to ASCII as
    the previous function takes to convert from ASCII -- this is because the
    previous function depends heavily on Clipper's Extend system and File I/O.


    DBF2ASC( <source> , <target> )


                 Data
     Parameter   Type        Sample          Description
                
       source:    C      "{filename.ext}"    ASCII File.
       target:    C      "{filename.ext}"    dBASE File.



HOW TO LINK.


The MIGRATE Library is 100% Clipper Code and requires only the CLIPPER.LIB and
the EXTEND.LIB.  It can be Dynamically Overlaid using BLINKER or RTLink.

To Link simply type;

  BLINKER FILE <your.prg> LIBRARY MIGRATE,CLIPPER,EXTEND



THE LICENCE.

We, LH Software, are giving to you (a member of the Clipper Community), and all
other interested parties, unlimited use of this library and functions, except
for the sole purpose of resale, which will remain a reserved right of
LH Software.  As well, LH Software still holds the copyrights to this library,
functions, and the source code used to create it.


ALSO AVAILABLE.

The Complete Library and Source Code is also available for the Clipper 5.0
Compiler for the same low cost of $10.00 (in U.S. Currency).


HOW TO ORDER.

To order:
Make check or money order payable to:

LH Software.
520 Wedgewood Lane
La Habra, CA 90631


Thanks Again!
