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
-------
itemsamp - Introductory Notes C++ API program that displays the name and
size of all the items in all the documents in a Notes database.


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
-----
itemsamp.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 platforms.

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

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


RUNNING itemsamp
---------------
This sample program will run against any Notes database. You must
supply command-line parameters to specify the file pathname and,
optionally, server for the database.

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

For example, the sample database richtext.nsf may be copied to the
your Notes data directory.  The command line for itemsamp is:

	itemsamp richtext

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

The program should display:

Document Number = 0

Item Number = 0   
Name = Form   
Size = 14

Item Number = 1   
Name = $Fonts   
Size = 110

Item Number = 2   
Name = time_date   
Size = 10

Item Number = 3   
Name = rich_text   
Size = 420

Item Number = 4   
Name = $Revisions   
Size = 22


Document Number = 1

Item Number = 0   
Name = Form   
Size = 14

Item Number = 1   
Name = $Fonts   
Size = 76

Item Number = 2   
Name = time_date   
Size = 10

Item Number = 3   
Name = rich_text   
Size = 346

Item Number = 4   
Name = $UpdatedBy   
Size = 36

All Done. Hit return to exit: