Skip to main content
Top

Filtering messages with message criteria configurations

Message criteria configurations are used to filter messages containing specific data on your queue managers. They are created by you and are saved for easy retrieval for future use. When a message criteria configuration is applied, all message actions performed (browsing, copying, moving re-routing and deleting) will be filtered based on the configuration.

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

View existing message criteria configurations

  1. Click the Settings button mceclip2.png at the top right of your screen.
  2. On the Message Commands tab, click the Configure button within the Message Criteria Settings section.
    mceclip4.png
  3. The Message Criteria screen opens. All existing message criteria configurations are listed below Name. In the example below, Count is an existing configuration. Click the buttons on the top right to view details of the configuration.
    mceclip5.png

Create new message criteria configurations

  1. Follow steps 1-3 in the section immediately above.
  2. Click the New button mceclip6.png (the first button).
  3. Double click in the designated area and key in a name for the new configuration.
    mceclip8.png
  4. Click on the new configuration created. Using the buttons on the top-right of the window, customize the new configuration. 
    mceclip8.png

mceclip0.png = MD:  Message Descriptor properties
mceclip1.png = MD1:  Message Descriptor 1 properties
mceclip2.png = MDE:  Message Descriptor Extension properties
mceclip3.png = DLH:  Dead Letter Queue properties
mceclip4.png = XQH:  Transmission Queue properties
mceclip5.png = Data:  Message data criteria

Apply a message criteria configuration

Perform the below steps to apply a message criteria configuration. When applied, all message actions (browsing, copying, moving re-routing and deleting) will be filtered based on the selected configuration.

  1. Click the Settings button mceclip2.png at the top right of your screen.
  2. On the Message Commands tab, select a configuration from the Message Criteria drop-down menu.
    mceclip0.png
  3. The selected message criteria configuration is now applied. It will remain in effect until you change it.
    mceclip1.png

Remove message criteria configuration

Perform the following if you no longer want your messages filtered: 

  1. On the Message Commands tab of the Settings window, select the blank row from the Message Criteria drop-down menu.
    mceclip3.png
  2. Click the Save Changes button at the bottom of the screen. Messages will not be filtered from this point forward. 

Related articles