VISAJ Troubleshooting

Installing Visaj

[Windows] I've moved my JDK to a new directory, how do I let Visaj know?
[Solaris] I've installed a new JDK on my system. How do I run Visaj using that JDK?
[Other] There is no specific installer/launcher for my platform.

When I try and run Visaj...

[Windows] Windows pops up an Exception. Why?
[Windows] I am given a message concerning Unauthorized File Modification. What's wrong?
[Windows] When I try to run Visaj I get an Invalid Page Fault
[Solaris] I am given a message concerning Unauthorized File Modification. What's wrong?
[HP-UX] The splash screen is displayed, but then Visaj dies and java crashes. What's going on?
[HP-UX] [Solaris] When I try and run Visaj inside Java Workshop, Visaj appears and then quickly dies. What's wrong?

When using Visaj...

[Macintosh]My Macintosh hangs when using MRJ2.2 or later. What can I do?
Visaj crashes when I try and add a MenuBar to a Frame. Why?
I've used third party components in my design, but when I try to reload it Visaj throws the exceptions: NullPointerException and ClassNotFoundException. Why?
If I remove a component from a design and then generate code, the component is still present in my code. Why?
[Windows] When I try and load demos.jar an error message appears saying, "Error reading demos.jar file". What's wrong?
[Windows] I can't put Swing/JFC onto my palette. Why?
[HP-UX] [Solaris] I can't put Swing/JFC onto my palette. Why?

See Visaj FAQ for solutions to other problems when using Visaj.

When licensing Visaj...

When I run wlmd it complains that has problems reading the license file. Why?
When starting Visaj I need to Configure Licensing. But when I enter my key into the text boxes it says, "Cannot connect, check proxy settings."

Other information

Visaj FAQ
Special notes on JDKs on the Visaj Support page.

Back to Visaj Support page.

[Windows] I've moved my JDK to a new directory, how do I let Visaj know?

During installation of Visaj, you are asked for the location of the JDK to use to run Visaj. This location is stored in the registry. To override the setting in the registry, simply place the new JDK "bin" directory in your PATH environment variable and reboot your machine, e.g.:

      set PATH=d:\jdk1.2beta2\bin;%PATH%

This should be added to the end of your AUTOEXEC.BAT file.

Once rebooted, Visaj will now use your new JDK.

Go to top of this page

[Solaris] I've installed a new JDK on my system. How do I run Visaj using that JDK?

Visaj searches through your PATH environment variable looking for a java executable. To make Visaj use a different JDK, simply place the path to the bin directory at the front of your PATH environment variable, e.g.

       setenv PATH=/opt/jdk1.2beta2/bin:$PATH

Visaj will now spot the JDK1.2beta2 java executable and use its libraries and binaries.

Go to top of this page

[Other] Systems with no Supported Launcher/Installer

If your system does not appear to be specifically supported, (e.g. OS/2) you should download the generic jar archive.

Once downloaded, the jar file should be extracted into an appropriate install directory, using a command line similar to:

      jar xvf Visaj2_1_2.jar

Once Visaj has been correctly extracted, the following command line options can be used to set up your environment or to build an appropriate Script, Launcher, or Batch file.

Below are examples for an OS/2 system:
(the set and java commands should each be one line)

Visaj 3.0 (or later)

      set CLASSPATH=<path to Visaj>\lib\visaj.jar;<path to Visaj>\lib\ImageEditor.jar; 
                        <path to Visaj>\lib\visualrt.zip;<path to Visaj>\lib\plugins\; 
                        <path to Visaj>\lib\xerces.jar;%CLASSPATH% 
                        java -Dvj.rootDir=<path to Visaj> com.pacist.startup.Startup

Visaj earlier than 3.0

      set CLASSPATH=<path to Visaj>\visaj.jar;<path to Visaj>\ImageEditor.jar; 
                        <path to Visaj>\lib\plugins\;.;%CLASSPATH% 
                        java -Dvj.rootDir=<path to Visaj> com.pacist.visaj.AWTClassApp

Note: if you wish to use the Swing components with early versions of Visaj, assuming you have the appropriate JFC Swing classes installed, you must add -Dvj.useSwing=true to the java command line:

      java -Dvj.rootDir=<path to Visaj> -Dvj.useSwing=true com.pacist.visaj.AWTClassApp

Go to top of this page

[Windows] Windows pops up an Exception. Why?

The most likely cause of this problem is "." in your PATH environment variable. Visaj searches through your PATH for a java.exe; but unfortunately in some early releases of Visaj, visaj.exe would crash if it came across a ".", e.g.:

      PATH=C:\Windows;C:\Windows\COMMAND\;.;C:\BATCH

Removing all "."s from your PATH should solve this problem. If not, please contact support@ist-inc.com.

This will not affect how DOS operates. DOS always looks in the current directory for any applications before it looks at the PATH variable.

