JetNet/Oracle Tuxedo Guide

About This Document

• What You Need to Know
• Documentation Website
• How to Print the Document
• Documentation Conventions
• Contact Us!

1. Enterprise Model and Implementation

• Three-Tier Processing
• Three-Tier Application Components
• Workstation Connections
• Multi-Machine Configuration
• Web Application Server
• Panther Development Environment
• Administration Tools

2. Setting the Enterprise Environment

• Setting Up the Enterprise Directory
• Server Executables
• Application Libraries
• Environment Files
• Setting the Environment
• UNIX Environment
• Windows Environment
• Environment File Settings
• Machine Environment File
• Server Environment File
• Interfacing with SCCS/PVCS
• SMVARS Settings
• Setting Up the Client Environment
• Workstation Clients
• Setting Access to Libraries
• Enabling Client Connections
• Native Clients
• Middleware Configuration File
• Setting IPC Resources
• Messages
• UNIX
• Windows
• Semaphores
• UNIX
• Windows
• Shared Memory Requirements
• UNIX
• Windows

3. Configuring the Enterprise

• Using the JetNet Manager
• Creating a Configuration File
• How to Create a Basic Configuration File
• Editing a Configuration File
• Adding and Deleting Components
• Editing Components
• Selecting Another Enterprise's Configuration
• Setting Enterprise Properties
• General Settings
• How to Assign or Reassign Machines Roles
• Advanced Settings
• Setting Machine Properties
• Network Settings
• Workstation Connections
• Setting Server Properties
• Server Details
• Standard Server
• Conversion Server
• File Access Server

4. Managing the Enterprise

• Monitoring an Enterprise
• Activating and Deactivating Components
• Enterprise Application
• Machine
• Servers
• Connecting and Disconnecting
• Forcibly Deactivating Components
• Adding and Deleting Components
• Adding and Removing Server Instances
• How to Add a Server Instance
• How to Remove a Server Instance
• Changing Machine Roles
• Recovering From Master Machine Failure
• Reassigning Master and Backup Machines
• Disabling and Reenabling Workstation Connections
• Handling Load
• Status and Error Messages

5. Defining Services in JetNet and Oracle Tuxedo Applications

• Services
• Service Routine
• Service Component
• JIF Service Definition
• Optional Service Attributes
• Creating Graphical Services
• Creating Services with the Screen Wizard
• Building Services with the Screen Editor
• Modifying Service Components
• Initiating a Service
• Using Service Aliases to Test Services
• Writing Service Routines
• Storing and Invoking JPL Service Code
• Service Code and Service Components
• JIF-Invoked Services
• Public Services
• Service Groups
• Criteria for Grouping Services
• Adding Services to Existing Service Groups
• Service Messages and Data Types
• Buffer Data Types
• Default Mapping
• NULL Arguments
• Arrays
• FML and FML32 Buffers
• Converting from JAMFLEX to FML
• STRING Data Types
• Setting Service Message Types

6. JetNet/Oracle Tuxedo Event Processing

• Event Sequence
• Handler Scope and Installation
• Writing Event Handlers
• Events Generated within Handlers
• Built-in Handlers
• Advertise and Unadvertise Events
• Advertise and Unadvertise Handlers
• Scope
• Contact
• Returns
• Built-in Handlers
• Exception Events
• Exception Handlers
• Exceptions within an Exception Handler
• Scope
• Contract
• Returns
• Exception Severity Codes
• Built-in Handlers
• Jif_changed Events
• Jif_changed Handlers
• Scope
• Contract
• Returns
• Built-in Handlers
• Message Events
• Message Handlers
• Recognizing the Message Source
• Scope
• Contract
• Returns
• Built-in Handlers
• Pre_request and Post_request Events
• Pre_request and Post_request Handlers
• Scope
• Contract
• Returns
• Built-in Handlers
• Request_received Events
• Request_received Handlers
• Scope
• Contract
• Returns
• Built-in Handlers
• Server_exit Events
• Server_exit Handlers
• Scope
• Contract
• Returns
• Built-in Handlers
• Pre_service and Post_service Events
• Pre_service and Post_service Handlers
• Scope
• Contract
• Returns
• Example
• Built-in Handlers
• Unload Events
• Unload Handlers
• Scope
• Contract
• Returns
• Example
• Built-in Handlers

7. Transaction Model for JetNet

• Built-in Services
• Modifying the Model
• Service Limitations
• Server Processing
• Transactional Control

8. Oracle Tuxedo Features

• Service Data Buffer Types
• FML and FML32 Buffers
• STRING Buffers
• XA Transaction Management
• Message Forwarding
• Event Brokering
• How to Use the Event Broker
• Accessing the Event Broker
• Example: Stock-change Event
• Example: Enterprise Bank
• Posting and Subscribing
• Unsubscribing
• Reliable Queues
• To use reliable queues:
• Enqueuing a Message
• Dequeuing a Message
• Defining Reliable Queues
• To identify and access queues (and their queuespaces):
• Service Queues
• Independent Queues
• Example
• Initializing Servers

A. Administration Utilities

• clnt2svr
• Description
• rb2asc
• Description
• rbboot
• Description
• rbconfig
• Description
• rblisten
• Description
• rbshutdown
• Description

B. Converting to a Three-tier Application

• Converting an Application from Two- to Three-Tier
• Property Settings
• Requirements for Running a Converted Application
• Ensuring Usability
• Enhancing a Converted Application

C. Enterprise Bank

• The User's View of Enterprise Bank
• Running Enterprise Bank
• Enterprise Bank Customer ATM Client
• Starting the Customer ATM Client
• ATM Services
• Security Violation Alert
• Customer Selections
• Make a Deposit
• Make a Withdrawal
• Withdrawal Limit Exceeded
• Transfer
• Bank News
• Balance Inquiry
• Exit Customer Services
• The Enterprise Bank Employee Client
• Starting the Bank Employee Client
• Employee Services
• Accounts Menu Option
• Display a Complete List of Accounts
• Display a Single Account
• Examine a Customer's Accounts
• Select an Account for Maintenance
• Customers Menu Option
• Display a Complete List of Customers
• Display a Single Customer
• Update Customer Information
• New Customer Mailings
• The Enterprise Bank Administrator Client
• Starting the Bank Administrator Client
• Administrator Services
• Accounts Menu Option
• Post Interest to Accounts
• Modify an Account Type
• Customers Menu Option
• Personnel Menu Option
• Display a List of Employees
• Add/Update or Delete an Employee
• Select an Employee for Maintenance
• Broadcasting a Message
• Broadcast a Message
• Designing Enterprise Bank

D. JetNet/Oracle Tuxedo Exception Event Types

E. Application Setup Checklist

• Setting Up the Application Server
• Populate the Application Directory
• Unix Environment
• Windows Environment
• Configure the Middleware
• Create a Configuration File
• Configure Each Server
• Start the Application Server
• Stop the Application Server
• Setting Up the Workstation Client

F. Deployment Checklist for JetNet

• Directory Structure for JetNet Applications
• Checklist for Deployment
• Preparing a Windows Distribution
• Preparing a UNIX Distribution

Index