Contents

Title Page

Copyright Page

1. Introduction and Overview

General Description of TxRPC

2. The Interface Definition Language

uuidgen - Creating an IDL Template

Changes in the Language

Changes Based on the TxRPC Specification

Enhancements to the Language

Enhancements that May Limit Portability

Features that Are Not Supported

tidl - The IDL Compiler

3. Writing RPC Client and Server Programs

Introduction

Prerequisite Knowledge

Handling Remoteness

Handling Status and Exception Returns

The Stub Support Functions

RPC Header Files

Portability of Code

Interactions with ATMI

Interactions with TX

4. Building RPC Client and Server Programs

Introduction

Prerequisite Knowledge

Building an RPC Server

Building an RPC Client

Building a DOS Workstation RPC Client

Building a Windows Workstation RPC Client

Building an OS/2 Workstation RPC Client

Interoperability with DCE/RPC

: BEA TUXEDO Requester to DCE Service via BEA TUXEDO
Gateway
: DCE Requester to BEA TUXEDO Service Using BEA TUXEDO
Gateway
: BEA TUXEDO Requester to DCE Service Using DCE-only
: DCE Requester to BEA TUXEDO Service Using BEA
TUXEDO-only
: Building Mixed DCE/RPC and BEA TUXEDO TxRPC Clients
and Servers

5. Running the Application

Running the Application

Prerequisite Knowledge

Configuring the Application

Booting and Shutting Down the Application

Dynamic Service Advertisement

A. A Sample Application

What This Appendix Is About

Some Preliminaries

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
: The Client Source Code - client.c
: The Server Source Code - server.c
: Makefile - rpcsimp.mk
: The Configuration File - ubbconfig
: MS-DOS and Windows Makefile - rpcsimp.mak
: Windows Definition files - wclient.def and wsimpldll.def

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

Step 11 - Shut Down the Configuration

Step 12 - Clean Up

B. A DCE-Gateway Application

What This Appendix Is About

The DCE-Gateway Application

Step 1 - Create an Application Directory

Step 2 - Set Environment Variables

Step 3 - Copy the Files

Step 4 - List the Files

: IDL ACF File - simpdce.acf
: Binding Function - dcebind.c
: Entry Point Vector - dceepv.c
: DCE Manager - dcemgr.c
: DCE Server - dceserver.c
: Makefile - rpcsimp.mk

Step 5 - Modify the Configuration

Step 6 - Build the Application

Step 7 - Load the Configuration

Step 8 - Configuring DCE

Step 9 - Boot the Configuration

Step 10 - Run the Client

Step 11 - Shut Down the Configuration

Step 12 - Clean Up