Checking the Installation and Configuration

Once you have verified that the above assumptions and requirements are satisfied, you must check your Oracle SQLJ installation.

Check for Installed Directories and Files

Verify that the following directories have been installed and are populated.

Directories for Oracle JDBC

If you are using one of the Oracle JDBC drivers, refer to the Oracle8i JDBC Developer's Guide and Reference for information about JDBC files that should be installed on your system.

Directories for Oracle SQLJ

Installing the Oracle JServer will include, among other things, a sqlj directory under your [Oracle Home] directory. This contains the following subdirectories:

• demo (demo applications, including some referenced in this chapter)

• doc

• lib (.zip files containing class files for SQLJ)

Also, directly under [Oracle Home] is the following directory containing utilities for all Java product areas:

• bin

Check that all these directories have been created and populated, especially lib and bin.

Set the PATH and CLASSPATH

Make sure your PATH and CLASSPATH environment variables have the necessary settings for Oracle SQLJ (and Oracle JDBC if applicable).

PATH and CLASSPATH for Oracle JDBC

If you are using one of the Oracle JDBC drivers, you will need the Oracle JDBC classes ZIP file that is appropriate for your environment.

JDK 1.1.x-compatible classes are in classes111.zip; JDK 1.2.x-compatible classes are in classes12.zip. Presuming you use a Sun Microsystems JDK environment, make sure the appropriate ZIP file name is in your CLASSPATH setting.

For more information about required PATH and CLASSPATH settings for Oracle JDBC, refer to the Oracle8i JDBC Developer's Guide and Reference.

PATH and CLASSPATH for Oracle SQLJ

Set your PATH and CLASSPATH variables as follows for Oracle SQLJ:

PATH Setting

To be able to run the sqlj script (which invokes the SQLJ translator) without having to fully specify its path, verify that your PATH environment variable has been updated to include the following:

[Oracle Home]/bin

Use backward-slashes for Windows. Replace [Oracle Home] with your actual Oracle Home directory.

CLASSPATH Setting

Update your CLASSPATH environment variable to include the current directory as well as the following:

[Oracle Home]/sqlj/lib/translator.zip

Use backward-slashes for Windows. Replace [Oracle Home] with your actual Oracle Home directory.

Verify Installation of sqljutl Package

Note: This step is relevant only to online translation, not offline translation or application runtime, and is applicable only if you are using the following: a pre-8.1.5 Oracle database SQLJ stored procedures or functions

The package sqljutl is required for online checking of stored procedures and functions in an Oracle database. For Oracle versions 8.1.5 and later, it should have been installed automatically under the SYS schema during installation of your database. To verify the installation of sqljutl, issue the following SQL command (from SQL*Plus, for example):

describe package sqljutl

This should result in a brief description of the package. If you get a message indicating the package cannot be found, then you must install it manually. To do so, use SQL*Plus to run the sqljutl.sql script, which is located as follows:

[Oracle Home]/sqlj/lib/sqljutl.sql

Consult your installation instructions if necessary.

---