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
-------
schedule - Introductory Notes C++ API program that schedules an appointment 
if the requested time slot is available.


ENVIRONMENTS
------------
Sample makefiles are provided for the following environments:
   
  32-bit Windows
  IBM AIX
  IBM i5/OS
  Sun Solaris SPARC
  Linux on Intel platforms


FILES
-----
schedule.cpp - 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_schedule_i.clp    - Make file (CL Program) for IBM i5/OS using ILE C++ 
                   with the source code being an IFS file.
    
mk_schedule_p.clp    - Make file (CL Program) for IBM i5/OS using ILE C++ 
                   with the source code being in a source physical file.     


RUNNING schedule
----------------
This sample program will run against any Notes mail database.

To run it, type 'schedule' at the system command prompt, the Notes pathname
of the desired calendar, the name of the calendar owner, the start and end 
dates for the appointment, and the name of the server the 
calendar resides on ("" for the local machine), and then press <Enter>.

A sample command line for schedule is:

schedule jdoe.nsf "Jane Doe" "07/08/98 9:00am" "07/08/98 10:00am" "Saturn"

Note: The date syntax is mm/dd/yy.  Also this sample could take a minute or
more to run if you have a large number of entries in your calendar.

The program should display:

	The description that was set was: My appointment
	The date that was set was: <your date>

- Under i5/OS:  Execute "RUNDOMCMD/RUNDOMCMD  SERVER(<server>)
		                  CMD(CALL PGM(qntcppsdk/schedule)
	                                PARM(<database> <user> <begin time> 
		                            <end time>)) BATCH(*NO)"


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

      Use Notes to open the calendar you specified.

      In the calendar view, go to the date you specified and check to see 
      that your appointment is set.