Viewing the status of an IBM MQ link and its sender and receiver channels

You might want to view the status of a WebSphere® MQ link or its components because you intend to stop the IBM MQ link and you want to see if there are any messages currently held on it, or you are about to delete the IBM MQ link and you have to verify there are no messages on it, or messages have not arrived at their expected destination and you want to check if they are being held, pending transmission over the IBM MQ link.

About this task

To view the status of a IBM MQ link, use the administrative console to complete the following steps.

Note: If you attempt to start a IBM MQ sender channel that is already in RUNNING state, the WebSphere Application Server administrative console might occasionally incorrectly report the channel status as INACTIVE. If this happens, you can ignore the error because the channel is still running. To return the channel status to RUNNING, stop and then restart the channel.

Procedure

  1. In the navigation pane, click one of the following paths:
    • Service integration -> Buses -> bus_name -> [Topology] Foreign bus connections -> foreign_bus_name -> [Related Items] IBM MQ links
    • Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional properties] IBM MQ links
  2. Click the IBM MQ link you want to view.
  3. Click the Runtime tab. The content pane displays the status of the IBM MQ link.
  4. Click the Configuration tab.
  5. Optional: To view the status of the sender channel:
    1. Click Sender channel.
    2. Click the channel you want to view.
    3. Click the Runtime tab. The content pane displays status information for the sender channel. Some of the more important fields to check are:
      • The status of the channel.
      • Whether the message on the channel is in an indoubt state. If the message is in doubt, it has not been acknowledged by IBM MQ.
      • The number of messages in the current batch.
      • The number of batches that have been sent.
      • The time and date at which the channel was last started.
      • The time and date at which the last message was sent.
    4. Click Saved batch status. The content pane displays the saved status of message batches that have been saved for transmission to IBM MQ.
    5. If a batch is in an indoubt state, you can either commit or rollback the batch.
  6. Optional: To view the status of the receiver channel:
    1. Return to the IBM MQ link page.
    2. Click Receiver channel.
    3. Click the Runtime tab. The content pane displays the status of the receiver channel.
    4. Click Receiver channel connections. The content pane displays the connections existing on the receiver channel, and their current status. You can stop connections if required, by selecting the check box next to the connection and clicking Stop.
    5. Return to the receiver channel page.
    6. Click Saved batch status. The content pane displays the saved status of message batches that have been received from IBM MQ.

What to do next

You can also view the status of subscriptions for a broker profile on the IBM MQ link: Viewing the status of subscriptions for an IBM MQ link publish/subscribe broker profile.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 17:27
File name: tjc0022_.html