Skip to main content
Top
Review meshIQ Products (G2.com)

Filtering messages across viewlets with message criteria configurations

Your queues handle thousands of messages. To make managing messages easier, you can create and apply a message criteria configuration to filter messages in viewlets across your management system.

When a message criteria configuration is applied, all message actions (browsing, copying, moving, rerouting, and deleting) are filtered based on the configuration. For mass actions such as Copy All, Move All, and Delete All, you can choose which message criteria configuration to apply. Message criteria that are applied to a viewlet also impact the Put New action and can be applied to messages loaded through the Load from File option.

See Locating a message across all queue managers for an example of when a message criteria configuration is used.

Jump ahead:

View existing message criteria configurations

  1. Click the Settings button located in the toolbar to open the Settings window.
    mceclip0.png
    At the User Settings level, the Message Criteria list includes the message criteria records that you (the current user) have created. To add, edit, and delete criteria records, you must have the Manage Private Message Criteria security right.
    At the Global Settings level, the Message Criteria list includes global message criteria records only. To add, edit, and delete global criteria records, you must have the Manage Global Message Criteria security right.
  2. On the Message Commands tab, under Message Criteria Settings, click Configure to open the Message Criteria window.
    mceclip4.png
  3. All existing message criteria configurations are listed below Name. (If you are accessing the Message Criteria dialog when editing a viewlet, you can view shared records by turning on the Shared Criteria slider.)
  4. Click the buttons on the top right to view details of the configuration.

Create new message criteria configurations

Example 1: Search for messages by text data

In this example, we will search for a message by looking for the account number that is within the message text.

  1. Follow steps 1-3 in the section immediately above.
  2. Click New mceclip6.png (the first button). A new blank row appears in the list.
  3. Double-click the row to enter a name for the configuration. 
    MsgCritAcct.png
  4. Click on the new configuration to select it (the row appears dark grey).
  5. Click the Message Data Criteria mceclip5.png button on the top right to specify the data to look for.
  6. Enter the data:
    MsgCritDataAcct.png 
  7. Click Save on the Message Data Criteria dialog. 
  8. Verify that the Account criteria record is selected on the Message Criteria dialog and click Save.
  9. On the Edit Viewlet dialog, make sure that the Find Messages checkbox is selected, and that the "Account" message criteria record is displayed in the Search Criteria box.
  10. Click Apply Changes. Viewlet data is refreshed.  
  11. Click the cell in the viewlet that contains the message count (for example, Current Depth or Pending Message Count).
  12. The Console panel displays the search results.  Open the message to view its data:
    MsgCritMsgFound.png

See Filter Configurations for descriptions of the buttons on the Message Criteria dialog. 

Example 2: Search for messages by put date

In this example, we will search for a message according to the date it was put on the queue.

  1. Follow steps 1-3 in the section above.
  2. Click New mceclip6.png (the first button). A new blank row appears in the list.
  3. Double-click the row to enter a name for the configuration. 
  4. Click on the new configuration to select it (the row appears dark grey).
    MsgCritDateSlct.png
  5. Click the Message Descriptor Properties mceclip0.png button on the top right to specify the data to look for.
  6. Enter the data:
    MsgCritMDPropDate.png
  7. Click Save on the Message Descriptor Properties dialog. 
  8. Verify that the Date criteria record is selected on the Message Criteria dialog and click Save.
  9. On the Edit Viewlet dialog, make sure that the Find Messages checkbox is selected, and that the "Date" message criteria record is displayed in the Search Criteria box.
  10. Click Apply Changes. Viewlet data is refreshed.  
  11. Click the cell in the viewlet that contains the message count (for example, Current Depth or Pending Message Count).
  12. The Console panel displays the search results.  Messages that meet the criteria are listed::
    MsgCritMsgbyDateRslt.png

Example 3: Search for messages by properties

To use this search method, the messages that you are searching for must contain the properties that you are searching for.  These properties are in the form of name-value pairs. 

  1. Follow steps 1-3 in the section above.
  2. Click New mceclip6.png (the first button). A new blank row appears in the list.
  3. Double-click the row to enter a name for the configuration. 
  4. Click on the new configuration to select it (the row appears dark grey).
  5. Click the Properties MsgCritProp.png button on the top right to specify the name-value pair to look for.
    MsgPropCrit.png
  6. Click Add to add a property.
  7. Enter the Name of the property and its Value. 
  8. (Optional.) Add more name-value pair criteria records by clicking Add and repeating the previous step.
  9. Click Save on the Message Properties Criteria dialog. 
  10. Verify that the criteria record you just created is selected on the Message Criteria dialog and click Save.
  11. On the Edit Viewlet dialog, make sure that the Find Messages checkbox is selected, and that your new message criteria record is displayed in the Search Criteria box.
  12. Click Apply Changes. Viewlet data is refreshed.  
  13. Click the cell in the viewlet that contains the message count (for example, Current Depth or Pending Message Count).
  14. The Console panel displays the search results.  Messages that contain the name-value pair (or pairs) that you specified are listed.

Delete message criteria configurations

  1. Open the Message Criteria dialog.  The Message Criteria dialog can be accessed from the Edit Queue Viewlet Queue tab or from the User Settings Message Commands tab Configure button.
  2. Click the configuration that you want to delete (the row appears dark grey).
  3. Click MsgCritDltBt.png. There is no delete confirmation.

Share message criteria configurations

To share criteria records with groups, you must have both the Manage Private Message Criteria and the Manage Shared Message Criteria security rights.

To share any record with one or more groups:

  1. Double-click its name. The MsgCritPriv.png  Private icon is displayed in front of the name of the record. 
  2. Click the Private icon to share the record.  The icon changes to a Shared MsgCrtSharBt.png  icon.
  3. From the popup menu, click the eye icon next to the groups you want to share the dashboard with. The eye icon changes to green GreenEye.png for selected groups.
    MsgCrtShar.png

Apply a message criteria configuration

Perform the steps below to apply a message criteria configuration. When a message criteria configuration is applied, all message actions (browsing, copying, moving, rerouting, and deleting) are filtered based on the configuration.

  1. Click the Settings button mceclip2.png in the toolbar.
  2. On the Message Commands tab, select a configuration from the Message Criteria list.
    MsgCritUsrSet.png
  3. The selected message criteria configuration is now applied. It remains in effect until you change it.

Remove message criteria configuration

If you no longer want your messages filtered, you can remove the filter configuration. 

  1. On the Message Commands tab of the Settings window, click the X next to the selected criteria record on the Message Criteria list.
    MsgCritUsrSetClr.png
  2. Click Save Changes. Messages will no longer be filtered.