readme.txt.contrib

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

Licensed Materials - Property of IBM
C87CDNA
C87CENA
C87CFNA

(c) Copyright IBM Corporation 1996, 2006
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
-------
addfoldr - Notes C++ API sample program that creates new folders and 
copies documents into the new folders, based on the document subject.


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

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


FILES
-----
addfoldr.cpp - Main program.

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

sol_2x.mak   - Make file for Sun Solaris SPARC Edition.

aix.mak      - Make file for IBM AIX.

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

view.nsf     - Sample Notes database (in notedata directory).
		
readme.txt   - This file.  Specifies what is needed to use this example.

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


BEFORE RUNNING addfoldr
-----------------------
This sample program is designed to work with the sample database 
view.nsf, in the notescpp\notedata directory.  Copy this database to your 
Notes data directory.

addfoldr creates a folder for each quarter of the year (1stQuarter, 2ndQuarter,
and so on), and places documents in those folders based on the month specified
in the document's subject. Before running addfoldr, use Notes to open
view.nsf. Verify that the folders for each quarter do not exist, and then
close the database.


RUNNING addfoldr
----------------
To run this program, type 'addfoldr' at the system command prompt,
followed by the Notes pathname of the database, and (optionally) the name
of the server.

For example, assuming view.nsf has been copied to your Notes data directory,
the command line for addfoldr is:

        addfoldr view

- Under i5/OS:  Execute "RUNDOMCMD/RUNDOMCMD  SERVER(<server>)
		                   CMD(call PGM(qntcppsdk/addfoldr)
		                   PARM(view.nsf))  BATCH(*no)"


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

      1. Re-open view.nsf.
      2. Verify that the new folders exist and that they contain the correct
         documents.