Documentation 7.5
Aqua Data Studio 7.5
1. Installation
    1.1 Minimum Requirements
    1.2 Installing Aqua Data Studio in Windows OS
    1.3 Installing Aqua Data Studio in Linux OS
    1.4 Installing Aqua Data Studio in Mac OS
    1.5 First steps towards Configuring
    1.6 Choose Your Language
    1.7 Character set and Internationalization
2. Server Registration
    2.1 Supported RDBMS Servers in ADS 7.5
    2.2 How to Register a Server in ADS 7.5
    2.3 How to Edit Server Properties
    2.4 How to Copy Server Configurations
    2.5 Troubleshoot Registrations
    2.6 Tips and Tricks
    2.6.1 How to Register a Server Clone
    2.6.2 Tab Coloring to Identify Servers
    2.6.3 Using Filter Options in Registration
    2.6.4 Using Advanced Properties
    2.6.5 Permissions in Server Registration
    2.6.6 Drag and Drop Features
    2.6.7 Navigating with Short cut Keys
    2.6.8 SQL Express 2005
    2.6.9 MSDE 2000
    2.6.10 PostgreSQL SSL
    2.7. JDBC Drivers and Server Registration
        2.7.1 Oracle 8i JDBC Drivers
        2.7.2 Oracle 9i JDBC Drivers
        2.7.3 Oracle 10g JDBC Drivers
        2.7.4 Oracle 11g JDBC Drivers
        2.7.5 DB2 iSeries JDBC Drivers
        2.7.6 DB2 7.2 JDBC Drivers
        2.7.7 DB2 UDB 8.1 and DB2 UDB 8.2
        2.7.8 DB2 UDB 9.0 and DB2 UDB 9.5
        2.7.9 SQL Server JDBC Drivers
        2.7.10 Sybase ASE JDBC Drivers
        2.7.11 Sybase Anywhere JDBC Drivers
        2.7.12 Sybase IQ JDBC Drivers
        2.7.13 Informix JDBC Drivers
        2.7.14 PostgreSQL JDBC Drivers
        2.7.15 MySQL JDBC Drivers
        2.7.16 Apache Derby JDBC Drivers
        2.7.17 SQLite JDBC Driver
        2.7.18 Firebird JDBC Driver
3. Connecting to a Server (CTRL + INSERT)
4. Disconnecting a Server (CTRL + DELETE)
5. Query Analyzer - SQL Tool in ADS 7.5
    5.1 Invoking the Query Analyzer (CTRL+Q)
    5.2 Using the Query Analyzer
    5.3 Query Analyzer and its Environment
    5.4 Using Advanced Properties
    5.5 Parameterized Scripts
    5.6 Displaying Results of Queries
    5.7 Saving Query Results
    5.8 Tips and Tricks
6. SQL History (CTRL+ ALT+H)
7. Automate your SQL scripts using ADS 7.5
    7.1.1 Adding Insert, Update, Delete and Select
    7.1.2 Introduce Columns and Value Stubs
    7.1.3 Comments and Morph to Delimited Text
    7.1.4 Formatting Statements
    7.2 Auto Completion
    7.3 Aqua Commands
8. Query Builder Tool in ADS 7.5
    8.1 Building Queries
    8.2 Workspace Reference
9. Charting Tool in ADS 7.5
    9.1 Working with Grids
    9.2 Working with Pivot Grids
    9.3 Working with new & Enhanced Charts
    9.4 Scripting Charts
    9.5 Chart Options
    9.6 Function Series
    9.7 Chart Gallery
10. SQL Query Tuning - Visual Explain Tools
    10.1 Invoking Execution Plans
    10.2 Using Explain Diagrams
    10.3 Sample Query Tuning Demo
11. GUI Tools for Creating Database Objects
    11.1.1 Creating Tables
    11.1.2 Creating Constraints
    11.1.3 Creating Indexes
    11.1.4 Creating Views and Triggers
    11.1.5 Creating Aliases and Synonyms
    11.1.6 Creating Storage Objects
    11.2 Multi Scripting Objects
