The following figure shows the position of a Java Virtual Machine in a HiRDB system.

Figure 17-2 Position of Java Virtual Machine in a HiRDB system

#1: The Java virtual machine is included in a JRE (Java Runtime Environment). For details about JREs, see (2) JRE (Java Runtime Environment).

#2: HiRDB provides the JDBC driver as a standard.

To use Java stored procedures and Java stored functions, a Java Runtime Environment (JRE) is required at the HiRDB server.

(a) How to obtain a JRE

You should be able to acquire necessary information about JREs and obtain the appropriate JRE by visiting the platform vendor's home page. The JRE version depends on the platform. The following table lists the JRE version for each platform.

Table 17-2 JRE versions

Applicable OS		Version
		When a Type2 JDBC driver is used	When a Type4 JDBC driver is used
HP-UX	32-bit#	1.2.2.04 or later	1.4.2 or later
	64-bit	--	1.4.2 or later
	IPF	1.4.2.02 or later	1.4.2.02 or later
Solaris	32-bit#	1.3 or later	1.4.2 or later
	64-bit	--	1.4.2 or later
AIX	32-bit#	1.3 or later	1.4.2 or later
	64-bit	--	1.4.2 or later
Linux	32-bit	1.3 or later	1.4.2 or later
	EM64T	--	1.5.0 or later

Legend:

--: Java stored procedures and Java stored functions cannot be used.

#: Only the POSIX library version is supported.

(b) Handling of the JRE included in HiRDB version 07-02 and earlier

A JRE was included in HiRDB version 07-02 and earlier. This JRE will be deleted from the installation directory and the HiRDB directory at the following times:

When the included JRE is deleted from the installation directory

The JRE is deleted when the following events occur:

• The HiRDB version that provided the JRE (07-02 or earlier) is uninstalled.
• HiRDB version 07-03 or later is installed by overwriting the existing HiRDB.

When the included JRE is deleted from the HiRDB directory

When the file required for HiRDB execution is deleted in order to delete HiRDB from the OS (when Y is entered as the response to the pdsetup -d command's execution query message).

(c) Notes about upgrading to HiRDB version 07-03 or later

The following notes apply to upgrading to HiRDB version 07-03 or later.

• When you upgrade your HiRDB to version 07-03 or later, you must specify the root directory of the Java Runtime Environment (JRE) in the pd_java_runtimepath operand. If necessary, also specify in the pd_java_libpath operand the directory that contains the JRE libraries.
• The JRE that was expanded when HiRDB version 07-02 or earlier was installed will be deleted as explained in (b) above. If you want to continue using that JRE, do the following:
  
  1. Before the JRE is deleted, back it up to a directory other than the installation directory or HiRDB directory.
  2. In the pd_java_runtimepath operand, specify the directory containing the JRE that was backed up.

The following figure shows the system configuration for using Java stored procedures and Java stored functions in a HiRDB single server configuration.

Figure 17-3 System configuration for using Java stored procedures and Java stored functions in a HiRDB single server configuration

The following figure shows the system configuration for using Java stored procedures and Java stored functions in a HiRDB parallel server configuration.

Figure 17-4 System configuration for using Java stored procedures and Java stored functions in a HiRDB parallel server configuration