How to manage the Events View.
The Events View displays events that are captured
in monitored operations, including the details of message bodies and
headers for selected events. The following describes the options that
are available for managing the way information is displayed in the
view.
Clear events
You can clear some or all
of the events in the table if it contains too many entries or if you
used all of the events that you want before you capture new events.
To clear specific events,
select them (use Ctrl or Shift to select multiple events, or click
one event and drag over the others) and click the Clear
selected events icon
in the toolbar, or right-click any of the events and select the Clear
Selected Events option.
To clear
all of the events, click the Clear all events icon in the
toolbar or right-click any of the events and select the Clear
All Events option.
Note: After you confirm
your selection, the applicable events – whether they are used
or not – will be cleared from the view.
Toggle event scrolling
As new events are captured, they are added to the bottom
of the events table. By default, the contents of the table do not
scroll when new events are added (that is, scrolling is locked). You
can toggle this behavior by clicking the Scroll Lock icon in the toolbar.
- When the icon is highlighted, scrolling is locked.
- When the icon is not highlighted, the contents
of the table scroll, showing new events at the bottom of the table
as they are added.
Show/hide used events
Once you create a test, stub, trigger, or requirement
from an event in the event table, that event is considered to be "used."
Note: Once an event is used, a green check mark is displayed
to the left of it in the event table.
By default,
all events are displayed in the table, regardless of whether they
were used. You can toggle the display of used events by clicking the Show... icon in the toolbar.
- When the icon is highlighted, all events are displayed
in the table.
- When the icon is not highlighted, events that were
used are hidden from the table view.
Search events
Clicking Edit >
Find on the menu bar or pressing CTRL+F displays a finder
panel at the bottom of lower half of the Events View window. This
enables you to search the recorded events currently displayed on the
Events View window.
If you are using
IBM® Rational® Integration Tester 8.5.0.1
or later:
- There is a Regex check box on the finder
panel, which enables you to run regular expression-based searches.
If you select the Regex check box, messages
are searched for Regex matches. If you clear the Regex check
box, messages are searched only for string matches.
Note: Regex searching
is case sensitive but normal searching is case insensitive, so, for
example, searching for literal h as a Regex
may return fewer matches than searching for the same literal without
Regex matching.
- You can use search results to create a search filter. This enables
you to progressively search within search results by applying layers
of filters. Each of these filters can be removed to show the longer
list of events again. To create a search filter, run a search query
in the finder panel that yields one or more results and click Apply
as filter on the finder panel. The number of events displayed
on the upper half of the Events View window changes and "filtered"
is displayed under the toolbar of the Events View window. To remove
the filter, right-click the column on the upper half of the Events
View window that is being filtered upon (indicated by an asterisk
(*) in the column header) and click Remove filter on
the pop-up menu.
- Search filters created across Rational Integration Tester user
interface sessions are displayed in a most recently used (MRU) list
to enable to you to move quickly between different filters that you
have previously defined in your Rational Integration Tester project.
- Search progress is displayed in the form of tooltip text when
you are searching a large number of recorded events.
Received timestamp
Use the
received time stamp in table option to list and sort the events
based on the received time stamp value. By default, the events in
the table sorts and lists the sent timestamp value.
Find message pairs
If you are using Rational Integration Tester 8.5.0.1
or later, right-clicking a recorded event on the Events View window
and clicking Jump to and Previous
correlated message or Next correlated message on
the pop-up menus enables you to select and scroll to the corresponding
message in a message pair automatically. This is useful when trying
to find a message pair in a long list of events from which to create
stubs or operations. For example, if a request is highlighted, Jump
to will jump to the corresponding reply for that request.
Note: The Jump
to option can be chosen only when one event at a time
is selected.