12.7 Searching for Message Instances

You can search for specific message instances by specifying search criteria in the Search panel.

The search criteria are listed in Table 12-1.

Table 12-1 Specifying Message Instance Search Criteria

Search Criteria	Description
Instance ID	To limit the messages to those with a specific instance ID: If they are not already displaying, open the Advanced options by clicking the expand icon. (The plus (+) box next to Basic in the Instances panel.) In the Instance ID field, enter the ID of the desired message instance.
Activity in last < time frame>	To limit the messages to processed in a specific timeframe: If they are not already displaying, open the Advanced options by clicking the expand icon. (The plus (+) box next to Basic in the Instances panel.) From the drop-down list next to the Activity in last field, select a time period. In the Activity in last field, select the number of time periods specified in step 2 that you want to include. Be aware that message instances for a given timeframe may not be available if messages have been purged, as described in Section 12.8.2, "How to Purge Message Instances".
Service	To limit the messages to those processed by a particular service: To the right of the Service field, click the Service Browser icon. A dialog box opens. Navigate to the ESB system that contains the service of interest. Select the service of interest. Click Select.
Status	To limit the messages to those in a particular status, in the Status field, select one of the following: Error – Select this option to limit the message instances to those for which an error occurred in processing. Faulted – Select this option to limit the message instances to those for which a fault, as defined by the service WSDL, occurred. Processing – Select this option to limit the message instances to those which are still being processed. Completed – Select this option to limit the message instances to those for which processing across the enterprise service bus has successfully completed.
Match	Specify whether to match any or all of the criteria in the Tracking Name and Value fields.
Tracking Name and Tracking Value (trackable fields)	To limit the messages to those which have a particular value in a trackable field or fields: Replace <Tracking Name> with the name of a previously defined trackable field. See Section 12.9.1, "How to Define Trackable Fields" for instructions on defining trackable fields. Select a logical operator from the dropdown list. Replace <Tracking Value> with the value for the trackable field. If you want to specify multiple trackable field/value pairs, click the plus (+) button, and then repeat steps 1 and 2 for each additional pair. In the Match field, select Any if you want a message instance listed if it matches one or more of the listed tracking field/tracking value pairs specified; select All if you want only messages listed that match all of the listed tracking field/tracking value pairs. If you want to delete a trackable field/tracking value pair, click the minus (-) button that appears next to that row.

12.7.1 How to Search for Message Instances

If the Instances panel contains so many message instances that is difficult to quickly find the message instances of interest, you can search the messages with specific criteria.

To search for message instances:

1. At the top of Oracle ESB Control, click the Instances button if the Instances view is not currently displaying.

2. Open the Search panel, if it is not already open.

3. Specify the desired search criteria in the Search panel, as described in Table 12-1.

4. In the Search panel title bar, click the Apply icon (green arrow).

   All the message instances display for the criteria specified.