MQSeries Connection User's Guide

 

This document describes Versions 4.0A and 5.0 of the BEA MessageQ MQSeries Connection product and gives instructions for building BEA MessageQ MQSeries Connection applications. Version 4.0A is designed to interoperate with BEA MessageQ Version 4.0A and IBM MQSeries 5.0 applications. Version 5.0 is designed to interoperate with BEA MessageQ Version 5.0 and IBM MQSeries 5.0 applications.

 

Introduction to BEA MessageQ MQSeries Connection

Message Queuing

Message Queuing Interfaces

The BEA MessageQ Product

The IBM MQSeries Product

How Message Queuing Systems Work

The Need for Integrated Message Queuing

How BEA MessageQ MQSeries Connection Works

Communication Services Between BEA MessageQ and IBM MQSeries

Queue Message Bridge Components

Message Flow

 

Developing Message Queuing Applications

Using Application Programming Interfaces

Designing Applications to Use BEA MessageQ MQSeries Connection

Determining Queues that Your Application Needs

Defining Queues for BEA MessageQ Clients to IBM MQSeries Servers

Defining Queues for IBM MQSeries Clients to BEA MessageQ Servers

Choosing Message Characteristics

Selecting the Type for Message Exchange

Processing Reply Messages

Processing Multiple Replies

How IBM MQSeries Applications Process Multiple Replies

How BEA MessageQ Applications Process Multiple Replies

Using Message Types and Classes

BEA MessageQ Message Types and Classes

IBM MQSeries Message Types

Using Recoverable Messaging

Using Correlation Identifiers

Using FML Buffers

Setting Message Priority

How Message Header Data Is Mapped

Handling Message Byte Order Differences

Character Code Conversion

Guidelines for Choosing Message Characteristics

Sending a Request to an IBM MQSeries Server

Sending a Reply to a BEA MessageQ Client

Sending a Request to a BEA MessageQ Server

Sending a Reply to an IBM MQSeries Client

Restrictions and Limitations

 

Configuring BEA MessageQ MQSeries Connection

Overview of Configuration Tasks

Configuring BEA MessageQ

Group Name Table

Configuring IBM MQSeries

Configuring the Required IBM MQSeries Queues

Defining IBM MQSeries Queues

Tips for Configuring IBM MQSeries

Configuring the Queue Message Bridge

Registering Remote Service Queues

 

Managing the BEA MessageQ MQSeries Connection Environment

Starting the Queue Message Bridge

Performance Considerations

Stopping the Queue Message Bridge

Using the BEA MessageQ Monitor Utility

Using the runmqsc MQSeries Utility

Troubleshooting BEA MessageQ MQSeries Connection Problems

Queue Message Bridge Log Files

Using IBM MQSeries Log Files

Using the BEA MessageQ MQSeries Connection Utility

How the BEA MessageQ MQSeries Connection Utility Works

Starting the BEA MessageQ MQSeries Connection Utility

Understanding Current and Default Target Groups and Queues

Selecting the Terminate QMB Process Message Choice

Selecting the Dynamic Service Registration Message Choice

Selecting the Close Old and Open New Log File Message Choice

Selecting the Reload QMB Configuration File Message

Exiting the BEA MessageQ MQSeries Connection Utility

 

Programming Examples

Using the Programming Examples

Building the Programming Examples

QMB_DMQECHO

QMB_MQSECHO

QMB_DMQCLIENT

QMB_MQSCLIENT

Running the QMB_MQSECHO and QMB_DMQCLIENT Test Pair

Running the QMB_MQSCLIENT and QMB_DMQECHO Test Pair

Testing the Programming Examples

Testing the IBM MQSeries Connection to BEA MessageQ

Testing the BEA MessageQ Connection to IBM MQSeries

 

Messages

DUMP_QTABLES

EVENT_LOG

LOAD_CONFIG

NEW_LOG

PURGE_CI

PURGE_CI_ALL

QMB_TERMINATE

RSQ_REGISTER

TRACE_LOG