Troubleshooting

Error reporting

Internal errors typically leave messages of the form

java.lang.NullPointerException

at pmclass.applications.pmgateway.PMgatewayDefaults.getConvertionSettings(PMgatewayDefaults.java:143)
at pmclass.applications.pmgateway.PMgatewayFrame.convert(PMgatewayFrame.java:854)
at pmclass.applications.pmgateway.PMgatewayFrame.run(PMgatewayFrame.java:911)
at java.lang.Thread.run(Thread.java:484)

in the command window.

To allow PMOD Technologies tracking the problem please log into the support section on the www.pmod.com website and fill the error message together with a description into the problem report form.

License Errors

Some of the most likely license errors are:

• If the license file has not been copied to the right directory, you will see a message dialog
  
  Please make sure you copy pstarter.lcs to Pmod3.1/properties/system/lcs.
• If the license file has been modified somehow, you will see a message
  License Error. Invalid license file (2)
  Please try extracting pstarter.lcs again from your e-mail without any modifications.
• If the USB key cannot be interrogated, because it is not connected or because the driver installation is not up to date, you will see an error message Hardware license key not accessible, with additional details.
  Please make sure that the USB key is connected and the installation was done as described. The driver installation may have to be repeated after an operating system upgrade.

Database Access Fails

If the console window shows an error message such as

Projects list not found (1)
Projects list not found (2)
pmclass.lib.pmdisk.PMdicomDbDialog: Cannot connect to this database.
Unable to connect to any hosts due to exception: java.net.ConnectException: Connection refused: connect

The most likely reason is that a firewall blocks communication between java.exe and mysqld-nt.exe (if mySQL is used). A brute force method for tests is disabling the firewall and try again. However there may also be a method to selectively allow internet access for the two executables involved. Shown below is the appropriate configuration for Norton Internet Security firewall.

Generation of Quicktime Movies fails

In some installations the generation of Quicktime movies fails because of library problems. In these cases is therefore recommended to install the Java Media Framework (JMF) which can be downloaded from:
http://java.sun.com/products/java-media/jmf/2.1.1/download.html

Reading of Compressed DICOM images fails

In some installation the reading of compressed DICOM data fails because of library problems. It is therefore recommended to install the Java Advanced Image I/O Tools which can be downloaded from:
https://jai-imageio.dev.java.net/binary-builds.html

Additional Solutions

For checking additional solutions please consult the Q&A area of the PMOD website.