Some of the content described in this article is available in meshIQ Manage versions 12.1 and later.
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

Easily search all of your queues and systems for a specific message. You can find messages containing specific data and header informational, limiting the number of messages returned.

Step 1: Create Message Criteria Configurations

To find messages containing specific data, a message criteria configuration will need to be used. These are configurations created by you to filter messages. Please see Message criteria configurations for more information and instructions on how to create new configurations. 

Step 2: Set Filter Specifications

1. Click the widget menu located at the top right of the queue widget and select Edit Widget from the pop-up menu.
   
2. The Edit Widget dialog opens.
   • Enable the Find Messages checkbox. 
   • Click the Manage message criteria button next to the Message Criteria field.
     
3. The Message Criteria dialog opens. Select a message criteria (configured in Step 1 above), then click Save.
   
4. You will return to the Edit Widget dialog.
   – If desired, enter a value in the Search Depth field to define how many messages to search.

5. To completely disable message filtering, clear the Find Message checkbox.

6. Click Update.
   The widget will now display only queues that contain messages matching the specified filter options.
   Click a queue to view the found message(s) in the Console panel. From there, you can click a message to view its details.
   

_________________________________________________________________________________________________________________

Version 11.3 and Earlier

Easily search all of your queues and systems for a specific message. You can find messages containing specific data and header informational, limiting the number of messages returned.

Step 1:  Create message search criteria configurations

To find messages containing specific data, a message criteria configuration will need to be used. These are configurations created by you to filter messages. Please see Message criteria configurations for more information and instructions on how to create new configurations. 

Step 2:  Set filter specifications

1. Click the down arrow located at the top right of the queue viewlet and select Edit viewlet from the pop-up menu.
   
2. The Edit Queue * viewlet window opens.
   • Enable the Find messages checkbox.
   • Click the ellipses button next to the Search Criteria field.
     
3. The Message Criteria window opens. In it, you can select a search criteria configuration (created in Step 1 above). Select a configuration to use and click Ok.
   
4. You are now back on the Edit Queue * viewlet window. If desired, enter an amount within the Search depth field to search for a specific message depth amount. To turn off the data message filter, but still filter by message depth, simply click the X to the right of the Search Criteria field. To completely disable message filtering, clear the Find messages checkbox.
   
5. Click Apply changes. 
   
   The viewlet will now display only queues containing messages that satisfy the filter options specified. Click a queue to view the found message(s) within the Console panel. From the Console panel, you can click a message to view its details.