If you want to use WebSphere® MQ multi-channel
support in a clustered configuration, first set the agentMultipleChannelsEnabled
property to true and then complete the steps in this
topic.
About this task
In a cluster, multi-channel support is enabled by WebSphere MQ definitions on the queue
manager of the destination agent only.
You must complete the
steps in this topic in addition to the standard WebSphere MQ configuration steps required
for a WebSphere MQ
File Transfer Edition agent, which
are listed in Configuring WebSphere MQ File Transfer Edition for first use.
The
configuration examples shown below use runmqsc commands.
Procedure
- Define a cluster-receiver channel for each channel that
you want to use. For example, if you are using two channels:
DEFINE CHANNEL(TO.DESTQMGRNAME_1) CHLTYPE(CLUSRCVR) CLUSTER(FTECLUSTER)
DEFINE CHANNEL(TO.DESTQMGRNAME_2) CHLTYPE(CLUSRCVR) CLUSTER(FTECLUSTER)
where:
- DESTQMGRNAME is the name of the queue manager of the destination
agent.
- FTECLUSTER is the name of the WebSphere MQ cluster.
You are recommended to use the TO.DESTMGRNAME_n naming convention
for channels, but this convention is not mandatory.
- Define a queue manager alias corresponding to each channel.
For example:
DEFINE QREMOTE(SYSTEM.FTE.DESTQMGRNAME_1) RQMNAME(DESTQMGRNAME) CLUSTER(FTECLUSTER)
DEFINE QREMOTE(SYSTEM.FTE.DESTQMGRNAME_2) RQMNAME(DESTQMGRNAME) CLUSTER(FTECLUSTER)
You
must use the SYSTEM.FTE.DESTQMGRNAME_n naming convention for queue
manager aliases because the sending agent searches for queue manager
aliases of this format. The numbers that you use for n must
start at 1 and be consecutive. You must make the definitions cluster-wide
so that they are available on the source agent's queue manager. For both the source agent and destination agent to correctly
determine the number of queue manager aliases, do not define
a default XMITQ for the queue manager.