Menu Path : Find Messages>Route Search

Read Access Rights:

  • Log in to Management Console
  • View locker
  • Search message queues

Write Access Rights:

  • Save searches
  • Redirect messages
  • Reinject messages
  • Download messages
  • Perform bulk operations

  • Perform full text searches

The Route Search page finds intermediate messages within Rhapsody at the point they are received by each route that processed them:

Search results will only contain messages that match your search criteria and were received on input communication points in lockers where you have the 'Search message queues' access right.

Generating Search Results

You can use the following search criteria to filter your search:

Field

Description

Timeframe

Select From / To or Show Last to display messages within a certain time period.

If From / To is selected:

  • In the From field, enter the date and time to start the search from (set to one hour before the current time by default).
  • In the To field, enter the date and time to end the search at.

If Show Last is selected, enter the preceding time period that you want to search. Either select mins, hours, days, weeks or months from the drop-down list, or click on one of the time links (10min, 1h, 24h).

Search Order

Sorts search results by time in either Ascending or Descending order.

Routes

Show only messages that passed through the routes you have selected.

In the Select Components dialog, you can filter the component list based on the component names using a regular expression. The Management Console supports Java Regex. The following characters, which are allowed in component names, must be prepended with a backslash in order to be used as special characters in the regular expression: "." (period), "+" (plus), "(" (open parenthesis), ")" (close parenthesis), "^" (caret).

Received By

Show only messages that were received by the input communication points you have selected.

In the Select Components dialog, you can filter the component list based on the component names using a regular expression. The Management Console supports Java Regex. The following characters, which are allowed in component names, must be prepended with a backslash in order to be used as special characters in the regular expression: "." (period), "+" (plus), "(" (open parenthesis), ")" (close parenthesis), "^" (caret).

Input Time

Select From / To or Show Last to display messages that arrived at Rhapsody within a certain time period.

If From / To is selected:

  • In the From field, enter the date and time to start the search from (set to one hour before the current time by default).
  • In the To field, enter the date and time to end the search at.

If Show Last is selected, enter the preceding time period that you want to search. Either select mins, hours, days, weeks or months from the drop-down list, or click on one of the time links (10min, 1h, 24h).

Message Contains

Search for a text string. Enter your expression and then select either Case-Sensitive, Ignore Case or Regular Expression (the Management Console supports Java Regex).

Caution should be exercised when using the Message Contains search option. This is a full-text search which results in a search over the entire set of stored messages. The time taken to perform a search is proportional to the number of stored messages. To ensure fast searches, filter your search by specifying the communication point on which the message was received or by specifying the date range in which the message was received.

Access to this search criterion is controlled by the 'Perform full text searches' access right.

You can perform the following actions to search messages in a route:

Action Description
Search

Click the Search button to initiate a search.

Your recent searches can be retrieved from the Recent Results page.
Reset

Click the Reset link to discard your search criteria.
Reload

Click the Reload link to reload a search query.
Save

Select the Save icon to save your search. You can view and manage your saved searches from the Saved Searches page.
Select Saved Search

Select a saved search (if one is available) from the Select Saved Search drop-down list.
Search Options

Click the Search Options link to select or deselect optional search criteria in the Search Options drop-down list.

Indexed message properties appear as selectable options in Search Options to allow for fast lookups against pre-configured properties.

Performing a search using indexed message properties that takes a long time may reduce the performance of output communication points on routes with indexed message properties.
Show/Hide Click the Show or Hide link to show or hide the optional search fields.

Viewing Search Results

Search results are displayed as a list of search entries in a table with the following columns:

  • Time
  • Route
  • Input Time
  • Received By
  • Locker
  • Next Destination
  • Message Identifier

Managing Search Results

You can perform the following action to manage your search results:

Action

Description

Save Search

Select the icon to save the search criteria so you can easily re-run a search. To save the search result, enter a name for your saved search in the input text field and select the icon. The saved search can then be selected from the Select Saved Search drop-down list or the Saved Searches page.
Quick Filter

Click the Quick Filter link to display the Filtering Bar to filter the search results.
Configure Columns

Select the Configure icon to configure the columns for the table.

Filtering Search Results

To filter the search table using text criteria on a per column basis on the displayed page:

  1. Click the Quick Filter link to display the Filtering Bar:


  2. Enter your filtering term in the Filtering Bar field for the column you wish to filter the search results against.
  3. Press the Enter key to filter the search results, or select  to cancel the filtering and close the Filtering Bar.

Only the page currently displayed is filtered.

Configuring Columns

To configure which columns to display in the search table, select the Add icon  to display the Display Column dialog:

  • Select the columns you want to be displayed in the search table.
  • Deselect the columns you want to be hidden in the search table.

Fields that are greyed out are required fields, and cannot be hidden.

Sorting by Column

To sort a table by column (only the page currently displayed is sorted):

  • Click the column's heading name.
  • Re-click the column's heading name to toggle between ascending and descending order, denoted by theandicons, respectively.

Viewing Search Entry Details

Click any entry in the results list to display the Message View page (or Ctrl-click to display the page in a new tab).

Managing Search Entries

You can perform the following actions to manage messages in the search results:

Action

Description

Reinject

Select one or more messages, and click the Reinject button to reinject the message into the Rhapsody engine at its original point of entry.

Redirect Copy

Select one or more messages, and click the Redirect Copy button to redirect a copy of the message to a filter or communication point. You are prompted to select the component to which you want to redirect the message.

Download

Select one or more messages, and click the Download button to download the messages as a compressed file.

Alternatively, to download all the messages in the search, click the Download All link.

All message actions require respective user access rights, which must be set for the locker containing the message.

You cannot perform a Reinject, Redirect Copy, or Download action on messages that have no message body (as a result of being stored in the Secondary Body Store and deleted by Archive Cleanup).