Table of Contents

Introducing TxRPC

What Is TxRPC?

Using the Interface Definition Language (IDL)

References

Using uuidgen to Create an IDL Template

Changes in the Language

Changes Based on the TxRPC Specification

Enhancements to the Language

Enhancements that May Limit Portability

Unsupported Features

Using tidl, the IDL Compiler

Writing RPC Client and Server Programs

Handling Remoteness

Handling Status and Exception Returns

Using Stub Support Functions

Using RPC Header Files

Portability of Code

Interacting with ATMI

Interacting with TX

Building RPC Client and Server Programs

Prerequisite Knowledge

Building an RPC Server

Building an RPC Client

Building a Windows Workstation RPC Client

Using C++

Interoperating with DCE/RPC

Oracle Tuxedo Requester to DCE Service via Oracle Tuxedo Gateway

Setting the DCE Login Context

Using DCE Binding Handles

Authenticated RPC

Transactions

DCE Requester to Oracle Tuxedo Service Using Oracle Tuxedo Gateway

Oracle Tuxedo Requester to DCE Service Using DCE-only

DCE Requester to Oracle Tuxedo Service Using Oracle Tuxedo-only

Building Mixed DCE/RPC and Oracle Tuxedo TxRPC Clients and Servers

Running the Application

Prerequisite Knowledge

Configuring the Application

Booting and Shutting Down the Application

Administering the Application

Using Dynamic Service Advertisement

A Sample Application

Appendix Contents

Prerequisites

Building the rpcsimp Application

Step 1: Create an Application Directory

Step 2: Set Environment Variables

Step 3: Copy files

Step 4: List the Files

IDL Input File—simp.idl

Listing A-1 simp.idl

The Client Source Code—client.c

Listing A-2 client.c

The Server Source Code—server.c

Listing A-3 server.c

Makefile—rpcsimp.mk

Listing A-4 rpcsimp.mk

The Configuration File—ubbconfig

Listing A-5 ubbconfig

Step 5: Modify the Configuration

Step 6: Build the Application

Step 7: Load the Configuration

Step 8: Boot the Configuration

Step 9: Run the Client

Step 10: Monitor the RPC Server

Listing A-6 tmadmin psr and psc Output

Step 11: Shut Down the Configuration

Step 12: Clean Up the Created Files

A DCE-Gateway Application

Appendix Contents

Prerequisites

What Is the DCE-Gateway Application?

Installing, Configuring, and Running the rpcsimp Application

Step 1: Create an Application Directory

Step 2: Set Your Environment

Step 3: Copy the Files

Step 4: List the Files

IDL ACF File—simpdce.acf

Listing B-1 simpdce.acf

Binding Function—dcebind.c

Entry Point Vector—dceepv.c

Listing B-2 dceepv.c

DCE Manager—dcemgr.c

Listing B-3 dcemgr.c

DCE Server - dceserver.c

Makefile—rpcsimp.mk

Listing B-4 rpcsimp.mk

Step 5: Modify the Configuration

Step 6: Build the Application

Step 7: Load the Configuration

Step 8: Configuring DCE

Listing B-5 DCE Configuration

Step 9: Boot the Configuration

Step 10: Run the Client

Step 11: Shut Down the Configuration

Step 12: Clean Up the Created Files