Go to top of this page

[Windows] I am given a message about Unauthorized File Modification. What's wrong?

This message can appear for a number of reasons - the most usual of which is when running Visaj from the command line. At startup Visaj checks that certain files exist - the visaj.exe application automatically tells Visaj where those files are. If you are running Visaj from the command line you need to tell Visaj where they are. You do this by setting the vj.rootDir property, e.g.:

set CLASSPATH=C:\Progra~1\IST\Visaj\visaj.jar;%CLASSPATH%

java -Dvj.rootDir=C:\Progra~1\IST\Visaj com.pacist.visaj.AWTClassApp

Go to top of this page

[Windows] When I try to run Visaj I get an Invalid Page Fault

Unfortunately, a small percentage of systems experience this problem.

To get around this, it is possible to amend the shortcut to include the -r flag (See fig. 1 below).

Note: Remember to press Apply so the changes are stored.

Figure 1. Showing appropriate changes to Visaj shortcut

There should also be an executable file contained within the Visaj install directory (Usually C:\Program Files\IST\Visaj\bin) called vjmsdos.exe. Running vjmsdos -r should also solve the problem.

Go to top of this page

[Solaris] I am given a message about Unauthorized File Modification. What's wrong?

This message can appear for a number of reasons - the most usual of which is when running Visaj without the shell script. At startup the Visaj shell script checks that certain files exist - and automatically tells Visaj where those files are. If you are running Visaj without using the shell script you need to tell Visaj where they are. You do this by setting the vj.rootDir property, e.g.:

setenv CLASSPATH /opt/Visaj/visaj.jar:$CLASSPATH

java -Dvj.rootDir=/opt/Visaj com.pacist.visaj.AWTClassApp

Go to top of this page

[HP-UX] The splash screen is displayed, but then Visaj dies and java crashes. What's going on?

There is a known problem with the Hewlett Packard JDK version "HP-UX Java B.01.13.01" which will crash at a certain point when Visaj loads. Hewlett Packard released a bug fixed version of their JDK on November 19th, 1997 "HP-UX Java B.01.13.02" which seems to have the fixed the problems.

Download HP-UX Java B.01.13.02

Go to top of this page

Visaj crashes when I try and add a MenuBar to a Frame. Why?

As of 23/12/1997, there is a known bug with JDK1.1.5 or JDK1.2Beta2. If you try and add a MenuBar to a Frame, and the MenuBar has no menus on it, then the JDK will crash. This is a problem with the JDK and not Visaj.

At present the version of Visaj on our web site features a workaround for these bugs, which should be invisible to the user. It will in no way impact your designs or generated code.

Go to top of this page

I've used third party components in my design, but when I try to reload it Visaj throws the exceptions: NullPointerException and ClassNotFoundException. Why?

This can identify any number of problems. The most usual problems are:

A class or Bean in your design is not present in memory when you reload your design.
Make sure before you load your design that any Jars you loaded, are loaded now, and your CLASSPATH is set correctly. You should either use "Load Jar file...", available from the Palette menu, to load the component's Jar into memory, or exit Visaj and put the third party component into your CLASSPATH.
The version of class or Bean in your design is different from the version in your CLASSPATH or Jar.

Go to top of this page

If I remove a component from a design and then generate code, the component is still present in my code. Why?

The most likely cause of this is Invalid event bindings. An Invalid event binding occurs when you bind an event to a component in your design, and then delete the component. The event is kept just in case you were just Cut and Pasting your component to a different location in your hierarchy.

The solution to this problem is to view your event bindings, and delete all those which have the word [INVALID] beside them.

Go to top of this page

[Macintosh] My Macintosh hangs when using MRJ2.2 or later. What can I do?

Using Visaj versions 2.4.1 and earlier with MRJ 2.2 or later can cause occasional system hangs. If you are using MRJ 2.2 and are experiencing these problems you should download the patch for your Visaj installation from here. Please remember to do a 'Save File As' to save this file to disk.

The patch consists of two files, one being the launcher (to be placed along side the original), the other being a small jar file that should be placed into the lib folder of the Visaj installation.

Go to top of this page

[Windows] When I try and load demos.jar an error message appears saying, "Error reading demos.jar file". What's wrong?

When you install Visaj, some files are placed in a directory usually called C:\VJTMP. This directory contains the pre-installation files, and may be removed after installation. If you try and load demos.jar from that directory then the "error reading demos.jar file" error will be displayed.

You should only load files from the following directory:

C:\Program Files\IST\Visaj\

or wherever you installed Visaj.

Go to top of this page

[Windows] I can't put Swing/JFC onto my palette. Why?

To use Swing with Visaj, you need to place the Swing .jar files into your CLASSPATH.

Windows 95/98:

Edit C:\AUTOEXEC.BAT and add the following (single line) to the bottom of the file:
set CLASSPATH=<path to Swing directory>\swing.jar; <path to Swing directory>\windows.jar;%CLASSPATH%

