Skip Headers
Oracle Business Transaction Management Online Help

Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
PDF · Mobi · ePub

Viewing Logged Messages and Properties

You can use the Message Log tab for a transaction to view the following information:

Business Transaction Management logs message content or instance and property values only if you have done the following:

Logged information is stored according to storage settings that you define when you create the transaction.

This section explains how you view information about messages, search message logs for messages, and enable or disable logging.

Viewing Information About Logged Messages and Properties

The Message Log tab for a given transaction displays information using a grid view that displays a list of messages, showing the arrival time of the request message, the service that includes the selected operation, the location of the endpoint that implements the service, the operation (message), and the type of operation. If there are any properties associated with the operation, their values are shown in additional columns whose title is the property name.

If you have message content logging enabled, double clicking on any message shows you the contents of the message.

The set of messages shown in the grid varies depending on the setting of the filters shown at the top of the tab. These allow you to see

  • All operations or specific operations chosen from a drop down list

  • Any response, only successful operations, only failures

  • Messages that arrived within a time interval denoted by the last specified time period, since a certain time, or between two given times.

You can use these controls to narrow the selection of messages shown in the grid. After you change filter settings, click Search again to repopulate the grid.

You can further narrow your search by using the Message Search tool accessed from the Choose Content... link. This allows you to search for messages based on their property values or, if message content is enabled, based on message content. This tool is described in the next section.

Using the Message Log Search Tool

The Message Log Search tool enables you to further refine the scope of your search (in addition to the strictures defined by the view filters). You can access this tool in one of two ways:

  • To find messages belonging to any monitored transaction (for which logging is enabled), choose Search Message Log from the View menu.

  • To find messages belonging to the currently selected transaction, click the Choose Content... link from the Message Log tab of the transaction.

The tool has two main areas you can use to define search criteria: an area labeled Message property search and one labeled Free text search. You use controls in these areas to search for a set of messages based on a property value and/or on text content. As you enter property and free-text values, a search expression is constructed in the text box. To clear the box and start over, press the Clear button.

For additional information about using Oracle query language to formulate your query, look at the following:

When you are done defining the expression to be used in the search, click the OK button. Then click the Search button to repopulate the grid according to your newly defined search criteria.

Property-Based Search

The properties that have been defined for the transactions in question are shown in the Message property search area. Use the drop-down lists to specify your property-based search criteria.

  • For a numeric value, the drop down list allows you to search for messages whose properties are less than, equal to, greater than, not equal to, and so on.

  • For a string value, the drop-down list provides a similar set of matching options.

Free Text Search

To use this search option, you must have enabled message content logging.

Enter a string you want to search for in the box labeled Message contains the text. Do not enclose the string in quotation marks unless you're looking for a string enclosed in quotation marks.

Enabling and Disabling Message Logging and Instance Logging

Do the following to enable or disable message logging and instance logging:

  1. Select the transaction of interest.

  2. Select Modify > Edit TransactionName.

  3. In the ensuing dialog, select the Logging tab.

  4. Use the check boxes shown to enable or disable message content logging and instance logging.

  5. If enabling message logging, select the specific operations you want to log.