5
Compiling and Linking Pro*C/C++ and OCI Applications

This chapter describes Windows NT-specific issues for applications developers.

Specific topics discussed are:

• Compiling and Linking a Pro*C Program
• Compiling and Linking an OCI Program
• Compiling and Linking the Oracle XA Library

  Additional Information: For more information on compiling and linking Pro*C/C++ programs, see Oracle Pro*C/C++ Getting Started for Windows NT and Windows 95, and Programmer's Guide to the Oracle Pro*C/C++ Precompiler. For more information on compiling and linking OCI programs, see Programmer's Guide to the Oracle Call Interface.

Compiling and Linking a Pro*C Program

To compile and link a Pro*C program:

1. Precompile PROGRAM.PC using Pro*C to generate PROGRAM.C.
2. Compile PROGRAM.C, making sure to include ORACLE_HOME\RDBMS80\XA in your path.
3. Link PROGRAM.OBJ with the following libraries:

   Library	Located in...
   XA80.LIB	ORACLE_HOME\RDBMS80\XA
   ORA803.LIB	ORACLE_HOME\OCI80\LIB
   SQLLIB80.LIB	ORACLE_HOME\PRO80\LIB\MSVC
   	or
   	ORACLE_HOME\PRO80\LIB\BORLAND

4. Run PROGRAM.EXE. (XA80.LIB makes the function calls to XA80.DLL)

Compiling and Linking an OCI Program

To compile and link an OCI program:

1. Compile PROGRAM.C by using MSVC++ or Borland C, making sure to include ORACLE_HOME\RDBMS80\XA in your path.
2. Link PROGRAM.OBJ with the following libraries:

   Library	Located in...
   XA80.LIB	ORACLE_HOME\RDBMS80\XA
   ORA803.LIB	ORACLE_HOME\OCI80\LIB\MSVC
   	or
   	ORACLE_HOME\OCI80\LIB\BORLAND

3. Run PROGRAM.EXE.

See the following general information about XA and TP monitors:

• Distributed Transaction Processing: The XA Specification published by X/Open, (now part of OpenGroup). Visit: http://www.rdg.opengroup.org/public/pubs/catalog/full_lst.htm
• Transaction Processing XPG4 X/Open CAE Specification XO/CAE/91/300 or C193 2/92
• Your specific TP monitor documentation

For more information about the Oracle XA Library, see the chapter "Oracle XA" of the Oracle8 Server Application Developer's Guide.

Compiling and Linking the Oracle XA Library

The XA Application Program Interface (API) is typically used to enable an Oracle8 database to interact with a transaction processing (TP) monitor, such as:

• BEA Tuxedo
• IBM Transarc Encina
• IBM CICS

The Oracle XA Library is automatically installed as part of the Oracle8 Enterprise Edition installation option. The following components are created in your Oracle home directory:

Component	Location
XA80.DLL	ORACLE_HOME\BIN
XA80.LIB	ORACLE_HOME\RDBMS80\XA
XA.H	ORACLE_HOME\RDBMS80\XA

You can also use TP monitor statements in your client programs. The use of the XA API is also supported from both Pro*C and Oracle Call Interface (OCI). In either case, the XA80.DLL must be contained in the execution path of the calling program.

---