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 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. On a Windows NT system, the programs are located in the %ORACLE_HOME%\Oci\Samples 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 Windows systems, make.bat is the analogous file 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	Create and insert LOB data and then read, write, copy, append and trim the data.
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 round-trip.
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 with the direct path load functions. Loading a nested column object with the direct path load functions. Loading derived type (inheritance) with the direct path load functions. Loading an object table with inheritance. Loading a reference with the direct path load functions. Loading SQL strings with the direct path load functions.
cdemoucb.c, cdemoucbl.c	Using static and dynamic user callbacks.
cdemoupk.c, cdemoup1.c, cdemoup2.c	Using dynamic user callbacks with multiple packages.
cdemodt.c	Datetime and interval example.
cdemosc.c	Scrollable cursor.
cdemol2l.c	Accesses LOBs using the LONG API.
cdemoin1.c	Inheritance demo which modifies an inherited type in a table and displays a record from the table.
cdemoin2.c	Inheritance demo to do attribute substitutability.
cdemoin3.c	Inheritance demo that describes an object, inherited types, object tables, and a sub-table.
cdemoanydata1.c	Anydata demo. Inserts and selects rows to and from anydata table.
cdemoanydata2.c	Anydata demo. Creates a type piecewise using OCITypeBeginCreate() and then describes the new type created.
cdemosp.c	Session pooling.
cdemocp.c	Connection pooling.
cdemopproxy.c	Connection pooling with proxy functionality.
cdemostc.c	Statement caching.