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  at the top right of your screen.
2. On the Message Commands tab, click the Configure button within the Message Criteria Settings section.
   
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.
   

Create new message criteria configurations

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

 = MD:  Message Descriptor properties
 = MD1:  Message Descriptor 1 properties
 = MDE:  Message Descriptor Extension properties
 = DLH:  Dead Letter Queue properties
 = XQH:  Transmission Queue properties
 = 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  at the top right of your screen.
2. On the Message Commands tab, select a configuration from the Message Criteria drop-down menu.
   
3. The selected message criteria configuration is now applied. It will remain in effect until you change it.
   

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.
   
2. Click the Save Changes button at the bottom of the screen. Messages will not be filtered from this point forward.