Message Tracker

Included with eXchange Integrator is a special application named Tracker. After it is connected to an Oracle database and deployed to a domain, it keeps track of all messages sent and received. The corresponding Web-based tool is named Message Tracker. It allows you to monitor the status of messages as they are received and processed through the B2B Suite.

This section explains how to access and use Message Tracker.

Accessing Message Tracker

To access Message Tracker

Before You Begin

• Your domain (Logical Host) must already be running, as well as your Oracle and LDAP external systems.

• You must already have deployed the appropriate Projects.

• For Message Tracker to be useful, there must be one or more messages that have already been picked up by the current domain’s Integration Server.

1. Start a browser session.

2. Point your browser at the following URL:

   http://logicalhost:port+1/objname

   Where:

   • logicalhost is the hostname or IP address of the machine where your Project is deployed; the machine name of the Logical Host.

   • port+1 is the port number, typically 18001, 19001, 28001, or the like. The Web server connector port configured in your Integration Server. To discover this information: In Environment Explorer, right-click the current Logical Host and view its properties. Open Configuration ⇒ Sections⇒Web Container⇒Web Server⇒Default Web Server; port is the value set for Connector Port. If you have several Web server configurations, check them also.

   • objname is the name of the Message Tracker instance as it appears on the Connectivity Map. By default, the name that appears in cmTracker is tracker.

   Example: To access Message Tracker for a typical scenario, use the following URL:

   http://localhost:18001/tracker/msgTrack/

Using Message Tracker

When you first run Message Tracker, the Message Tracker window appears, with no data. The controls in the left pane allow you to search and filter data. As messages are found that meet the search criteria, results are populated in the right pane. See Figure 5–35.

Figure 5–35 Message Tracker Window

To search by B2B Host, trading partner, and protocol

1. Under Search Criteria, use the Host drop-down list to choose the B2B Host whose messages you want to examine, and then click GO.

2. Under Trading Partner, either click ALL or choose a particular trading partner from the drop-down list.

3. Under Protocols, either click ALL or choose a protocol from the drop-down list.

4. At the lower left of the window, click SEARCH.

   The canvas (right side), under Search Results, displays a page containing the Package IDs of the latest ten tracked messages fitting the criteria you specified. The navigation links (Previous, Next, and Go to Page) allow you to see other pages of ten results each.

To search by B2B host, trading partner, and protocol

1. Under Search Criteria, use the Host drop-down list to choose the B2B host whose messages you want to examine, and then click GO.

2. For Protocols, either click ALL or choose a particular protocol from the list.

3. For Package Type, either click ALL or choose a particular packaging protocol from the drop-down list.

4. For ID, enter a string for matching the message ID.

5. At the lower left of the window, click SEARCH.

   The canvas displays a page containing the Package IDs of the latest ten tracked messages fitting the criteria you specified.

To filter results by error type, direction, and/or date

After performing a search, or after setting up a search using either of the two previous procedures, you can specify one or more further criteria.

1. Near the bottom of the left pane, under Filters, specify one or more of the following:

   • For Error Type: If you do not choose ALL, you can restrict your search either to display error messages only, or to display non-error messages only.

   • For Direction: If you do not choose ALL, you can restrict your search either to display inbound messages only, or to display outbound messages only.

   • For Date: You can choose to include only those messages whose processing date lies within a range you specify, or only those messages whose acknowledgment date lies within the range.

2. At the lower left of the window, click SEARCH.

   The canvas displays a page containing the Package IDs of the latest ten tracked messages fitting the criteria you specified.

To obtain details of a specified package

On a package-by-package basis, you can examine the message text.

1. After obtaining results from a search using any of the procedures mentioned earlier, click the package ID for any of the returned results.

2. In the “Details for package package-ID” pane, click Open to see the contents (possibly encrypted) of the original message.

   The text is displayed. You can use cut/copy/paste on any text in the window.