12. Tools and Features available in ADS 7.5
    12.1 How to Import Data using ADS 7.5
    12.2 How to Export Data using ADS 7.5
    12.3 Generate SQL Scripts using ADS 7.5
    12.4 Table Data Editor
    12.5 Server Script Generator
    12.6 Using Object Search in ADS 7.5
    12.7 Comparing two Database Schemas
    12.8 Using Explain White Board
    12.9 Using Execution Monitor
    12.10 Generating ER Diagrams
13. Procedure Editor
    13.1 Sample Stored Procedure
14. Function Editor
    14.1 Sample User Defined Function
15. Package Editor
    15.1 Sample Package Editing Demo
16. SQL Debugger
    16.1 Invoking ADS 7.5 SQL Debuggers
    16.2 Features of ADS 7.5 Debuggers
    16.2.1 Oracle Debugger
    16.2.2 DB2 Debugger
    16.2.3 MS SQL Debugger
    16.2.4 Sybase Debugger
    16.3 Debugging Stored Procedure Demo
17. ER Modeler in ADS 7.5
    17.1 Notation and Normalization
    17.2 Working with ER Modeler
    17.2.1 Creating Tables
    17.2.2 Creating Indexes
    17.2.3 Creating Constraints
    17.2.4 Creating Relationships
    17.2.5 Adding Notes and Regions
    17.2.6 Saving an ER Model
    17.3 Forward Engineering
    17.4 Reverse Engineering
    17.5 ER Modeler Demo
18. Version Control in ADS 7.5
    18.1 Using Subversion Repository
    18.2 Using CVS Repository
    18.3 File Search in Version Control
    18.3 Tips and Tricks
19. DBA Corner
    19.1 ORACLE DBA Tools
    19.1.1 Server Statistics
     19.1.2 Rollback Manager
     19.1.3 Log Manager
     19.1.4 Session Manager
     19.1.5 Instance Manager
     19.1.6 Storage Manager
     19.1.7 Security Manager
     19.1.8 SGA Manager
    19.2 SQL SERVER DBA Tools
    19.2.1 Instance Manager
    19.2.2 Session Manager
    19.2.3 Security Manager
    19.2.4 Storage Manager
    19.2.5 SQL Agent Manager
    19.3 SYBASE DBA Tools
    19.3.1 Instance Manager
    19.3.2 Session Manager
    19.3.3 Security Manager
    19.3.4 Storage Manager
    19.4 MySQL DBA Tools
    19.4.1 Instance Manager
    19.4.2 Session Manager
    19.4.3 Storage Manager
    19.4.4 Security Manager
    19.5 DB2 for LUW DBA Tools
    19.5.1 Instance Manager
    19.5.2 Session Manager
    19.5.3 Storage Manager
    19.5.4 Security Manager
20. Compare Tools in ADS 7.5
    20.1 File Compare
    20.2 Results Compare
    20.3 Directory Compare
    20.4 Tab Compare
    20.5 Schema Compare
    20.6 Copy History Compare
21. Editors available in ADS 7.5
    21.1.1 SQL Editor
    21.1.2 Java and JavaScript Editor
    21.1.3 HTML Editor
    21.1.4 XML Editor
    21.1.5 Text Editor
    21.1.6 Regular Expressions
    21.2 Image Viewer
22. Application Workspace and Options
    22.1 Menus and Toolbar
    22.2 Shortcuts
    22.3 Schema and Script Browser
    22.4 Details View
23. Aqua Data Studio 7.5 OPTIONS
    23.1 General Options
    23.2 Editor Options
    23.3 Compare and Results Options
    23.4 Query Analyzer Options
    23.5 Scripts and Results Options
    23.6 Visual Explain Options
    23.7 Formatter Options
    23.8 Permissions and Registration Options
    23.9 Key Mapping Options and Key Assist Tool
    23.10 Settings: Find the application settings
    23.11 Command line
24. Aqua Data Studio Technical Support
    24.1 Error Logging

2.7.6 DB2 7.2 JDBC Drivers

JDBC Drivers - DB2 7.2 JDBC Driver


 DB2 7.2 is the database which has the most connection issues. JDBC drivers for database version are not compatible, neither are they compatible across fixpacks. Updating your DB2 JDBC driver to the version which you are using is always a good idea. The DB2 Server installation provides JDBC drivers for the version and fixpack in use. You may copy the provided JDBC driver and overwrite the driver provided by ADS. You can copy the /sqllib/java/db2java.zip that comes with your installation and overwrite the /ADS_INSTALLATION/lib/db2java.jar file.

