Skip to main content

If you don't have an IBM ID and password, register here.

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. This profile includes the first name, last name, and display name you identified when you registered with developerWorks. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

IBM WebSphere Application Server Utilities Hung Thread Interrupter

Summary:  The IBM WebSphere Application Server Utilities Hung Thread Interrupter (HTI) allows a user to interrupt a hung thread automatically or manually. The HTI is written in Java and can be used with the WebSphere Application Server V6.1 or V7.0. The HTI runs with the WebSphere Application Server for Microsoft Windows, Linux, IBM AIX, and IBM z/OS.

Date:  27 Jan 2011 (Published 15 Jan 2011)
Level:  Intermediate

Comments:  

The IBM® WebSphere® Application Server Utilities Hung Thread Interrupter (HTI) allows a user to interrupt a hung thread automatically or manually. The HTI is written in Java™ and can be used with the WebSphere Application Server V6.1 or V7.0. The HTI runs with the WebSphere Application Server for Microsoft Windows, Linux, IBM AIX, and IBM z/OS.

Overview of the IBM WebSphere Application Server Utilities Hung Thread Interrupter

Java does not provide a general mechanism to forcibly interrupt threads. The HTI improves availability of WebSphere Application Server by supporting the termination of individual hung threads without restarting the entire Java virtual machine.

To use the HTI, install the HTI into WebSphere Application Server and specify the name of the target application. The HTI applies bytecode instrumentation to the specified application, so that you can interrupt a hung thread if the hung thread is executing within the specified application.

The HTI targets hanging scenarios such as an external server wait, an infinite loop, or a deadlock. To cover these scenarios, the HTI makes the following three primitive operations in Java interruptible:

  • A socket wait
  • A loop
  • A monitor enter

The HTI can be also used by the Thread Hang Recovery (THR) utility of WebSphere Application Server for z/OS V7.0. THR tries to interrupt a hung thread if a request via IIOP, HTTP, MDB, or some other source has timed out. When the HTI is installed, THR can also use the HTI to interrupt a hung thread.

For additional information, see the User's Guide.

Prerequisites

The HTI can be used with the WebSphere Application Server V6.1 or V7.0. It requires ASM 3.1 or higher for its bytecode instrumentation. The ASM can be downloaded from the ASM website of the OW2 Consortium.

Installation

After you downloaded the HTI archive and the ASM, you can install it as follows:

  1. Create an installation directory and make that directory the current working directory.
  2. Extract the HTI archive into the installation directory.
  3. Save the ASM file into the sub-directory jars using the name asm-all.jar.
  4. Start the target server.
  5. Run the installation script:
    $WAS_HOME/bin/wsadmin.sh -lang jython -f jython/install.jy nodeName serverName

  6. Restart the target server.

Related products and resources

Forum

We are eager to hear your comments about this technology. We encourage you to post them on this forum.


Download

DescriptionNameSizeDownload method
Hung Thread Interrupter downloadhti.zip158 KBHTTP

Information about download methods


Comments



Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=WebSphere
ArticleID=607539
SummaryTitle=IBM WebSphere Application Server Utilities Hung Thread Interrupter
publish-date=01272011