Some of the content described in this article is available in meshIQ Manage versions 12.1 and greater.
For a quick overview of what's new or changed, visit the meshIQ Highlights page for a version-by-version breakdown.
Jump to Section:
Version 12.x and Later
Version 11.3 and Earlier
Version 12.x and Later
To view messages in a queue, do one of the following:
- Select Browse messages from the queue’s Selected menu.
- Click a value in the the Total Messages or Available Messages columns (for Kafka topics and partitions) or Current Depth column (for IBM MQ local queues).
Jump ahead |
View Console Message "Pages"
In the Console panel, the list of messages is divided into "pages." The Message Count setting in the Browse Settings section of the User Settings Message Commands tab determines the number of messages that are displayed per page.
To load additional messages, use the previous and next
buttons located at the bottom of the Console tab, or type a page number within the Page field.
When browsing Kafka messages in a partition, it is possible to page through additional messages in the partition. When browsing messages at the topic level, paging is not supported.
View a Message
To view a message, click anywhere on the message row.
The example below shows a Kafka message. When viewing Kafka messages, the Partition ID, Offset, Key and Timestamp are displayed at the top of the dialog.
For other message types, you may be able to specify either ASCII, EBCDIC, UTF8 or Hexadecimal (Hex) for the Message ID (Msg ID) and Correlation ID (Correl ID), as shown in this IBM MQ example:
To copy or paste data, select the data, then use quick keyboard functions CTRL + C or CTRL + V, respectively.
Navigate Through Messages in Order
For any message type, use the navigation buttons ( and
) to move between messages.
As you navigate, you will see the Message ID change, indicating the current message in sequence.
View Message Headers
To view any message headers, click the plus icon located on the left side of the Message Headers Data section. This expands a table showing key-value pairs.
Example of Message Headers:
Change the Message Format or Encoding Type
Depending on its type, the message may be able to be displayed in either Hexadecimal, Text, Xml or Json format.
If the message is small enough, it is already fully loaded, and the Full Msg option is automatically enabled.
To view a large message, click the Full Message slider. When enabled, it turns green.
A prompt may appear to confirm this action—this depends on your Prompt setting under Message Commands in User Settings (specifically under Load full msg for XML/JSON).
Once you enable the Full Message option, you cannot disable it unless you close and reopen the console.
You may be able to change the message encoding type using the Encoding list (for Kafka messages, US-ASCII encoding is always used).
Address Display Format
To switch between decimal and hexadecimal mode for the address of the first byte, click anywhere in the address field.
________________________________________________________________________________________________________________
Version 11.3 and Earlier
To view messages in a queue, do one of the following:
- Select Browse messages from the queue’s Action menu (Selected menu in 11.2).
- Click a value in the the Total Messages or Available Messages columns (for Kafka topics and partitions) or Current Depth column (for IBM MQ local queues).
Jump ahead |
View console message "pages"
In the console panel, the list of messages is divided into "pages." The Message Count setting in the Browse settings section of the User Settings Message Commands tab determines the number of messages that are displayed per page. To load additional messages, use the previous and next
buttons located at the bottom of the viewlet, or type a page number within the Page field.
When browsing Kafka messages in a partition, it is possible to page through additional messages in the partition. When browsing messages at the topic level, paging is not supported.
View a message
To view a message, click anywhere on the message row.
The example below shows a Kafka message. When viewing Kafka messages, the Partition ID, Offset, and Key are displayed at the top of the dialog.
For other message types, you may be able to specify either ASCII, EBCDIC, or Hexadecimal (Hex) for the Message ID (Msg ID) and Correlation ID (Correl ID), as shown in this IBM MQ example:.
To copy or paste data, select the data, then use quick keyboard functions CTRL + C or CTRL + V, respectively.
Navigate through messages in order
For any message type, to navigate between messages, use the navigation buttons, and
.
View message headers
Click the Message Headers Data button to view any message headers as a table of key and value pairs.
Example of message headers:
Change the message format or encoding type
Depending on its type, the message may be able to be displayed in either hexadecimal, text, XML or JSON format. Select one of these formats or check the Text only check box to easily toggle between text and the other modes.
To view the entire message, click the Full Msg button. A prompt may be displayed to confirm this action. (Whether you receive a prompt depends on your Prompt selection on the Message Commands tab in User Settings (under Load full msg. for XML/JSON).
You may be able to change the message encoding type using the Encoding list (for Kafka messages, US-ASCII encoding is always used).
In versions 11 and later, the UTF-8 encoding format (CCSID [coded character set identifier] 1208) is available for selection. Supported actions include viewing messages and editing messages, loading messages from a file, and putting messages to a queue.
To switch between decimal and hexadecimal mode for the address of the first byte, click anywhere in the address field.