(c) 1996 Lotus Development Corporation.  All rights reserved.
This software is subject to the Lotus Notes C++ API Software Development
Kit Agreement (in the apilicns.txt file in the notescpp directory of
this toolkit), Restricted Rights for U.S. government users, and
applicable export regulations.


PROGRAM
-------
search - Notes C++ API program that searches the source database for
documents created within a specified range of dates, and copies those
documents to the destination database.


ENVIRONMENTS
------------

Sample makefiles are provided for the following environments:

	Windows NT (32-bit) (including DEC Alpha)
	Windows 95 (32-bit)
	IBM VisualAge C++ for Win32
	OS/2 (32-bit)
	HP HP-UX
	SUN Solaris 2
	IBM AIX
	X86 Solaris 2

The following environments rely on the Integrated Development Environment
(IDE), and do not require makefiles:

	Windows (16-bit) using Borland C++
	MacOS (7.x) Power PC


FILES
-----
search.cpp   - Main program.

mswin32.mak  - Make file for Windows NT (32-bit) (including DEC Alpha) and 
               Windows 95 (32-bit) using Microsoft Visual C++.

search.def   - Module definition (.def) file for 16-bit Borland C++ for Windows.

ibmwin32.mak - Make file for Windows NT (32-bit) and Windows 95 (32-bit) using
               IBM VisualAge C++ for Windows.

os2_32.mak   - Make file for OS/2 (32-bit).

hp.mak       - Make file for HP-UX.               

sol_2x.mak   - Make file for SUN Solaris 2.

sol_x86.mak  - Make file for X86 Solaris 2.

aix.mak      - Make file for IBM AIX.

readme.txt   - This file. Specifies what is needed to use this example.


RUNNING search
--------------
This sample program will run against any Notes database.  On platforms
other than Macintosh, the user must supply command-line parameters to
specify the file pathnames and the start and end dates for the search.  
On the Macintosh, the user is prompted for the file pathnames and search 
start and end dates.

- Under Windows 16-bit: choose File Run from the Program Manager menu, 
  type in the full path and filename of this program, the Notes pathname
  of the desired source and destination databases, and the start and end
  dates for the search, then press <Enter>.

- Under OS/2 , Windows NT, Windows 95 and UNIX (Solaris, AIX, or HP-UX):
  type 'search' at the system command prompt, followed by the Notes 
  pathname of the desired source and destination databases, and the start 
  and end dates for the search.

- Under Macintosh: double click on the program icon.  The program will
  prompt for the database pathnames and start and end dates.

For example, the sample databases search1.nsf and search2.nsf may be 
copied to the user's Notes data directory.  The command line for search 
is:

	search search1 search2 1/1/86 1/1/96

The program will display:

	Copying notes from .\search1 to .\search2
	Number of documents found: 3


EXAMINING THE NOTES DATABASES TO CHECK THE RESULT
-------------------------------------------------

To see if search worked correctly:

	- Use Notes to open search1.nsf and search2.nsf

    - The database search2 should contain copies of those documents
	  from search1 with creation dates in the specified range.
