Using Java Enterprise Tuxedo

 

This document describes the Java Enterprise Tuxedo^TM (JET) component of BEA WebLogic Enterprise^TM, which enables Java servers running in the WebLogic Enterprise environment to access services in the BEA Tuxedo® environment. It provides instructions for configuring JET and for using the JET Class Library in Java server applications.

 

1. Introducing Java Enterprise Tuxedo

Key Features

JET Workflow

Key Components

JET Class Library

Jolt Repository Server

How BEA Tuxedo Services are Distributed

Workflow for Handling BEA Tuxedo Service Requests

Tools for Managing Service Definitions

Bulk Loader

Jolt Repository Editor

Jolt Servers

Jolt Internet Relay

Using BEA Tuxedo Buffer Types with JET

Comparison Between Jolt and JET

Overview of Jolt and JET

Architecture Comparison

Components Comparison

Functionality Comparison

Class Library Comparison

Packages

Package bea.jolt Components

 

2. Invoking BEA Tuxedo Services

Configuring JET for Java Server Access

Default Repository File

Parameters to Specify in the UBBCONFIG File

GROUPS Section

SERVERS Section

Sample UBBCONFIG File

Invoking BEA Tuxedo Services with the JET Class Library

Importing Packages

Instantiating a JoltService Object

Specifying Parameters for the BEA Tuxedo Service

Specifying String Parameters

Specifying Array Parameters

Specifying Parameters of Various Data Types

Calling the BEA Tuxedo Service

Handling Results

Handling Exceptions

Handling Returned Parameters

 

3. Configuring JET for Client Access

Configuring JET

About Configuring JET for Client Access

Step 1: Configure JSL

Step 2: Configure Jolt Relay

Configuring JRLY on the Web Server

Configuring JRAD in the Tuxedo Environment

Step 3: Registering Tuxedo Services with the Repository

JET Administrative Reference

Jolt Server Reference

About Jolt Servers

System Administrator Responsibilities

Starting the JSL

Shutting Down the JSL

Restarting the JSL

Configuring the JSL

JSL Command-Line Options

Sample UBBCONFIG Settings for JSL

Security and Encryption

Jolt Internet Relay Reference

About Jolt Relay and the Jolt Relay Adapter

Jolt Relay

Jolt Relay Adapter

 

4. Using the Bulk Loader Program

Defining Bulk Loader Data Files

About 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

Sample Bulk Loader Data File

Running the Bulk Loader

Troubleshooting

 

5. Using the BEA Jolt Repository Editor

Introducing the Jolt Repository Editor

Jolt Repository Editor Window

Components of the Jolt Repository Editor Window

Getting Started with the Jolt Repository Editor

Starting the Jolt Repository Editor

Starting the Jolt Repository Editor Using the Java Applet Viewer

Starting the Jolt Repository Editor from Your Web Browser

Logging On to the Jolt Repository Editor

Sample Logon Window

Components of the BEA Jolt Repository Editor Logon Window

Exiting the BEA Jolt Repository Editor

Main Components of the BEA Jolt Repository Editor

Workflow for the BEA Jolt Repository Editor

What Is a Package?

Sample Packages Window

Components of the Packages Window

Viewing a Package

What Is a Service?

Sample Services Window

Components of the Services Window

Viewing a Service

Working with Parameters

Sample Services Window with Parameters

Viewing a Parameter

Setting Up Packages and Services

Saving Your Work

Adding Packages

Sample Package Organizer Window

Adding a Package

Adding Services

Sample Edit Services Window

Options for Adding a Service

Adding a Service

Selecting CARRAY or STRING as a Service Buffer Type

Adding Parameters

Sample Edit Parameters Window

Components of the Adding a Parameter Window

Adding a Parameter

Selecting CARRAY or STRING as a Parameter Data Type

Grouping Services Using the Package Organizer

Sample Package Organizer Window

Components of the Package Organizer Window

Grouping Services with the Package Organizer

Modifying Packages, Services, and Parameters

Editing Services

Sample Edit Services Window

Editing a Service

Editing Parameters

Sample Edit Parameters Window

Editing a Parameter

Deleting Parameters, Services, and Packages

Deleting a Parameter

Deleting a Service

Deleting a Package

Making a Service Available to the JET Client

Exporting and Unexporting Services

Sample Packages Window

Exporting or Unexporting a Service

Reviewing the Exported and Unexported Status

Testing a Service

Sample Service Test Window

Components of the Service Test Window

Testing a Service

Test Service Process Flow

Testing a Service

Troubleshooting

Repository Enhancements for Jolt