Examining messages before publication
Because agents can connect to WebSphere® MQ Version 6 queue managers, agents do not use the direct publication approach introduced in WebSphere MQ Version 7. Instead, agents send ordinary messages to the coordination queue manager that contain an MQRFH header. The MQRFH header requests that the message's payload is published. These messages are sent to the SYSTEM.FTE queue on the coordination queue manager, and the messages are typically published immediately from that queue. If error conditions stop this publication, you can examine the messages on the queue before publication is attempted to help with diagnosis. You can do this by completing these following steps:
1. Disable the publish/subscribe engine in the coordination queue manager
You can either complete this step using the WebSphere MQ Explorer or using MQSC commands. Be aware that this temporarily stops all publish/subscribe activity on the queue manager, including activity unrelated to WebSphere MQ File Transfer Edition if your coordination queue manager is also used for other purposes.
WebSphere MQ Explorer:
- In the Navigator view, right-click the coordination queue manager in the Content pane and select Properties.
- From the left pane, select Publish/Subscribe.
- Select Compatibility from the Publish/Subscribe mode list.
ALTER QMGR PSMODE(COMPAT)
2. Send another message
Perform the WebSphere MQ File Transfer Edition action that has publication problems. For example, for agent registration, a message is sent whenever the agent is started (you do not need to repeatedly delete and create the agent to generate registration messages). Because the publish/subscribe engine is disabled, no publication takes place.
3. Browse the SYSTEM.FTE queue on the coordination queue manager
You are recommended to use the WebSphere MQ Explorer to browse your coordination queue manager's SYSTEM.FTE queue.
WebSphere MQ Explorer:
- In the Navigator view, expand the coordination queue manager and click Queues. In the Content view, right-click the SYSTEM.FTE queue and select Browse Messages. The Message browser window opens and shows the messages that would have been published.
- The User identifier column shows the user ID contained in the message descriptor. A common reason for publication failure is that this user ID does not have publish authorization on the SYSTEM.FTE topic.
- You can find out more information about each message (including the XML that will be published) by right-clicking the message and selecting Properties.
A RTM MQ24
A USR HUGHSON
A ACC 1A0FD4D8F2F4C3C8C9D5F1F9C6F7C1C3F3F00019F7AC30000000000000000000
The
second line in the above example is the message descriptor user ID
for that message.4. Re-enable the coordination queue manager publish/subscribe engine
You can either complete this step using the WebSphere MQ Explorer or using MQSC commands. After you have re-enabled the publish/subscribe engine in the coordination queue manager, any messages on the SYSTEM.FTE queue are processed immediately.
WebSphere MQ Explorer:
- In the Navigator view, right-click the coordination queue manager in the Content pane and select Properties.
- From the left pane, select Publish/Subscribe.
- Select Enabled from the Publish/Subscribe mode list.
ALTER QMGR PSMODE(ENABLED)