Canceling or Killing a Thread

Integration Server 10.3 | Integration Server Administrator's Guide | Managing Services | Canceling and Killing Threads Associated with a Service | Canceling or Killing a Thread

Before canceling or killing a thread, keep the following information in mind:

If you want to be able to cancel or kill threads, the watt.server.threadKill.enabled parameter must be set to true, which is the default setting.

Integration Server requires you to try canceling a thread before it will allow you to kill a thread.

You cannot cancel or kill threads when a JDBC connection is waiting on a response from the database.

You cannot cancel or kill threads when an underlying service is waiting on a blocking IO. Examples of blocking IO are:

A service waiting on a response from an HTTP request.

A service waiting on a response from an FTP request.

A service waiting on receiving data from read/write requests on a file or socket.

You can cancel or kill threads for user-written Java or flow services only.

You cannot cancel or kill threads for Integration Server system services.

CAUTION:
Use care when canceling or killing threads. Canceling a thread might not free up resources being held by the service. Killing a thread might put your resources in an unstable state.

To cancel or kill a thread associated with a service

1. Open Integration Server Administrator if it is not already open.

2. From the Server menu in the Navigation panel, click Statistics.

3. In the System Threads field, in the Current column, click the number of current threads.

Integration Server displays the System Threads screen.

4. To make it easier to locate threads that can be canceled, select the Show threads that can be canceled or killed at the top of the list check box.

Integration Server dynamically updates the display to show threads that can be canceled ( yellow check mark icon

in the Cancel column) or killed ( delete icon

in the Killed column) at the top of the screen.

5. To display information about a thread, in the Name column for that thread, click the thread name.

The server displays a dump of that thread. Using the information provided in the thread dump, determine whether you want to cancel the thread.

To return to the System Threads screen, click Return to System Threads.

6. In the row for the thread you want to cancel, click the yellow check mark icon

in the Cancel column.

Integration Server prompts you to confirm your action.

If the cancel is successful...	Integration Server removes the thread from the display.
If the cancel is not successful...	Integration Server updates the display to show an in the Kill column. If you want to kill the thread, click the . Integration Server prompts you to confirm your action. If Integration Server is able to kill the thread, it removes the thread from the display. If Integration Server is not able to kill the thread, the thread remains in the display.