Preparing to write an analyzer

You do not need any special setup in order to write an anlysis module, just access to the required JAR files. However, before you start to write an analyzer you will need to choose an environment in which to develop the code. It is possible to operate with just a text editor and then use javac to compile the resulting Java code but it is generally more convenient to use an Integrated Development Environment (IDE). If you choose Eclipse as the environment then the following instructions describe the typical setup.

To develop an analysis module within Eclipse you need to:

Instructions for downloading Eclipse can be found by following the download link on the Eclipse homepage (see download). Once installed switch to the Java Perspective (Window > Open Perspective > Java). In this perspective create a new Java Project:

There are five JAR files that need to be on the classpath of the AnalysisModule project:

In all of the file paths above, toolsDir denotes the directory where ISAv4 installs the tools (on Microsoft Windows, this is by default C:\Documents and Settings\<user ID>\IBM\ISAv4\applications\eclipse; on Linux it is a subdirectory IBM/ISAv4/applications/eclipse under the user home directory).

If you have installed extensions to the Dump Analyzer tool (for example the WebSphere Application Server modules), you may need to add additional jar files provided by these extensions. Refer to the documentation for each extension for further information about the jar files that they provide.

To add these JAR files to the classpath within Eclispe:

It's advisable that you write your analysis module class within a package. To create a package within your AnalysisModule project:

Your environment is now ready for you to write an analysis module.

© Copyright IBM Corp. 2007, 2008 All Rights Reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.