Contents

Title Page

Copyright Page

Preface

Purpose of This Manual

Audience

Jolt Documentation

How This Manual is Organized

Related Manuals

Other TUXEDO Resources

Document Conventions

1. Introducing BEA Jolt

What is BEA Jolt?

Key Features

How It Works

Jolt Servers

Jolt Class Library for Java

Jolt Server and Jolt Client Communication

Jolt Repository

Jolt Internet Relay

How to Jolt your TUXEDO Applications

2. Installing Jolt

Installation Requirements

Server Requirements

Jolt Relay Requirements

Client Requirements

BEA Jolt 1.1 Installation

Directory Structure

Before You Begin

UNIX System Installation Instructions

UNIX System Installation Script

Windows NT Installation Instructions

Licensing your Jolt Software

Using the Jolt Online Documentation

Getting Started with the Documentation

3. Configuring the Jolt System

Using the Jolt Server

Jolt Internet Relay

Security and Encryption

Starting the Jolt Server

Configuring the Jolt Server

Shutting Down the Jolt Server

Using the Jolt Repository

Configuring the Jolt Repository

Initializing Services Using TUXEDO and the Repository Editor

Event Subscription

Configuration

Jolt Internet Relay

Jolt Relay (JRLY)

Jolt Relay Adapter (JRAD)

Using Sample Applications in Jolt Online Resources

4. Bulk Loading TUXEDO Services

Introduction to the Bulk Loader

Getting Started Using the Bulk Loader

Using UNIX

Using Windows NT

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

5. Using the Jolt Repository Editor

Introduction to the Repository Editor

Repository Editor Window

Getting Started

Starting the Repository Editor Using appletviewer

Starting the Repository Editor Using Your Web Browser

Logging on to the Repository Editor

Exiting the Repository Editor

Main Components of the Repository Editor

Repository Editor Flow

What is a Package?

What is a Service?

What is a Parameter?

Setting Up Packages and Services

Saving Your Work

Adding a Package

Adding a Service

Adding a Parameter

Grouping Services Using the Package Organizer

Modifying Packages/Services/Parameters

Editing a Service

Editing a Parameter

Deleting Parameters/Services/Packages

Making a Service Available to the Jolt Client

Exporting/Unexporting Services

Reviewing the Exported/Unexported Status

Testing a Service

Repository Editor Service Test Window

Testing a Service Process Flow

Troubleshooting

6. Using the Jolt Class Library

Class Library Functionality Overview

Java Applications vs. Java Applets

Jolt Class Library Features

Jolt Client/Server Relationship

Jolt Object Relationships

Jolt Class Functionality

Jolt Class Library Walk-through

Using TUXEDO Buffer Types with Jolt

Using the STRING Buffer Type

Using the CARRAY Buffer Type

Using the FML Buffer Type

Using the VIEW Buffer Type

Multithreaded Applications

Preemptive and Non-preemptive Threads

Using Jolt with Non-Preemptive Threading

Using Threads for Asynchronous Behavior

Using Threads with Jolt

Event Subscription and Notifications

API for Event Subscription

Notification Event Handler

Connection Modes

Notification Data Buffers

TUXEDO Event Subscription

Using the Jolt API to Receive TUXEDO Notifications

Clearing Parameter Values

Reusing Objects

Application Deployment and Localization

Deploying a Jolt Applet

Client Considerations

Web Server Considerations

Localizing a Jolt Applet

7. Jolt Class Library Reference

Jolt Methods

Methods for Handling Items

JoltSessionAttributes Class

JoltSessionAttributes Constructor

JoltSessionAttributes

JoltSessionAttributes Methods

checkAuthenticationLevel

clear

getByteDef

getBytesDef

getDoubleDef

getFloatDef

getIntDef

getShortDef

getStringDef

setByte

setBytes

setDouble

setFloat

setInt

setShort

setString

JoltSession Class

JoltSession Constructor

JoltSession

JoltSession Method

endSession

isAlive

onReply

finalize

JoltRemoteService Class

JoltRemoteService Constructor

JoltRemoteService

JoltRemoteService Methods

call

JoltRequestMessage Abstract Class

JoltRequestMessage Methods

clear

getApplicationCode

getName

getOccurrenceCount

getByteDef

getBytesDef

getDoubleDef

getFloatDef

getIntDef

getShortDef

getStringDef

getByteItemDef

getBytesItemsDef

getDoubleItemDef

getFloatItemDef

getIntItemDef

getShortItemDef

getStringItemDef

setRequestPriority

setByte

setBytes

setDouble

setFloat

setInt

setShort

setString

setByteItem

setBytesItem

setDoubleItem

setFloatItem

setIntItem

setShortItem

setStringItem

addByte

addBytes

addDouble

addFloat

addInt

addShort

addString

delete

deleteItem

JoltTransaction Class

JoltTransaction Constructor

JoltTransaction

JoltTransaction Methods

commit

rollback

JoltEvent Class

JoltEvent Methods

unsubscribe

unsubscribeAll

JoltUserEvent Class

UNSOLMSG

JoltUserEvent Methods

JoltUserEvent

JoltReply Class

JoltReply Methods

getMessage

JoltMessage Class

JoltMessage Methods

getOccurrenceCount

getByteDef

getShortDef

getIntDef

getFloatDef

getDoubleDef

getStringDef

getBytesDef

getByteItemDef

getShortItemDef

getIntItemDef

getFloatItemDef

getDoubleItemDef

getBytesItemDef

getStringItemDef

A. Jolt Class Library Errors and Exceptions

Jolt Error and Exception Handling

ApplicationException Class

ApplicationException Methods

getMessage Method

getApplicationCode Method

getObject Method

JoltException Class

JoltException Methods

getMessage Method

getErrno Method

getObject Method

EventException Class

MessageException Class

ServiceException Class

SessionException Class

TransactionException Class

TUXEDO Errors

B. System Messages

Jolt System Messages

Repository Messages

FML Error Messages

Information Messages

Jolt Relay Adapter (JRAD) Messages

Jolt Relay (JRLY) Messages

Bulk Loader Utility Messages

Glossary