- NOTE: The DB2 7.2 JDBC driver does not connect directly to the DB2 Server, but to a proxy server which is installed with the DB2 Server. This proxy server can be started with the db2jstrt[.exe], which defaults to port 6789. The process is enabled by default in most installations.

Driver Location (Windows/Linux): [ADS_INSTALL]\lib\drivers\db2java.jar
Driver Location (OSX): /Aqua Data Studio/Contents/Resources/Java/drivers/db2java.jar

You may locate the latest DB2 JDBC drivers at the following location ...

Vendor: IBM
Driver URL: DB2 Server Installation ([DB2 Install]\java\db2java.zip)

You may locate the JDBC drivers for your installed version of DB2 in the DB2 server or DB2 client installations. Below is a directory listing of the driver files in the [DB2_INSTALL]\java directory. The db2java.zip file is the DB2 JDBC driver required by ADS. This is the file which you need to use to overwrite the db2java.jar file.

C:\Program Files\SQLLIB\java>dir
 Volume in drive C has no label.
 Volume Serial Number is 7C2B-F9B7

 Directory of C:\Program Files\SQLLIB\java

09/03/2002  12:39p      DIR          .
09/03/2002  12:39p      DIR          ..
06/17/2003  07:02p             554,911 cc_cmn.jar
06/17/2003  07:02p             266,631 cc_nav.jar
06/17/2003  06:58p             809,313 common.jar
03/07/2003  07:20p             234,244 databean.jar
06/27/2003  04:23p           1,146,367 db2java.zip
06/18/2003  04:37a               5,342 db2vcsql.jar
09/03/2002  11:21a      DIR          images
09/03/2002  11:19a      DIR          java12
09/03/2002  12:36p      DIR          jdk
06/17/2003  07:01p             239,966 jgraph.jar
09/03/2002  12:35p      DIR          jre
09/03/2002  12:40p      DIR          prime
06/17/2003  06:22p             338,990 runtime.zip
06/17/2003  06:58p           1,253,896 sqlasst.jar
06/17/2003  06:22p           1,671,552 sqlj.zip
06/17/2003  09:29p           2,458,220 swingall.jar
              11 File(s)      8,979,432 bytes
               7 Dir(s)   5,216,145,408 bytes free

C:\Program Files\SQLLIB\java>
       
 To update the ADS JDBC drivers you need to overwrite the ADS db2java.jar file. Below is a listing of the Aqua Data Studio library directory [ADS_HOME]\lib\drivers\ ...

C:\Program Files\Aqua Data Studio 7.0 - 32bit\lib\drivers>dir
 Volume in drive C has no label.
 Volume Serial Number is AC70-D62C

 Directory of C:\Program Files\Aqua Data Studio 7.0 - 32bit\lib\drivers

05/30/2008  08:48 AM    dir          .
05/30/2008  08:48 AM    dir          ..
03/20/2008  10:05 PM         1,146,367 db2java.jar
03/20/2008  10:05 PM         1,973,658 db2jcc.jar
03/20/2008  10:05 PM             1,015 db2jcc_license_cu.jar
03/20/2008  10:05 PM         2,343,388 derby.jar
03/20/2008  10:05 PM           489,802 derbyclient.jar
04/05/2008  01:15 PM           218,162 derbynet.jar
03/20/2008  10:05 PM           685,631 ifxjdbc.jar
03/20/2008  10:05 PM           529,560 jconnect60.jar
03/20/2008  10:05 PM         4,301,866 jt400.jar
03/20/2008  10:05 PM           554,589 jtds-src.jar
05/06/2008  09:46 PM           297,610 jtds.jar
03/20/2008  10:05 PM           655,034 mysql-src.jar
03/20/2008  10:05 PM           676,693 mysql.jar
04/16/2008  09:29 AM         1,645,114 nlscharset12.jar
04/16/2008  09:29 AM         1,545,954 oracle.jar
03/20/2008  10:05 PM           415,542 postgresql.jar
03/20/2008  10:05 PM           286,771 util400.jar
03/20/2008  10:05 PM           139,148 xdb.jar
03/20/2008  10:05 PM           839,982 xmlparserv2.jar
              19 File(s)     18,745,886 bytes
               2 Dir(s)  17,642,438,656 bytes free
