You are here: > Home > Support > ToolBook Knowledge Base

Knowledge Base

Printer Friendly
Are you using the wrong version of Java? How to switch to the correct JVM?

The information in this article applies to:

Product: ToolBook
Component:
DHTML
Product version(s): 7.x, 8.5

PROBLEM
Some or all of the following symptoms may occur if the Sun Java Virtual Machine (JVM) is the default for the browser, when loading DHTML content created with ToolBook 7.x - 8.5.

  • DHTML page partially loads (or does not load at all).
  • Message may appear indicating some objects are not found, for example: "Page p## does not exist and could not be loaded."
  • No interaction with the page (objects are static).
  • Objects from the previous page still appear even after navigating to the next page.
  • All objects from all pages seem to appear stacked on top of each other

Are you running with the Sun JVM and don't know it?
Use this website to quickly check (note that this is not a SumTotal Systems site so we can't guarantee that it will be available if you try to use it):
http://www.java.com/en/download/help/testvm.xml

RESOLUTION
ToolBook 7.x - 8.5 was not designed to support the use of the Sun JVM, but rather expects the Microsoft JVM to be used. ToolBook 8.6 however does support the Sun JVM, and you can learn more about version 8.6 here:
http://www.toolbook.com/kb/Q105164526500019

For user of ToolBook 7.x - 8.5 content, make the Microsoft JVM the default JVM for the browser by deselecting the Sun JVM as the default Java Runtime.

  • Launch the Windows Control Panel
  • Select "Java Plug-in 1.3.1_##" (Or, the latest version installed).
  • From the Browser tab, the browsers should be unchecked. Note that if you don't have a Browser tab, see the Alternate Method below.

ALTERNATE METHOD
Internet Explorer provides a direct way of setting which Java VM is the active VM. If you access the Internet Options option in the Tools menu of Internet Explorer, you will be presented with the Internet Options dialog. The Advanced tab of this dialog will reveal the current JVM in use.

In the event that the Sun JVM is installed (and/or in use), you will find an entry in this Advanced tab section. If the Sun JVM is not listed then it can be assumed that it is not currently installed. If the Sun JVM is listed but unchecked, it can be assumed that it is installed but not currently in use for Internet Explorer.

BACKGROUND
ToolBook DHTML and Aspen CDS only support using the Microsoft JVM (Sun JVM is currently not supported). The Sun JVM did not exist at the time the DHTML content was engineered. The Microsoft JVM was the only JVM available for Internet Explorer at that time (Netscape does not use a JVM).

As of version 1.3.1_02 of the Sun Java Runtime Engine (JRE), the default install will make the Sun JVM the browser JVM (see figure 3). To prevent this, deselect the option during the installation of the Sun Java Runtime Engine.

Related Articles: 
Unable to launch AXFtoDHTML converter


OPENSCRIPT NOTICE
The OpenScript programming examples found in many articles may need modification in order to work in ToolBook 9.0 or higher, particularly if the article was written for an older version of ToolBook. To learn more, click here.

  Provide Anonymous Feedback About This Article