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 1998, 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
-------
fdesign - Notes C++ API sample program to manipulate the design
          elements of a form.


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
-----
fdesign.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.

fdesign.ntf  - Sample Notes template database (in notedata directory).

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

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


RUNNING fdesign
----------------
This sample program is designed to work with the sample template database 
fdesign.ntf, in the notescpp\notedata directory.  This database should
be copied to your Notes data directory.

Note: unlike most of the other samples, fdesign works with the database
template, which means that if you enter the database name on the command 
line it should be specified with the extension ntf:
	
	fdesign.ntf

otherwise the extension defaults to nsf.

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

For example, the sample database fdesign.ntf may be copied to the
user's Notes data directory.  The command line for fdesign is:

	fdesign 

The program will create a copy of a master form stored in fdesign.ntf, 
add design elements to this copy, and modify properties of the
existing ones.

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


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

	Use Notes to open fdesign.ntf.

	Open two forms: "Master Form with Fields and a Subform",
			"Created Form with Fields and a Subform".

	Compare their content.

Note that you can only examine the forms in fdesign.ntf on platforms that
support Domino Designer. The Domino administration client on server-
only platforms cannot be used to examine forms in a database. You can,
however, run the sample program on any of the platforms listed in the
ENVIRONMENTS section, above.