How to Use the Online Help

What if the Help System Doesn't Display Properly?

Make Sure You Are Using an Up-to-Date Browser

Customize the Font Size so the Help is Easy to Read

Important Considerations About the BEA Builder Installed Browser

Using Your Favorite Web Browser

How to Print

How to Print the Current Topic

How to Print the Complete Book

Documentation Conventions

Where to Find Related Information

BEA TUXEDO Builder Related Information

Rose Expert Development Related Information

BEA TUXEDO Related Information

Contact Information

Documentation Support

Customer Support

How it Works

Advantages of Using the Rose Expert

Using the Rose Expert with Other Builder Products

Using the Configuration Expert to Set Up and Boot Servers Created with the Rose Expert

Populating the Contract Repository with Data from Rational Rose

How Does the Rose Expert Compare to the C++ Expert?

What Do I Need to Know About Developing TUXEDO Applications in the Rose Model?

What is Added to the Rational Rose GUI When I Install BEA Rose Expert?

Rose Expert Options in the Rational Rose "Tools" Menu

Rose Expert BEABuilder Tabs in Rational Rose Specification Dialogs

BEABuilder Tab in Rose Operation Specification Dialog

BEABuilder Tab in Rose Component Specification for a Task Module

BEABuilder Tab in Rose Component Package Specification Dialog

Rose Expert Options in the Rational Rose "Help" Menu

Main Tasks

What is the Rose Expert?

What is Rational Rose?

What is the Unified Modeling Language?

Using an Object-Oriented Development Approach

Using Rational Rose to Model a TUXEDO Application

Define Requirements with Use Cases

Perform Analysis with Class Diagrams Showing Ideal Object Model

Design

Create Packages and a Class Diagram for the Package

Create Classes and a Class Diagram

Create Component Packages and a Component Diagram

Using the Rose Expert to Generate Code Based on Your Model

Getting Started

Specifying Application Settings

Specifying Generation Settings

Specifying Makefile Settings

Specifying Logon Settings

Validating a Model

Generating Classes

Prerequisite Tasks

What the Generate Process Produces

How to Generate Code from Model Classes

Generated Files Directory Structure

Generic Directory Structure for Generated Files

Generated Files Directory for Bankapp Example

Populating the Repository

Prerequisite Tasks

What the Populate Repository Process Does

How to Populate the Contract Repository with Model Data

Testing Default Service Implementations

Configuring the Generated Test Client and Server

Running the Generated Test Client

API Overview

Programming Model and Data Type Mapping

Rose Expert Classes and Naming Conventions

Naming Generated Classes

The BEATuxBldr Namespace

Exception Classes

Generated Files

Directory Structure

Make files

FML Field Table File

The gservers.lst File

Rose Expert Classes

AppException

Member Functions

GetTpurcode

AtmiException

Member Functions

GetMessage

Exception

Member Functions

GetMessage

FmlException

Member Functions

GetMessage

Generated Exception

Data Members

_exception_parameter2

_exception_parameter3

Member Functions

Generated Server

Member Functions

Instance

Generated Service Reply

Member Functions

Getparameter2

parameter3

ReplyCompleted

Generated Service Request

Data Types

InvocationType

Member Functions

GetFlags

GetInvoke

GetTpqctl

Operation1

SetFlags

SetInvoke

SetQoptions

SetTpqctl

Generated Service Implementation

Member Functions

Instance

Operation1

HeuristicHazard

Member Functions

HeuristicMixed

Member Functions

Interface Abstract Base Class

Member Functions

Operation1

InvalidControl

Member Functions

NoTransaction

Member Functions

Server

Member Functions

close_xa_rm

initialize

open_xa_rm

release

ServiceReply

Member Functions

GetFlags

GetReply

GetTpqctl

GetTpurcode

ServiceReply

SetFlags

SetQoptions

SetTpqctl

SubtransactionsUnavailable

Member Functions

Transaction

Data Types

Status

Member Functions

begin

commit

get_status

resume

rollback

rollback_only

set_timeout

suspend

Transaction

TransactionException

Member Functions

TuxException

Member Functions

What is BANKAPP?

Where to Find the BANKAPP Sample

What You Need to Start BANKAPP

Running the BANKAPP Sample

Using the BANKAPP Client Menu

Using Valid Accounts

Example of BANKAPP Interactions

Exiting BANKAPP

Code Examples

Implementing a Service

Declare Variables and Output Parameters

Transform Input Parameters for OPEN_ACCT

Add a New Account to the In-memory Database

Check for Application Errors

Send the Reply to the Client

Making a Synchronous Call

Create the Service Request Object

Declare Parameters

Prompt for Input Parameters for OPEN_ACCT

Make a Synchronous Call to the OPEN_ACCT Service

Display the Results of the Service Reply

Making Asynchronous Calls Within a Transaction

Create the Transaction and Service Request Objects

Declare Parameters and Variables

Start a Transaction

Prompt for Input Parameters for WITHDRAWAL and DEPOSIT

Make Asynchronous Calls to the WITHDRAWAL and DEPOSIT Services

Polling for and Collecting Pending Replies

End a Successful Transaction

Display the Results of the Service Replies

6. Keyboard and Menu Shortcuts

7. Windows and Dialogs Reference

Generation Settings

Makefile Settings

Logon Settings

Validate Model

Select Component Package to Generate

Generate Framework Classes

Populate Contract Repository - Logon

Select Component Package to Export

Populate Contract Repository

Copyright Page