Skip to main content

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

The first time you sign into developerWorks, a profile is created for you. Select information in your profile (name, country/region, and company) is displayed to the public and will accompany any content you post. You may update your IBM account at any time.

All information submitted is secure.

  • Close [x]

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.

  • Close [x]

developerWorks Community:

  • Close [x]

Managing pureQuery-enabled applications efficiently, Part 3: Automate client optimization with WebSphere applications

pureQuery client optimization with SQL management repository

Tony Sun (, Staff Software Engineer, IBM
Tony Sun is the primary QA engineer for the pureQuery runtime product.

Summary:  In a customer environment, applications often interact with transactional databases from within an application server. pureQuery client optimization can provide useful diagnostic information as well as increase performance for your web application. In this tutorial, you will learn how to automate the pureQuery client optimization process with Apache Ant script technologies.

View more content in this series

Date:  19 May 2011
Level:  Intermediate PDF:  A4 and Letter (1033 KB | 24 pages)Get Adobe® Reader®

Activity:  17116 views

Before you start

Learn what to expect from this tutorial, and how to get the most out of it.

About this series

This is Part 3 of the "Managing pureQuery-enabled applications efficiently" series. Part 1 introduced the concept of using a repository with client optimization. Also, you learned how to use Ant scripts to facilitate the process of creating a repository. Now you will build upon these concepts so you can develop a fully automated client optimization system to help analyze and improve your applications.

Editor's note: Part 2 of this series is scheduled for publication in June 2011.

About this tutorial

The primary goal of this tutorial is to provide you with an Ant script framework that incorporates the pureQuery ManageRepository utility to automate maintaining a repository. The ManageRepository functions include creating a runtime group inside the repository, uploading and extracting repository artifacts, merging and configuring repository artifacts, and reporting repository information. These tasks will be performed to analyze a web application deployed inside WebSphere® Application Server.

Figure 1 illustrates the architecture of the framework.

Figure 1. Architecture framework showing automated process
WebSphere Application Server application connects to database and client       optimization captures executed SQL; client application connects to the server and generates reports

Most importantly, once you have a good grasp of this framework, you can customize it to suit your needs. For instance, if you are experiencing performance issues, you can modify the framework to simulate heavy workloads or long execution time. Or if you want to provide a quick demo, you can modify it to showcase all of client optimization's functionality.

Before diving in too deep, you must have a good understanding of the previous tutorials. If you do not know how to create a repository with Ant scripts, then begin with Part 1.


The objective of this tutorial is to provide a skeleton automation system you can customize to suit your application analysis needs. You will learn to:

  • Deploy your application inside WebSphere Application Server.
  • Configure the environment and property files that will be used by the Ant scripts.
  • Customize your Ant XML file (repository.xml file) to suit the needs of your application.
  • Analyze reports regarding your application.


The following software components must be available:

  • WebSphere Application Server 6.0+
  • pureQuery Runtime 2.18+
  • JCC 3.57+
  • Apache Ant 1.7+
  • Database for Transactions and Repository
  • Eclipse 3.4+ or Optim Development Studio (ODS)

System requirements

You will need to have either ODS installed or Eclipse 3.4 installed on your machine. Also, you must have access to WebSphere Application Server 6.0 or higher, where you can deploy your application. WebSphere must be configured with a data source that connects to a transactional database. This will allow your application to execute against the database as client optimization captures the executed SQL. Also, Apache ANT must be on the classpath of your Eclipse and Optim Development Studio environment so that you execute Ant scripts. You should know this procedure from the previous tutorials.

1 of 8 | Next


Zone=Information Management, WebSphere, Open source
TutorialTitle=Managing pureQuery-enabled applications efficiently, Part 3: Automate client optimization with WebSphere applications