What the example for z/OS shows
This example involves a payroll query application connected to queue manager QM1 that sends payroll query messages to a payroll processing application running on queue manager QM2. The payroll query application needs the replies to its queries sent back to QM1.
The payroll query messages are sent from QM1 to QM2 on a sender-receiver channel called QM1.TO.QM2, and the reply messages are sent back from QM2 to QM1 on another sender-receiver channel called QM2.TO.QM1. Both of these channels are triggered to start as soon as they have a message to send to the other queue manager.
The payroll query application puts a query message to the remote queue PAYROLL.QUERY
defined on QM1. This remote queue definition resolves to the local queue PAYROLL
on QM2. In
addition, the payroll query application specifies that the reply to the query is sent to the local
queue PAYROLL.REPLY
on QM1. The payroll processing application gets messages from the local
queue PAYROLL
on QM2, and sends the replies to wherever they are required; in this case,
local queue PAYROLL.REPLY
on QM1.
Both queue managers are assumed to be running on z/OS . In the example definitions for TCP/IP, QM1 has a host address of 192.0.2.0 and is listening on port 1411, and QM2 has a host address of 192.0.2.1 and is listening on port 1412. In the definitions for LU 6.2, QM1 is listening on a symbolic luname called LUNAME1 and QM2 is listening on a symbolic luname called LUNAME2. The example assumes that these lunames are already defined on your z/OS system and available for use. To define them, see Example IBM MQ configuration for z/OS.
The object definitions that need to be created on QM1 are:- Remote queue definition, PAYROLL.QUERY
- Transmission queue definition, QM2 (default=remote queue manager name)
- Sender channel definition, QM1.TO.QM2
- Receiver channel definition, QM2.TO.QM1
- Reply-to queue definition, PAYROLL.REPLY
The object definitions that need to be created on QM2 are:
- Local queue definition, PAYROLL
- Transmission queue definition, QM1 (default=remote queue manager name)
- Sender channel definition, QM2.TO.QM1
- Receiver channel definition, QM1.TO.QM2
The example assumes that all the SYSTEM.COMMAND.* and SYSTEM.CHANNEL.* queues required to run DQM have been defined as shown in the supplied sample definitions, CSQ4INSG and CSQ4INSX.
The connection details are supplied in the CONNAME attribute of the sender channel definitions.
We can see a diagram of the arrangement in Figure 1.
- Queue manager QM1 example for z/OS
The following object definitions allow applications connected to queue manager QM1 to send request messages to a queue called PAYROLL on QM2. It also allows applications to receive replies on a queue called PAYROLL.REPLY on QM1. - Queue manager QM2 example for z/OS
The following object definitions allow applications connected to queue manager QM2 to retrieve request messages from a local queue called PAYROLL and to put replies to these request messages to a queue called PAYROLL.REPLY on queue manager QM1.
Parent topic: Message channel planning example for z/OS