|Oracle8i SQLJ Developer's Guide and Reference
Release 3 (8.1.7)
Part Number A83723-01
Once you have verified that the above assumptions and requirements are satisfied, you must check your Oracle SQLJ installation.
Verify that the following directories have been installed and are populated.
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.
Installing the Oracle JServer will include, among other things, under your
[Oracle Home]directory a
sqlj directory containing the following subdirectories:
demo(demo applications, including some referenced in this chapter)
.zipfiles containing class files for SQLJ)
In addition, directly under
[Oracle Home] is the following directory, containing utilities for all Java product areas:
Check that all these directories have been created and populated, especially
Make sure your
CLASSPATH environment variables have the necessary settings for Oracle SQLJ (and Oracle JDBC if applicable).
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
For more information about required
CLASSPATH settings for Oracle JDBC, refer to the Oracle8i JDBC Developer's Guide and Reference.
CLASSPATH variables as follows for Oracle SQLJ:
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:
Use backward slashes for Windows. Replace
[Oracle Home] with your actual Oracle Home directory.
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.
In addition, you must include one of the following runtime libraries in your
[Oracle Home]/sqlj/lib/runtime.zip [Oracle Home]/sqlj/lib/runtime11.zip [Oracle Home]/sqlj/lib/runtime12.zip [Oracle Home]/sqlj/lib/runtime12ee.zip
If you are unsure about which runtime library you should use, you may want to specify
runtime.zip. This provides you with the highest flexibility across different Java and JDBC environments. However, if you require SQLJ ISO-compliant support for JDBC 2.0 types, such as
SQLData, you must use either
runtime12ee.zip in conjunction with JDK1.2 or J2EE and the Oracle JDBC 8.1.7 drivers.
You must specify a
This step is relevant only to online translation, not offline translation or application runtime, and is applicable only if you are using the following:
sqljutl is required for online checking of stored procedures and functions in an Oracle database. For Oracle release 8.1.5 and later, it should have been installed automatically under the
SYS schema during installation of your database's server-side JavaVM. To verify the installation of
sqljutl, issue the following SQL command (from
SQL*Plus, for example):
This should result in a brief description of the package. If you get a message indicating that 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:
Consult your installation instructions if necessary.