Monitoring a Business Process Thread

You can monitor the threads related to business processes in Sterling B2B Integrator by using the Thread Monitor.

A thread is a basic unit of program execution. Threads perform the actual work in a process. A process can have several threads working concurrently, for example, transferring a file to one node using FTP, and to another node using HTTP. The Activity Engine is that part of a business process workflow engine (WFE) that calls the business process service, takes the results from the service, and immediately starts the next business process service cycle.

The Thread Monitor lists all the threads that are currently running in the Activity Engine. This information is useful for troubleshooting business processes that have either stopped or are hanging. You can also stop a thread from the Thread Monitor.
Note: Whenever possible, stop business processes using the options provided in the Business Process Monitor. These options allow you to maintain the state and the status information.

Monitoring a Thread

To monitor threads, from the Administration menu, select Operations > Thread Monitor. Sterling B2B Integrator displays the following information for each thread:
  • The state of the thread.
  • The ID of the thread. (Click the ID number for more information about the thread.)
  • The type of the thread:
    • Business Process – Click the ID number in the ID column to display the Business Process Detail page.
    • RMI (Remote Management Interface) – Click the ID number in the ID column to display the Business Process Detail page.
    • Harness – Click the ID number in the ID column to display the Business Process Detail page.
    • Schedule – Click the ID number in the ID column to display the Schedule settings.
  • The processing priority assigned to the thread
  • The date and time at which the thread was registered
Note: You can also view thread details from the System Troubleshooting screen (Operations > System > Troubleshooter).

Interrupting a Thread

Important: Before using the Thread Monitor to interrupt a thread, contact IBM® Customer Support for assistance. Else, unexpected processing results may occur, which may in turn affect other processes. It is recommended that you interrupt the business processes from the Business Process Monitor.

To interrupt a thread, click the Interrupt icon adjacent that thread. This instructs the thread to immediately interrupt processing without waiting for any steps to complete or exit with an error. In most cases, the thread will be interrupted immediately, but the display in the Thread Monitor will not be changed immediately. The thread will be marked as interrupted later.

Note: In some situations, it may not be possible to interrupt a thread, and your attempt may not succeed. Interrupting a thread does not stop the service the thread is using. The service is still available for Sterling B2B Integrator to use in other business processes.

Stopping a Thread

Important: Before using the Thread Monitor to interrupt a thread, contact IBM Customer Support for assistance. Else, unexpected processing results may occur, which may in turn affect other processes. It is recommended that you interrupt the business processes from the Business Process Monitor.
To stop a thread, click Stop icon adjacent to the thread that is to be stopped. This instructs the thread to immediately stop processing without waiting for any steps to complete or exit with an error. In most cases, the thread will stop immediately. However, this will not immediately change the display in the Thread Monitor. The thread will eventually be marked as interrupted.
Note: In some cases, it is not possible to stop a thread, and your attempt will be unsuccessful. Stopping a thread does not stop the service that is performing that thread. The service is still available for Sterling B2B Integrator to use in other business processes.

Setting the Refresh Option for the Thread Monitor

By default, the Thread Monitor is set to automatically refresh every 15 seconds. To turn this option off, clear the Automatically refresh every 15 seconds check box.