readme.txt

IBM Lotus C++ API 7.0a for IBM Lotus Notes/Domino Directory Release --------- ------------------

Licensed Materials - Property of IBM
C99VCEN
C99VDEN
C87CFNA

(c) Copyright IBM Corporation 1996, 2007
All rights reserved.
IBM, Lotus, Lotus Notes, Notes, and Domino are trademarks or registered
trademarks of Lotus Development Corporation and/or IBM Corporation
in the United States, or other countries, or both.


PROGRAM
-------
copydb - Introductory Notes C++ API program that opens a Notes database,
copies its contents to a new destination database, and sets the new
database title.  The destination database can be either a replica or
non-replica copy.


ENVIRONMENTS
------------
Sample makefiles are provided for the following environments:

  32-bit Windows
  IBM i5/OS
  IBM AIX
  Sun Solaris SPARC
  Linux on Intel platforms


FILES
-----
copydb.cpp   - Main program.

copydb.hpp   - Include file for main program.

mswin32.mak  - Make file for 32-bit Windows using Microsoft Visual 
               C++.

sol_2x.mak   - Make file for SUN Solaris SPARC platform.

aix.mak      - Make file for IBM AIX.

linux.mak    - Make file for Linux on Intel platform.

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

mk_copydb_i.clp    - Make file (CL Program) for IBM i5/OS using ILE C++ 
                   with the source code being an IFS file.
    
mk_copydb_p.clp    - Make file (CL Program) for IBM i5/OS using ILE C++ 
                   with the source code being in a source physical file.     


RUNNING copydb
--------------
This sample program runs against any Notes database.  The user is prompted 
for the source and destination .nsf file path and server names, the
destination database title, and whether to create a replica or non-replica
copy.

To run this program, type 'copydb' at the system command prompt.

- Under i5/OS: Execute "RUNDOMCMD/RUNDOMCMD  SERVER(<server>)
	                               CMD(CALL PGM(qntcppsdk/copydb)) BATCH(*NO)"


EXAMINING THE NOTES DATABASE TO CHECK THE RESULT
------------------------------------------------
To see if copydb worked correctly:

Use Notes to open the .nsf file you just created.

Compare the copy to the original. The new database should have
the same design and documents as in the original.