Using Message Tracking

eXchange provides a special feature, Message Tracking, allowing you to monitor the status of messages as they are received and processed through eXchange and ebXML Protocol Manager.

Before You Begin

• You must already have activated a project whose Connectivity Map contains one or more instances of the eXchange Tracker_Application.

• Your Oracle system for eXchange must already be running, and you must already have begun running a Logical Host before you can run this project.

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

Accessing Message Tracking

This section explains how to access an instance of Message Tracking.

To access Message Tracking

1. Start a new browser session (that is, do not clone a window of an existing session).

2. Point your browser at the following URL:

   http://<loghostname>:<port>/<appname>/msgTrack/EnterPkgTrack.do

   Where:

   • loghostname: The host name or IP address of a Logical Host running your Project, that is, the current Logical Host.

   • port: is The Web server connector port configured in your Integration Server. To discover this information, use Environment Explorer to open the current Logical Host. Right-click the Integration Server and select Properties. Open IS 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.

     The default port-number value is 18004 for the first Integration Server in the first-created Logical Host (or 19004 for the first Integration Server in the second-created Logical Host, and so on).

   • appname: The name of the Message Tracking instance as it appears on the current Connectivity Map.

Example 5–1 Message Tracking Initial Window, on Startup

Example: To access Message Tracking for the ebXML Protocol Manager sample scenario, use the following URL:

http://localhost:18004/mtrk1/

As stated previously, the sample must be running before you access Message Tracking, and messages must have been passed before any become accessible. When you first run Message Tracking, its initial window appears.

Message Tracking Operation

This section explains how to use the Message Tracking feature.

To search by B2B host, TP, and protocol

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

2. Under Trading Partner, either click ALL or choose a particular TP 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 previous ten tracked messages fitting the criteria you specified. Navigation links (Previous, Next, and Go to Page) allow you to view other pages of ten results each.

To search by B2B host, protocol, and Package ID

1. Under Search Criteria, use the current B2B host’s drop-down menu to choose the B2B host whose messages you want to examine, and click GO.

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

3. Under Package Type (to search by Package ID) either click ALL or choose a particular packaging protocol from the drop-down list. Perform the next steps:

   1. Under ID, enter a string for matching the message ID.

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

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

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

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

To Specify Additional Search Criteria

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

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

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

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

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

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

   On a package-by-package basis, you can also view the message text. After you view the text in a new window, you can preform cut, copy, and paste operations on any text in the window.

To obtain details of a specified package

1. After obtaining results from a search, using any of the procedures provided earlier, click the Package ID name for any of the returned results.

2. In the Details for package <package-ID> pane, click Open to view the contents of the current message in a new window.

   ---

   Note –

   Keep in mind that the current message could be encrypted, depending on your selection for the encryption parameters in the ePM configuration.

   ---