Tuxedo Adapter 6.0 | webMethods Tuxedo Adapter Documentation | webMethods Tuxedo Adapter Installation and User’s Documentation | Overview of the webMethods Tuxedo Adapter | Architectural Overview
 
Architectural Overview
The Tuxedo Adapter provides a set of user interfaces, services, and a template that enable you to create integrations with Tuxedo applications. The adapter is provided as a single package that must be installed on the Integration Server. For detailed installation instructions, see Installing and Uninstalling the Tuxedo Adapter . For software requirements, see the webMethods Adapters System Requirements .
The following diagram illustrates how the Tuxedo Adapter interfaces with a Tuxedo system using the Jolt APIs. Following the diagram are descriptions of the architectural components involved in the integration process.
* Integration Server . The Tuxedo Adapter is installed and runs on the Integration Server.
*WmART Package. The WmART package provides a common framework for Integration Server adapters to use the Integration Server functionality, making the Integration Server the run-time environment for the Tuxedo Adapter. The WmART package is installed with the Integration Server and provides logging, transaction management, and error handling for the adapter and its connections and services.
* Tuxedo Adapter . The Tuxedo Adapter is delivered as a single package called WmTuxedoAdapter. The adapter provides Integration Server Administrator user interfaces that enable you to configure and manage adapter connections, and Digital Event Services and Software AG Designer user interfaces that enable you to configure and manage adapter services. The Tuxedo Adapter installation includes templates from which you can create Tuxedo Adapter connections and services.
*Adapter Connection Template. An adapter connection enables the Integration Server to connect to a Jolt server at run time. You must configure an adapter connection before you can create adapter services. The Tuxedo Adapter provides a template for adapter connections in the Integration Server Administrator. For a detailed description of adapter connections and usage information, see Adapter Connections.
*Adapter Service Template. An adapter service enables the Integration Server to execute Tuxedo services. For example, an adapter service can enable Integration Server clients to write account information to an employee database connected to the Tuxedo server. The Tuxedo Adapter provides an adapter service template in the Digital Event Services and Designer. For more information about the adapter service template and how the services interact, see Adapter Services.
*Jolt API. The Tuxedo Adapter implements the Java-based Jolt API to connect to the Jolt server and initiate a service on the Tuxedo server.
*Jolt Server. The Jolt server acts as a proxy by passing service requests to and from the Tuxedo server on behalf of the Tuxedo Adapter.
*Jolt Repository. The Jolt repository contains all Tuxedo service names and input/output signatures as well as the associated data type information. After the Integration Server makes the initial connection, the Tuxedo Adapter retrieves applicable service definitions from the Jolt repository. The Integration Server stores these definitions in a cache known as the TuxedoConnectionFactory. For more information, see the diagram that follows.
*Tuxedo Server. The Tuxedo server receives requests to execute services from Tuxedo applications.
The basic data flow from Integration Server to the Jolt server is as follows:
Step
Action
1
Using the Integration Server Administrator, you configure a connection in which the WmART package creates a connection object.
2
When the connection is instantiated, the connection object first checks the TuxedoConnectionFactory for the Tuxedo service definitions. If the definitions are not present, the Integration Server proceeds to step 3. If the definitions are present, the Integration Server skips to step 6.
3
The Integration Server implements the Jolt API to connect to the Jolt server.
4
The Jolt server returns the following information from its repository:
*Names of all Tuxedo/Jolt services that are associated with this connection, based on the user login, role, and application access.
*Input and output parameters for each service.
*Maximum number of occurrences of each input and output parameter.
5
The Integration Server stores the information in the tables (cache) associated with the connection.
Note:
If you need to update this information, disable and re-enable the connection. For instructions, see Adapter Connections.
6
The Tuxedo Adapter accesses the information in the TuxedoConnectionFactory when you create an adapter service.
You configure adapter services using a template provided with the Tuxedo Adapter. The template provides all of the code necessary for interacting with the Jolt server, without the data specifications.
The following diagram illustrates the Tuxedo Adapter and the webMethods Integration Server in a business-process integration.