Using BEA Jolt

Introducing BEA Jolt

BEA Jolt Components

Key Features

How BEA Jolt Works

Jolt Servers

Jolt Class Library

JoltBeans

Jolt Server and Jolt Client Communication

Jolt Repository

Jolt Repository Editor

Jolt Internet Relay

Creating a Jolt Client to Access BEA Tuxedo Applications

Bulk Loading BEA Tuxedo Services

Using the Bulk Loader

Activating the Bulk Loader

Command-line Options

The Bulk Load File

Syntax of the Bulk Loader Data Files

Guidelines for Using Keywords

Keyword Order in the Bulk Loader Data File

Using Service-Level Keywords and Values

Using Parameter-Level Keywords and Values

Troubleshooting

Sample Bulk Load Data

Configuring the BEA Jolt System

Quick Configuration

Editing the UBBCONFIG File

Exiting the Repository Editor

Configuring the BEA Tuxedo TMUSREVT Server for Event Subscription

Configuring Jolt Relay

On UNIX

On UNIX and Windows 2003

On Windows 2003 Only (Optional)

Start the Jolt Relay Adapter (JRAD)

Configure the JRAD

Jolt Background Information

Jolt Server

Starting the JSL

Shutting Down the JSL

Restarting the JSL

Configuring the JSL

JSL Command-line Options

Security and Encryption

Jolt Relay

Jolt Relay Failover

Jolt Client to JRLY Connection Failover

JRLY to JRAD Adapter Connection Failover

Jolt Relay Process

Starting the JRLY on UNIX

JRLY Command-line Options for Windows 2003

JRLY Command-line Option for UNIX

JRLY Configuration File

Jolt Relay Adapter

JRAD Configuration

Network Address Configurations

Jolt Repository

Configuring the Jolt Repository

GROUPS Section

SERVERS Section

Repository File

Initializing Services By Using BEA Tuxedo and the Repository Editor

Event Subscription

Configuring for Event Subscription

Filtering BEA Tuxedo FML or VIEW Buffers

Buffer Types

FML Buffer Example

BEA Tuxedo Background Information

Configuration File

Creating the UBBCONFIG File

Configuration File Format

MACHINES Section

GROUPS Section

SERVERS Section

Parameters Usable with JSL

Optional Parameters

Boot Parameters

Run-time Parameters

Parameters Associated with RESTART

Entering Parameters

Sample Applications in BEA Jolt Online Resources

Using the Jolt Repository Editor

Introduction to the Repository Editor

Repository Editor Window

Repository Editor Window Description

Getting Started

Starting the Repository Editor Using the Java Applet Viewer

Starting the Repository Editor from Your Web Browser

To Start from a Local File

To Start from a Web Server

Logging On to the Repository Editor

Repository Editor Logon Window Description

Exiting the Repository Editor

Main Components of the Repository Editor

Repository Editor Flow

What Is a Package?

Packages Window Description

Instructions for Viewing a Package

What Is a Service?

Services Window Description

Instructions for Viewing a Service

Working with Parameters

Instructions for Viewing a Parameter

Setting Up Packages and Services

Saving Your Work

Adding a Package

Instructions for Adding a Package

Adding a Service

Adding a Service Window Description

Instructions for Adding a Service

Selecting CARRAY or STRING as a Service Buffer Type

Adding a Parameter

Adding a Parameter Window Description

Instructions for Adding a Parameter

Selecting CARRAY or STRING as a Parameter Data Type

Grouping Services Using the Package Organizer

Package Organizer Window Description

Instructions for Grouping Services with the Package Organizer

Modifying Packages, Services, and Parameters

Editing a Service

Instructions for Editing a Service

Editing a Parameter

Instructions for Editing a Parameter

Deleting Parameters, Services, and Packages

Deleting a Parameter

Deleting a Service

Deleting a Package

Making a Service Available to the Jolt Client

Exporting and Unexporting Services

Reviewing the Exported and Unexported Status

Testing a Service

Jolt Repository Editor Service Test Window

Service Test Window Description

