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 1998, 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
-------
HOTSPOT - Notes C++ API sample program that creates and manipulates
different kinds of hotspots.


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

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


FILES
-----
hotspot.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.

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

sampledb.nsf - Sample Notes database (in notedata directory).

script.txt   - Sample text file (in notedata directory).

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


RUNNING HOTSPOT
----------------
This sample program is designed to work with the sample database
sampledb.nsf and the sample "script.txt" file, provided in the
notescpp\notedata directory.  Copy these files to your Notes data 
directory. You must supply command line parameters to specify the
file pathname and, optionally, the server for the database.

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

For example, assuming sampledb.nsf and script.txt have been copied to your
Notes data directory, the command line for hotspot is:

      hotspot sampledb

- Under i5/OS:  Execute "RUNDOMCMD/RUNDOMCMD  SERVER(<server>)
	                                CMD(CALL PGM(qntcppsdk/hotspot)
            	                                PARM(sampledb.nsf <server>))  BATCH(*NO)"


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

      Use Notes to open sampledb.nsf.

      Open the doc with subject 'Hotspot Sample Document'.  The 
      document should contain 3 action hotspots, 3 buttons, and 3 popups,
	  each of which should perform a specific action when activated.