1.2 Overview of the Oracle MQ Adapter for Tuxedo

The Oracle MQ Adapter for Tuxedo provides communication between IBM WebSphere MQ applications and Oracle TUXEDO applications. The MQ Adapter consists of three TUXEDO servers:

• The TM_MQO server manages Tuxedo to WebSphere MQ requests.
• The TMQUEUE_MQM server handles tpenqueue() and tpdequeue() requests.

These servers are managed in the TUXEDO environment. The following figure illustrates the flow of data when a tpcall() is issued from a TUXEDO client to an WebSphere MQ application.

Figure 1-1 Data Flow for tpcall () from TUXEDO to WebSphere MQ

The TUXEDO client calls the service advertised by the Tuxedo to WebSphere MQ server (TM_MQO). The configuration of the service dictates the queue manager name, queue name, and reply queue related to the service. The MQ Adapter then places the request on the WebSphere MQ queue to be processed by the WebSphere MQ application. The MQ Adapter waits for the reply message on the output queue. When the MQ Adapter receives the reply, it returns the response data to the client's outstanding tpcall().

The TMQUEUE _MQM server handles tpenqueue() and tpdequeue() requests from clients who want to place messages on WebSphere MQ queues. The following figure illustrates the enqueuing and dequeuing message flows:

Figure 1-2 Message Flow for tpenqueue () and tpdequeue ()

The WebSphere MQ to Tuxedo server (TM_MQI), processes service requests from WebSphere MQ applications to TUXEDO servers. The following figure illustrates the data flow for inbound requests:

Figure 1-3 Data Flow for Inbound Service Requests

The WebSphere MQ to Tuxedo server (TM_MQI) monitors specified queues for requests. When TM_MQI receives a request, it issues a tpcall() request to the designated server. It then places the response data in the reply queue specified in the original request.

Both multi-threaded and single-threaded TM_MQI servers are supplied. Multi-threaded TM_MQI server creates one thread dedicated to each MQ queue, while single-threaded TM_MQI switches among MQ queues. Both TM_MQO and multi-threaded TM_MQI servers support MQ failure recovery. They try reconnection to WebSphere MQ automatically when they are configured.