Set up Message Tracker

When Activator handles and processes messages, it creates database records of message trading events and it stores a certain number of files in the backup directory. Activator users can use the Message Tracker tool in the Activator user interface to monitor database records of traded messages.

Enable document backups

To provide full use of Message Tracker, you must enable document backups. By default, document backups are enabled. If you need to enable this setting:

  1. In the Activator user interface, select Trading Configuration > Manage Trading Configuration to open the Communities page.
  2. From the list of tasks at the bottom of the page, select Configure the global backup settings to open the Global backup configuration page.
  3. Select or clear the option Message Handler backs up messages.
  4. Click Save changes.

Configure Message Tracker

To configure the general behavior and appearance of Message Tracker to Activator users:

  1. In the Activator user interface, select Message Tracker > Configure global message tracker settings to open the Global message tracker settings page.
  2. Complete the fields as required. See field descriptions below.
  3. Click Save changes.

Default menu items

The options in this section control whether system-defined default searches are available for Activator users to select under Message tracker > Message searches. If you select any of these options, the searches become available for all users. Although you can choose whether to make these available universally, you cannot change the search conditions of system-defined default searches.

  • All messages – Default search finds all messages. If the database has a large volume of records, you may want to turn off this search.
  • All messages-Last 1 Hour – Default search finds all messages traded in the last hour.
  • All messages-Last 2 Hours – Default search finds all messages traded in the last two hours.
  • All messages-Last 6 Hours – Default search finds all messages traded in the last six hours.
  • All messages-Last 24 Hours – Default search finds all messages traded in the last 24 hours.
  • Failed messages-last days – Default search finds all messages with a status of failed within a default number days. The default number of days is the value of the Number of days for default searches field on this page.
  • Negative response-last days – This default search finds all messages that received a negative response from a partner within a default number days. The default number of days is the value of the Number of days for default searches field on this page.

Query restrictions

  • Number of days for default searches – The value in this field is the number of days that appears in the search option Within the last [n] days under the date area on the custom search panel of the Message Tracker page.
  • This also is the value for a search condition on the message attributes tab of the message details page. The value applies to the option Restrict search to messages that originated within the last [n] days at the bottom of the tab.
  • Additionally, if you click Find without specifying search conditions on the Message Tracker search page, the search finds all messages traded within this number of days.
  • This field’s value also sets the number of days for the default searches Failed messages and Negative responses on the Message tracker menu on the top toolbar.
  • Maximum search results allowed to delete – The maximum number of search results users can delete with a single delete action on the Message Tracker page. For example, if more than the maximum number of search results are returned and you try to delete all results, Activator does not delete any of the messages. Instead you are prompted to define a search that returns fewer records than the maximum allowed to delete. Limiting the number of search results that can be deleted at once helps maintain database performance.
  • Default number of search results to return – The number in this field is the default value of the Maximum # of search results field on the custom search panel of the Message Tracker page.
  • Maximum number of search results to return – The number in this field is the highest allowed value of the Maximum # of search results field on the custom search panel of the Message Tracker page. If you are performing a search and enter a number in the Maximum # of search results field that is larger than this value, an error message displays.
  • Default days for before or after date searches – The number in this field is the default value for the on a maximum [n] days period field for the After and Before option under date searches on the custom search panel of the Message Tracker page.

Collect message attributes

  • Collect attributes for use in message detail pop-up windows – Select to have Activator collect attributes from traded messages. These attributes are available to display in pop-up windows accessible on the Message Tracker search results page. Enabling attribute collecting is recommended. However, if you experience slower Message Tracker performance, you may want to disable attribute collecting to determine whether this has an effect.
  • Maximum number of attributes to collect – The maximum number of attributes Activator can collect for possible use in the pop-up windows. If the number of collected attributes is at or near the maximum, you can increase the number in this field or go to the attribute page and delete some attributes to make room for new ones. To open the page select Message tracker > Select attributes for pop-up windows.

Using Message Tracker

Users who have configured message flows between exchange endpoints, and who need to monitor message exchanges, use Message Tracker to create and launch message searches in the Activator user interface.

Related Links