Note: if you are using JFC1.1/Swing-1.0.1, you need only place swingall.jar into your CLASSPATH.

You should now reboot your machine, to allow Windows to reinitialize its variables.

WinNT:

Display your systems Environment settings by selecting the following:
```
      Start Menu->Settings->Control Panel->System
```
Click on the Environment Tab and either modify or create a new variable called CLASSPATH. Type the following (as a single line, no spaces) into the "value" box:
```
      <path to Swing directory>\swing.jar;<path to Swing directory>\windows.jar 
                        
```
Note: if you are using JFC1.1/Swing-1.0.1, you need only place swingall.jar into your CLASSPATH.
Click on the "Set", and then the "OK" button.
Note: You will need to close and reopen command windows and close and restart Visaj to ensure that the new environment variables take effect.

Once Visaj is loaded, select Merge Palette from the Palette menu, and specify the file JFC.palette which can be found in C:\Program Files\IST\Visaj\palettes. The JFC components will then be placed on your palette.

Note: if you are using JFC1.1/Swing-1.0.1, you should load the file JFC11.palette.

Go to top of this page

[HP-UX] [Solaris] I can't put Swing/JFC onto my palette. Why?

To use Swing with Visaj, you need to place the Swing .jar files into your CLASSPATH. Simply type the following:

    setenv CLASSPATH <path to Swing directory>/swing.jar:\
                     <path to Swing directory>/motif.jar:$CLASSPATH

Note: if you are using JFC1.1/Swing-1.0.1, you need only place swingall.jar into your CLASSPATH.

Once Visaj is loaded, select Merge Palette from the Palette menu, and specify the file JFC.palette which can be found in the Visaj/palettes directory. The JFC components will then be placed on your palette.

Note: if you are using JFC1.1/Swing-1.0.1, you should load the file JFC11.palette.

Go to top of this page

When I run wlmd it complains that has problems reading the license file. Why?

The "Problems reading license file ..." message can appear for a number of reasons, and the problem may not always be with the license file.

Below is a list of common problems and solutions:

wlmd will report the above error if the file you've specified can't be found. Please check you have specified the correct location for the license file, and that the file exists.
The error will also occur if you have any white space before the key in the license file. White space can be return characters, tabs, or spaces. These should be removed.
When you generate your Id by running "wlmd -u", wlmd produces a identifier which uniquely identifies your machine. The key that you are sent back, will only work for that machine. Running wlmd on a different machine, will produce the above error. If you wish to run Visaj on a different machine, please send us the Id for that machine and a new key will be sent to you.

If there is still a problem and none of the above solutions are relevant, please email support@ist-inc.com.

Go to top of this page

When starting Visaj I need to Configure Licensing. But when I enter my key into the text boxes it says,"Cannot connect, check proxy settings."

This error can appear for a number of reasons, and can either indicate an incorrect key, or that Visaj was unable to connect to the IST licensing server.

For an example key, "ABCD-69128634" you should place "ABCD" into the first text box and "69128634" into the second field.
Do not place the "-" anywhere in the textboxes.

If when connecting to the WWW you need to go through a Firewall or Proxy, then you will need to tell Visaj about this. Enter the proxy host and port into the appropriate text boxes. If you do not know your proxy host or server, then you can find out the details from Netscape or Internet Explorer.

Netscape version 3: From the Options menu, select "Network Preferences"...". Click on the "Proxies" tab, and then finally the "View" button. You should now see all the proxy hosts and ports. Copy the host and port number of the HTTP proxy into Visaj.

Netscape version 4+: Select Preferences from the Edit menu. Click on the arrow beside Advanced (it should expand to show Cache, Proxies, and Disk Space) and then click on the Proxies label. Press the "View" button and you should now see all the proxy hosts and ports. Copy the host and port number of the HTTP proxy into Visaj.

Internet Explorer: Select Options from the View menu, and then click on the Connection tab. You should now see all the proxy hosts and ports. Copy the host and port number of the HTTP proxy into Visaj.

Finally try connecting again.

Go to top of this page

[HP-UX] [Solaris] When I try and run Visaj inside Java Workshop, Visaj appears and then quickly dies. What's wrong?

You need to make sure of two things before you start.

You have installed the JavaWorkshop integration files for the appropriate platform
Visaj.jar is in your CLASSPATH.

When you run Visaj, a number of environment variables and command line options are specified. When you use JWS, these variables and options are not specified. To get Visaj running in Java Workshop you need to use the following command line:

      jws -classpath $CLASSPATH -Dvj.rootDir=<path to visaj directory>

Once inside JavaWorkshop, click on the Visaj icon in the toolbar to start Visaj.

Go to top of this page



	COPYRIGHT ©1995-2008 IST Limited. ALL RIGHTS RESERVED