B
OCI Demonstration Programs

Oracle provides code examples illustrating the use of OCI calls. These programs are provided for demonstration purposes, and are not guaranteed to run on all platforms.

The demonstration programs (demos) are available with your Oracle installation. The location, names, and availability of the programs may vary on different platforms. On a UNIX workstation, the programs are installed in the ORACLE_HOME/rdbms/demo directory.

The $ORACLE_HOME/rdbms/demo directory contains not only demos but the file named Makefile that must be used as a template on how to build your own OCI applications or external procedures. Development of new Makefiles to build an OCI application or an external procedure should consist of the customizing of the Makefile provided by adding your own macros to the link line. However, Oracle requires that you keep the macros provided in the demo Makefile, as it will result in easier maintenance of your own Makefiles.

On a Windows NT machine, the programs are located in the ORACLE_HOME\Oci\Samples directory.

When a specific header or SQL file is required by the application, these files are also included. Review the information in the comments at the beginning of the demonstration programs for setups and hints on running the programs.

Table B-1, "OCI Demonstration Programs" lists the important demonstration programs and the OCI features that they illustrate.

Table B-1 OCI Demonstration Programs  

Program Name	Features Illustrated
cdemo81.c	Using basic SQL processing with release 8 and later functionality.
cdemo82.c	Performing basic processing of user-defined objects.
cdemocor.c	Using complex object retrieval (COR) to improve performance.
cdemodr1.c, cdemodr2.c, cdemodr3.c	Using INSERT/UPDATE/DELETE statements with RETURNING clause used with basic datatypes, LOBs and REFs.
cdemodsa.c	Describing information about a table.
cdemodsc.c	Describing information about an object type.
cdemofo.c	Registering and operating application failover callbacks.
cdemolb.c	Creating, accessing, and manipulating LOB objects.
cdemolb2.c	Writing and reading of CLOB/BLOB columns with stream mode and callback functions.
cdemolbs.c	Writing and reading to LOBs with the LOB buffering system.
cdemobj.c	Pinning and navigation of REF object.
cdemorid.c	Using INSERT/UPDATE/DELETE statements and fetches to get multiple rowids in one roundtrip.
cdemoses.c	Using session switching and migration.
cdemothr.c	Using the OCIThread package.
cdemosyev.c	Registering predefined subscriptions and specifying a callback function to be invoked for client notifications (for more information about Advanced Queuing, see Oracle9i Application Developer's Guide - Advanced Queuing).
cdemodp.c, cdemdplp.c	Loading data with the direct path load functions.
cdemdpco.c cdemdpno.c cdemdpin.c cdemdpit.c cdemdpro.c cdemdpss.c	Loading a column object. Loading a nested column object. Loading derived type (inheritance). Loading an object table with inheritance. Loading a reference. Loading SQLl strings.
cdemoucb.c, cdemoucb1.c	Using static and dynamic user callbacks.
cdemoupk.c, cdemoup1.c, cdemoup2.c	Using dynamic user callbacks with multiple packages.