Testing a Service

Test Service Process Flow

Instructions for Testing a Service

If Edits are Required After Testing

Repository Editor Troubleshooting

Using the Jolt Class Library

Class Library Functionality Overview

Java Applications Versus Java Applets

Jolt Class Library Features

Error and Exception Handling

Jolt Client/Server Relationship

Jolt Object Relationships

Jolt Class Library Walkthrough

Logon and Logoff

Synchronous Service Calling

Transaction Begin, Commit, and Rollback

Using BEA Tuxedo Buffer Types with Jolt

Using the STRING Buffer Type

Define TOUPPER in the Repository Editor

ToUpper.java Client Code

Using the CARRAY Buffer Type

Define the Tuxedo Service in the Repository Editor

tryOnCARRAY.java Client Code

Using the FML Buffer Type

tryOnFml.java Client Code

FML Field Definitions

Define PASSFML in the Repository Editor

tryOnFml.c Server Code

Using the VIEW Buffer Type

Define VIEW in the Repository Editor

simpview.java Client Code

VIEW Field Definitions

simpview.c Server Code

Using the XML Buffer Type

Define the Tuxedo Service in the Repository Editor

simpxml.java Client Code

Using the MBSTRING Buffer Type

Multithreaded Applications

Threads of Control

Preemptive Threading

Non-Preemptive Threading

Using Jolt with Non-Preemptive Threading

Using Threads for Asynchronous Behavior

Using Threads with Jolt

Event Subscription and Notifications

Event Subscription Classes

Notification Event Handler

Connection Modes

Notification Data Buffers

BEA Tuxedo Event Subscription

Supported Subscription Types

Subscribing to Notifications

Unsubscribing from Notifications

Using the Jolt API to Receive BEA Tuxedo Notifications

Clearing Parameter Values

Reusing Objects

Deploying and Localizing Jolt Applets

Deploying a Jolt Applet

Client Considerations

Web Server Considerations

Localizing a Jolt Applet

Using SSL

Using JoltBeans

Overview of Jolt Beans

JoltBeans Terms

Adding JoltBeans to Your Java Development Environment

Using Development and Run-time JoltBeans

Basic Steps for Using JoltBeans

JavaBeans Events and BEA Tuxedo Events

Using BEA Tuxedo Event Subscription and Notification with JoltBeans

How JoltBeans Use JavaBeans Events

The JoltBeans Toolkit

JoltSessionBean

JoltServiceBean

JoltUserEventBean

Jolt-Aware GUI Beans

JoltTextField

JoltLabel

JoltList

JoltCheckbox

JoltChoice

Using the Property List and the Property Editor to Modify the JoltBeans Properties

JoltBeans Class Library Walkthrough

Building the Sample Form

Placing JoltBeans onto the Form Designer

Wiring the JoltBeans Together

Step 1: Wire the JoltSessionBean Logon

Step 2: Wire JoltSessionBean to JoltServiceBean Using PropertyChange

Step 3: Wire the accountID JoltTextField as Input to the JoltServiceBean Using JoltInputEvent

Step 4: Wire Button to JoltServiceBean Using JoltAction

Step 5: Wire JoltServiceBean to the Balance JoltTextField Using JoltOutputEvent

Step 6: Wire the JoltSessionBean Logoff

Step 7: Compile the Applet

Running the Sample Application

Using the Jolt Repository and Setting the Property Values

JoltBeans Programming Tasks

Using Transactions with JoltBeans

Using Custom GUI Elements with the JoltService Bean

Using Servlet Connectivity for BEA Tuxedo

What Is a Servlet?

How Servlets Work with Jolt

The Jolt Servlet Connectivity Classes

Writing and Registering HTTP Servlets

Jolt Servlet Connectivity Sample

Viewing the Sample Servlet Applications

SimpApp Sample

Requirements for Running the SimpApp Sample

Installing the SimpApp Sample

BankApp Sample

Requirements for Running the BankApp Sample

Installation Instructions

Admin Sample

Requirements for Running the Admin Sample

Installation Instructions