An application connects to a local queue manager and then issues an MQOPEN call. In the open call, the queue name specified is that of a remote queue definition on the local queue manager. The remote queue definition supplies the names of the target queue, the target queue manager, and optionally, a transmission queue. To put a message on the remote queue, the application issues an MQPUT call, specifying the handle returned from the MQOPEN call. The queue manager uses the remote queue name and the remote queue manager name in a transmission header at the start of the message. This information is used to route the message to its correct destination in the network.
As administrator, you can control the destination of the message by altering the remote queue definition.
An application needs to put a message on a queue owned by a remote queue manager.
The application connects to a queue manager, for example, saturn.queue.manager. The target queue is owned by another queue manager.
On the MQOPEN call, the application specifies these fields:
Field value | Description |
---|---|
ObjectName
CYAN.REMOTE.QUEUE |
Specifies the local name of the remote queue object. This defines the target queue and the target queue manager. |
ObjectType
(Queue) |
Identifies this object as a queue. |
ObjectQmgrName
Blank or saturn.queue.manager |
This field is optional.
If blank, the name of the local queue manager is assumed. (This is the queue manager on which the remote queue definition exists.) |
After this, the application issues an MQPUT call to put a message onto this queue.
On the local queue manager, you can create a local definition of a remote queue using the following MQSC commands:
DEFINE QREMOTE (CYAN.REMOTE.QUEUE) + DESCR ('Queue for auto insurance requests from the branches') + RNAME (AUTOMOBILE.INSURANCE.QUOTE.QUEUE) + RQMNAME (jupiter.queue.manager) + XMITQ (INQUOTE.XMIT.QUEUE)
where:
In either case, the appropriate transmission queue must be defined as a local queue with a Usage attribute specifying that it is a transmission queue (USAGE(XMITQ) in MQSC commands).
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
amqzag0660 |