The Java class path for the drivers are already configured for ADS in the datastudio.cfg for launching ADS with datastudio.exe and in datastudio.bat/.sh and datastudio-bundled.bat/.sh for launching ADS from the command line. The contents of the file are as follows ...
C:\Program Files\Aqua Data Studio 6.5>type datastudio.cfg

.

.\jre\bin\javaw.exe

-Dsun.swing.enableImprovedDragGesture -Xmx256M -cp ".\lib\ads.jar;
.\lib\aqua-lib.jar;
.\lib\aspc.jar;
.\lib\aqua2.jar;
.\lib\oracle.jar;
.\lib\nlscharset12.jar;
.\lib\jtds.jar;
.\lib\derby.jar;
.\lib\derbyclient.jar;
.\lib\mysql.jar;
.\lib\postgresql.jar;
.\lib\db2java.jar;
.\lib\db2jcc.jar;
.\lib\db2jcc_license_cu.jar;
.\lib\ifxjdbc.jar;
.\lib\jconnect55.jar;
.\lib\jconnect60.jar;
.\lib\xmlparserv2.jar;
.\lib\xdb.jar;
.\lib\activation.jar;
.\lib\jaxb1-impl.jar;
.\lib\jaxb-api.jar;
.\lib\jaxb-impl.jar;
.\lib\jaxb-xjc.jar;
.\lib\jsr173_1.0_api.jar;
.\lib\stringtemplate.jar;
.\lib\jide-action.jar;
.\lib\jide-beaninfo.jar;
.\lib\jide-common.jar;
.\lib\jide-components.jar;
.\lib\jide-dialogs.jar;
.\lib\jide-dock.jar;
.\lib\jide-grids.jar;
.\lib\jide-pivot.jar;
.\lib\jide-shortcut.jar" com.aquafold.datastudio.DataStudio
       
C:\Program Files\Aqua Data Studio 6.5>type datastudio.bat
SET ADS_PATH=
SET ADS_PATH=%ADS_PATH%;.\lib\oracle.jar
SET ADS_PATH=%ADS_PATH%;.\lib\nlscharset12.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jtds.jar
SET ADS_PATH=%ADS_PATH%;.\lib\derby.jar
SET ADS_PATH=%ADS_PATH%;.\lib\derbyclient.jar
SET ADS_PATH=%ADS_PATH%;.\lib\mysql.jar
SET ADS_PATH=%ADS_PATH%;.\lib\postgresql.jar
SET ADS_PATH=%ADS_PATH%;.\lib\db2jcc.jar
SET ADS_PATH=%ADS_PATH%;.\lib\db2jcc_license_cu.jar
SET ADS_PATH=%ADS_PATH%;.\lib\db2java.jar
SET ADS_PATH=%ADS_PATH%;.\lib\ifxjdbc.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jconnect55.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jconnect60.jar
SET ADS_PATH=%ADS_PATH%;.\lib\aqua-lib.jar
SET ADS_PATH=%ADS_PATH%;.\lib\aqua2.jar
SET ADS_PATH=%ADS_PATH%;.\lib\xmlparserv2.jar
SET ADS_PATH=%ADS_PATH%;.\lib\xdb.jar

SET ADS_PATH=%ADS_PATH%;.\lib\activation.jar
SET ADS_PATH=%ADS_PATH%;.\lib\aspc.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jaxb1-impl.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jaxb-api.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jaxb-impl.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jaxb-xjc.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jsr173_1.0_api.jar
SET ADS_PATH=%ADS_PATH%;.\lib\stringtemplate.jar

SET ADS_PATH=%ADS_PATH%;.\lib\jide-action.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-beaninfo.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-common.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-components.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-dialogs.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-dock.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-grids.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-pivot.jar
SET ADS_PATH=%ADS_PATH%;.\lib\jide-shortcut.jar