This file was last updated
17 January 2003
Thank you for choosing Oracle's Calendar API (CAPI). This readme contains all installation information. Please see the Release Notes for a list of included features and a description of known problems.
CAPI gives access to the calendar server database through a series of C function calls. Use these functions to create your own clients and develop your own applications. This release of CAPI contains functionality to fetch, store, and delete calendar events.
Note: calendar events must be in iCalendar format, wrapped in MIME. Please refer to RFC 2445 for a description of this format.
This package contains the folowing:
To work with CAPI, simply extract and copy the files from the CAPI package to a working folder on your computer. If you are installing one of the patches, just copy the new files over your existing files.
CAPI is a shared library, libcapi.so for UNIX, capi.dll for Microsoft Windows NT and capi for Macintosh. This library must be accessible to the system. Additionally, this version of CAPI requires the standard Oracle shared calendar libraries in the capi/lib directory. These files are included in this package and should be accessible by your CAPI applications both at compile time and at run time.
UNIX
Under UNIX, set the runtime library path to include the directory which contains the libraries. For example, if CAPI (libcapi.so) is installed in the subdirectory 'pkg/capi' of your home directory, the following command should do this:
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH":"$HOME"/pkg/capi/lib"setenv SHLIB_PATH $SHLIB_PATH":"$HOME"/pkg/capi/lib"setenv LIBPATH $LIBPATH":"$HOME"/pkg/capi/lib"NT
Under Microsoft Windows NT the directory containing capi.dll should be included in your path variable. Either copy the dll to a directory in the path, for example, the Windows system directory, or add the directory containing capi.dll to the path by selecting Start Menu | Settings | Control Panel | System and modifying the PATH variable in the Environment tab.
The Oracle standard shared calendar libraries, the CAPI shared library capi, and any ACE plugins you wish to use must either be in the same folder as your application or in the Extensions Folder. Other Oracle Calendar products may install shared libraries in a folder in your Extensions Folder, so we suggest following the same convention.
If you use other Oracle Calendar products you may already have copies of the Oracle standard shared calendar libraries installed. Be sure not to overwrite newer versions of these libraries with older ones.
To uninstall CAPI delete the shared library, and if necessary remove the directory which was added to the environment variable.
Copyright © 1998, 2003, Oracle Corporation. All rights reserved.