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 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.

  • 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]

Managing pureQuery-enabled applications efficiently, Part 1: Set up an SQL management repository using an Ant script

Patrick Titzler (ptitzler@us.ibm.com), Solution Architect, IBM
Patrick Titzler
Patrick Titzler is a Solution Architect in IBM Software Group, focusing on optimization of Java database applications with IBM Optim Solutions. He has many years of development experience, having contributed to various business intelligence and data warehousing products supporting DB2 for LUW and DB2 for z/OS. Patrick holds a Master's degree in Computer Science from the University of Rostock, Germany.
Soid Quintero (squinter@us.ibm.com), Technical Enablement Engineer, IBM
Photo of Soid Quintero
Soid Quintero is a co-op on the IBM Optim Solutions enablement team at the Silicon Valley Lab. She is currently working on her Master's degree in Human Factors and Ergonomics focusing on computer human interaction at San Jose State University in San Jose, California.

Summary:  IBM® Optim™ Development Studio and the pureQuery Runtime include a command-line utility called ManageRepository that can be used to create, modify, export, import, and delete pureQuery metadata stored in the SQL management repository. Setting up an SQL management repository can be challenging using the ManageRepository utility command script. This tutorial shows you how to create and manage an SQL repository using an Ant script. You will also learn how to run the Ant script from within IBM Optim Development Studio.

View more content in this series

Date:  27 Jan 2011
Level:  Intermediate PDF:  A4 and Letter (663 KB | 30 pages)Get Adobe® Reader®

Activity:  28940 views
Comments:  

Before you start

Introduction

The pureQuery technology has relied since its introduction on a file-based approach to store its configuration and relevant application metadata information. While this approach works well in small deployments, there is a need for a more centralized approach that does the following:

  • Simplifies administration
  • Improves collaboration among DBAs and developers
  • Supports broader analysis
  • Enables tighter cross-product integration
  • Scales well
  • Leverages the strength of database systems with respect to availability, access control, and reliability in enterprise environments

The SQL management repository in Optim Development Studio 2.2.0.3 can meet those requirements. This tutorial introduces this repository and guides you through the process of setting one up using an example Ant script.

Introduction to the SQL management repository

The SQL management repository stores information about pureQuery-enabled applications in containers called runtime groups. Each runtime group contains application-specific information and pureQuery configuration information, as shown in Figure 1.


Figure 1. The central database repository leverages the advantages of DBMSes and improves collaboration



Application-specific information includes a list of known SQL statements that an application processes, SQL-to-source code correlation information, execution-related metrics, and other metadata that is useful in the context of common application maintenance, tuning, and problem determination tasks. The pureQuery Runtime typically collects this information and stores it in the repository as part of the pureQuery client optimization process.

pureQuery configuration information comprises runtime settings for the application and configuration files that are used by pureQuery utilities to create the artifacts that support static SQL execution (for DB2® databases).

You can use Optim Development Studio (ODS) to manage the repository interactively or the ManageRepository command-line utility to automate common administration tasks, as shown in Figure 2. Other applications, such as the pureQuery Runtime, can retrieve and, to some extent, update information that is stored in the repository.


Figure 2. The SQL management repository is accessed using various Optim tools


In Optim Development Studio 2.2.1, an SQL management repository can reside in any of the following DB2 versions:

  • DB2 9.1, 9.5, and 9.7 for Linux®, UNIX®, and Windows®
  • DB2 for System i® V5R3 or V5R4
  • DB2 Universal Database for z/OS® 8.1
  • DB2 9.1 for z/OS

SQL management repository-enabled applications (such as ODS and pureQuery Runtime) can access the repository using dynamic or static SQL. Enabling static SQL access during the repository setup process is recommended to lock down access to the underlying database objects as much as possible. Access to the repository objects is restricted to users that have been granted manager or application access. Manager access needs to be granted to users (or groups) that have a need to create, read, modify, or delete pureQuery application information. Application access is used only by the pureQuery Runtime to update application metadata.

Throughout this tutorial, the SQL management repository is referred to as the repository.

In an enterprise environment, multiple SQL management repositories can be used to accommodate the deployment life cycle stages of a pureQuery application in multiple test and production environments.

For in-depth information about the SQL management repository, refer to the Integrated Data Management Information Center in Resources.


About this series

This tutorial is Part 1 of a loosely grouped three-part "Managing pureQuery-enabled applications efficiently" series that covers the client optimization process that extends the pureQuery benefits to existing Java™ applications.

About this tutorial

In this tutorial, you will learn how to use IBM Optim Development Studio to set up an SQL management repository using a simple Ant script example that exposes the ManageRepository command-line utility that is shipped as part of the pureQuery Runtime. This Ant script is provided in the Download section of this tutorial. It simplifies common tasks and provides an ideal approach to get up and running quickly without the need to learn about the more complex ManageRepository command-line utility.


Objectives

The objective of this tutorial is to walk you through the basic SQL management repository setup process. While completing this tutorial, you will complete the following steps:

  1. Create a database that stores the SQL management repository.
  2. Prepare Optim Development Studio to run the example Ant repository management script.
  3. Customize the repository management script.
  4. Create the SQL management repository database objects, enable static SQL access, and validate the repository's integrity.
  5. Learn how to customize the SQL management repository deployment options.
  6. Grant users access to the repository.
  7. Create a repository connection in Optim Development Studio, allowing you to manage pureQuery-enabled applications.

System requirements

The following software must be installed to complete this tutorial:

  • Optim Development Studio 2.2.0.3 or later. See Resources for how to download a no-charge trial version.
  • DB2 Database Server. See Resources for how to download a no-charge trial version of DB2 Express-C.

1 of 8 | Next

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=Information Management, Java technology
ArticleID=619849
TutorialTitle=Managing pureQuery-enabled applications efficiently, Part 1: Set up an SQL management repository using an Ant script
publish-date=01272011
author1-email=ptitzler@us.ibm.com
author1-email-cc=
author2-email=squinter@us.ibm.com
author2-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere).

My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Try IBM PureSystems. No charge.