System Options dialog box: Java tab
Description
Use this dialog box to check the current status of the Java
virtual machine (JVM), view the classpath used by the JVM, and specify
user-defined classes to be added to the classpath used by the JVM.
When you use any feature that requires a JVM, such as using
the JDB driver or opening a Web page that contains a Java applet,
PowerBuilder starts running the JVM. The JVM is started as a service
and continues to run throughout your PowerBuilder session.
Dialog options
Classpaths
Use the buttons at the top of the tab page to add a new entry
or delete or change the order of selected entries. When you click
the new button, buttons that you can use to browse for a folder
or file display.
Entries must be directories, zip files that contain classes,
or jar files that contain classes.
You must restart the VM
Modifications you make to this tab page do not take effect
until you restart the JVM. If the JVM is already running, you must
shut down PowerBuilder to stop the JVM.
In the development environment, the classpath used by the
JVM is constructed by concatenating these paths:
-
A
classpath added programmatically when the JVM is started. For example,
if you are building an EJB client, you can pass a classpath as an argument
to the CreateJavaVM function. -
The PowerBuilder runtime static registry classpath.
This path is built into the pbjvm.dll and contains classes required
at design time and runtime for features such as PDF generation and
EJB clients. -
The PowerBuilder system classpath. This path resides
in a Windows registry key installed when you install PowerBuilder.
It contains classes required at design time for Java-related PowerBuilder
features. -
The PowerBuilder user classpath. This is the path
that you specify in this dialog box. -
The system CLASSPATH environment variable.
-
The current directory.
The classes you specify in this dialog box are not used at
runtime. The JVM service uses the following classpath at runtime:
-
The system JAVA_HOME environment variable.
-
A classpath added programmatically when the JVM
is started. -
The PowerBuilder runtime static registry classpath.
-
The system CLASSPATH environment variable.
-
The current directory.
Neither the PowerBuilder installation nor the changes you
make in this dialog box affect the CLASSPATH and PATH system or
user environment variables.
JVM Status
Indicates whether the JVM has been loaded in the current session.
If the JVM is loaded, displays the JDK version.
View JVM Classpath
Click to display the classpath used when the JVM is started.
Set JDK Location
A Sun Java Development Kit (JDK) with a Java Runtime Environment
(JRE) subdirectory is installed in the %Appeon%PowerBuilder [version]IDE
directory when you install PowerBuilder. When a JVM is needed, PowerBuilder
looks for a jvm.dll in the jreinclient (for JDK
1.4 or later) or jreinclassic (for JDK 1.2
or 1.3) subdirectory of the JDK installation. If you need to use
a different JVM, click JDK Location to open a dialog box where you
can specify alternative locations for the JDK and JRE.
You need administrative privileges to set the JDK location
for PowerBuilder.