Installation

The default installation is enough for this setup. During the first installation, the installer may ask whether there are computers running Windows 2000 or later on the network. Select No.

Receiver-side configuration

On the receiving server, create the objects in this order:

  1. Queue Manager: create a new queue manager named AAAA
  2. Queue: create a new local queue named AAAA.LQ
  3. Channel: create a receiver channel named BBBB.TO.AAAA

Sender-side configuration

On the sending server, configure the corresponding objects:

  1. Queue Manager: create a new queue manager named BBBB
  2. Queue: create a transmission queue named BBBB.TQ

In practice, this means creating a local queue first, then changing Usage in the general settings to Transmission.

  1. Queue: create a remote queue

Configure it with these values:

  • Remote queue: the name of the local queue on the receiving server. This must exactly match the receiver-side queue name. Use AAAA.LQ
  • Remote queue manager: the name of the queue manager on the receiving server. This must also match exactly. Use AAAA
  • Transmission queue: the local transmission queue created on the sender. Select BBBB.TQ
  1. Channel: create a sender channel

Set it up as follows:

  • Channel name: this must be identical to the receiver channel name, BBBB.TO.AAAA
  • Connection name: the receiver server's IP address and port, with the port in parentheses, for example: 127.0.0.1(1414)
  • Transmission queue: BBBB.TQ

One detail that must match

The sender channel name on the local machine must be exactly the same as the receiver channel name on the other server.

Key terms in this configuration

Queue Manager

A queue manager listens on a port and serves as the container for MQ objects and functions. Inside it, you can configure listeners, queues, channels, triggers, and related components.

Queue

A queue is a collection of messages. It can be understood as a FIFO structure, or simply a list holding messages that have been received or are waiting to be sent. If the queue manager is thought of as a database, then a queue is similar to a table.

Local Queue

As the name suggests, a local queue is stored on the local server and uses that server's resources. Once a message enters a local queue, it means the current server has received that message.

Transmission Queue

A transmission queue is a special type of local queue. When you create a local queue, it is a normal queue by default. To make it a transmission queue, change Usage to Transmission.

This queue is central to message delivery. It acts as the bridge between the local queue, the channel, and the remote queue. When data is placed onto a remote queue, it is first put onto the transmission queue, then sent through the sender channel until the other server receives it.

Remote Queue

A remote queue is essentially a mapping to a local queue that exists on another server.