readme.unx

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

Licensed Materials - Property of IBM
C99VDEN

(c) Copyright IBM Corporation 1996, 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.


*********************************************************************

         IBM Lotus C++ API 7.0a for IBM Lotus Notes/Domino

                 Platform-Specific Information and
                   Installation Instructions for
                     AIX, Solaris, and Linux

*********************************************************************

This is the Release 7.0a build of the IBM Lotus C++ API
(Application Program Interface) Software Development Kit. This 
release of the Lotus C++ API Toolkit supports development of 
programs for Notes Release 7.0.


Platform Information:
---------------------
IBM AIX

The Lotus C++ API Toolkit supports building applications on IBM AIX 
5.2 ML2 or IBM AIX 5.3, using IBM AIX VisualAge 6+ (XlC) compiler 
with Oct 2003 PTF.
                  
Sun SPARC Solaris

The Lotus C++ API Toolkit supports building applications on Sun
Solaris SPARC 9, using SunOne Studio 8 Compiler.

Note:  Solaris 9 is a 64-bit operating system which supports a 
complete 32-bit and 64-bit application and development environment.
Domino 7.0 is a 32-bit application supported to run under Solaris 9
booted in a 64-bit environment; therefore Lotus C++ API applications
must also be 32-bit applications. Running 32-bit Domino applications
created using the Lotus C++ API for Domino and Notes is supported 
when the Solaris operating system is booted in 64-bit mode only.

Linux

The Lotus C++ API Toolkit supports building applications on United 
Linux 1.0 SP3, using the GNU Compiler Collection (gcc) version 
3.2.2.
        
Other Platforms

The Lotus C++ API Toolkit also supports developing programs for
Microsoft Windows. For information on this configuration and
installation information, please see the file readme.pc in the PC
version of the Lotus C++ API Toolkit.


Installation
------------

Installation of the Toolkit requires approximately 65 megabytes of 
disk space.

Both the Lotus C++ API Toolkit and the Lotus C API Toolkit
may be installed on the same system.  Please note that the C++ 
API Toolkit includes specific versions of some of the components of 
the C API Toolkit.  Environment variables for include files and link 
libraries must be set specifically for either the C or C++ API 
Toolkit, as described in the Lotus C++ API Release 7.0 Guide in the 
appropriate section of the "Installing the Toolkit and Building 
Applications" chapter under the heading "About environment settings,"
to ensure that the correct versions of the headers and libraries are 
used.

C++ API documentation and sample program makefiles assume the Lotus 
C++ API toolkit on UNIX resides in the directory /opt/lotus/notescpp.

If you have previously installed Lotus Domino for UNIX, the directory 
/opt/lotus will already exist.  This directory may be a symbolic link.

If you install the Lotus C++ API toolkit in a directory other than 
/opt/lotus/notescpp, you must create a symbolic link, 
/opt/lotus/notescpp, that points to the target directory where the 
toolkit physically resides.
 
The following instructions assume you are installing into the 
directory /usr/lpp/lotus from a downloaded tar file and that you have
sufficient disk space for the toolkit.

The Lotus C++ Toolkit for Domino and Notes is available from
www.ibm.com/developerworks/lotus.  Click Downloads and then click 
Toolkits and Drivers under Downloads and CDs.  There are separate 
links for the toolkit and documentation files. 

Follow these steps:

1. If the directory /opt/lotus does not exist, create it.  You must 
   be logged in as root to copy the toolkit and set permissions:

        #  mkdir /opt/lotus

2. Create the directory /opt/lotus/notescpp:

        #  mkdir /opt/lotus/notescpp

3. Select the links on the Web page to download each file, and specify 
   your install directory when prompted.
 
4. Extract the toolkit files from the downloaded tar file into the 
   notescpp directory, setting read permission on the toolkit files. 
   Make sure you specify the option that will preserve the directory 
   structure when expanding the toolkit:

        #  cd /opt/lotus/notescpp
        #  umask 222
        #  uncompress -xvf lncpp70.tar.Z
        #  tar -xvf lncpp70.tar

5. Change the ownership of all files in the notescpp to user "notes" 
   in group "notes":

        #  cd  /opt/lotus/notescpp
        #  chown  -R  notes  .
        #  chgrp  -R  notes  .

   NOTE:  This creates a read-only copy of the Lotus C++ API Toolkit 
   files.  In order to build the sample programs, you should create a 
   private copy of the directory /usr/lpp/lotus/notescpp/samples, and 
   ensure that you are the owner and that you have write access to 
   those directories.

6. Move or copy the C++ API documentation database from the directory
   notescpp/doc to your Notes server's data directory or ftp it to the
   Notes data directory on your workstation. The database title is 
   Lotus C++ API Release 7.0 Guide (lncpp70.nsf).  

7. Move or copy the sample Notes databases from the C++ API notedata 
   directory to your local Notes data directory. Although this step is 
   optional, it is recommended because many C++ API sample 
   programs assume their target Notes database resides in the local 
   Notes data directory.

8. On a Notes client machine, start the Notes workstation software.

9. In Notes, add the icon for the C++ API documentation database to 
   your desktop:

        Lotus C++ API Release 7.0 Guide     (lncpp70.nsf)

   You can either copy this database to the Notes data directory
   on the UNIX machine and access it remotely from your Notes client,
   or FTP the database to your Notes client machine, since Notes
   databases are binary-compatible across platforms.

10. In Notes, open the Lotus C++ API Release 7.0 Guide database, and
   refer to the "User's Guide". It contains all further instructions.

   It is strongly recommended that you read the following chapters 
   before attempting to build and run any sample C++ API 
   programs:

       Release Notes
       Chapter 1: Introduction
       Chapter 3: Creating and Running C++ API Programs