Troubleshooting reports in the rich client

If the embedded viewer does not work correctly, an Applet CMEReportJTViewerApplet not initiated error message may be displayed in the browser status line. If so, open the Java console in the system tray and check for Java exception codes that may indicate the cause of the problem, as follows:

• NoClassDefFoundError Java cannot access the embedded viewer JAR files. This error is identified by an error message similar to the following: Copyjava.lang.NoClassDefFoundError: com/ugs/plmvis/components/<AnyClassName> Possible solutions:

Check the Java console and verify the correct classpath is set, as described previously. Ensure the SingleEmbeddedViewer.jar file is included in the classpath. To view the classpath, open the Java console and type s to dump all system properties. Note the displayed value of the javaplugin.vm.options property and check that it contains the classpath string you entered when you configured the Java console.

If the classpath is not correct, there may be more than one Java control panel; you may not have modified the correct one. Choose Start→Settings→Control Panel and select the button that matches the version number in the Java console window. Modify the classpath for this Java control panel.

Verify there are no typographical errors or unnecessary spaces in the classpath definition. For example, ensure there is an = character between -classpath and the path name. Also, if you have multiple classpath entries, ensure they are separated by ; characters.

If none of the solutions work, copy the SingleEmeddedViewer.jar file manually from PV _Base_Dir\Program to JRE_HOME\lib\ext folder. Close all Internet Explorer browser instances, restart the browser and try again.

• NoClassDefFoundError: com/eai/visweb/components/... You are trying to run reports from a previous version of Teamcenter. You should convert your reports to use the current embedded viewer.

• Could not load library jawt.dll Java does not have permission to execute the jawt.dll file. Verify that you have updated the Java security policy file correctly.

• VerifyError The JRE version is incompatible with the HTML page. This error is identified by an error message similar to the following: Copyjava.lang.VerifyError: (class:CMEReportJTViewerApplet, method: destroy signature: ()V) Incompatible object argument for function call at java.lang.Class.getDeclaredConstructors0(Native Method) Possible solutions:

Ensure you have installed the supported JRE version, as specified in the installation guide for your operating system, and update it if necessary.

Verify you have installed the correct version of the CMEReportJTViewer.jar file and update it if necessary.

• Viewer window has no image The viewer window shows a green background and the icons are visible, but there is no image in the window. To resolve this problem, try right-clicking in the JT window and choosing All On or Fit All from the menu.

• EXCEPTION_ACCESS_VIOLATION The version of the embedded viewer you have installed is not compatible with the CMEReportJTViewer.jar file in the reports directory. This error is identified by an error message similar to the following: Copy`An unexpected exception has been detected Unexpected Signal : EXCEPTION_ACCESS_VIOLATION (0xc0000005) occurred at PC=0x6FD24D6 Function=Java_com_teamcenter_visweb_components_PMI3D_nativeHideEntity+0x1D9 Library=C:\WINDOWS\system32\VisWeb.dll Current Java thread: at com.teamcenter.visweb.components.PrimaryViewer.nativeDestroyViewerDone (Native Method) at com.teamcenter.visweb.components.Viewer3D.shutdown(Viewer3D.java:718)

  • locked <0x108c3938> (a java.lang.Object) at com.teamcenter.visweb.components.Module.removeNotify(Module.java:285)` Possible solutions:

Ensure you have the correct version of the embedded viewer. You must also update the PATH environment variable and modify the classpath for the new version.

Ensure you have the latest version of the CMEReportJTViewer.jar file in the reports directory.

• java.security.AccessControlException If you see a blank HTML page with the following error in the Java console window, the Java policy file is not edited correctly. Check the file and edit. Copyjava.security.AccessControlException: access denied (java.lang.RuntimePermission getenv.JRE_HOME) at java.security.AccessControlContext.checkPermission(Unknown Source) at java.security.AccessController.checkPermission(Unknown Source) at java.lang.SecurityManager.checkPermission(Unknown Source) at java.lang.System.getenv(Unknown Source) at com.ugs.plmvis.components.VisView.loadLibraries(VisView.java:2665) at com.ugs.plmvis.components.VisView.init(VisView.java:2580) at com.ugs.plmvis.components.VisView.<init>(VisView.java:241) at com.ugs.plmvis.components.VisView.getInstance(VisView.java:205)

• To help protect your security, IE has restricted… message If you see a To help protect your security, Internet Explorer has restricted this file from showing active content that could access your computer. Click here for options… message in a yellow box instead of the viewer, you have not allowed Internet Explorer to run active content. Repeat the browser configuration procedure.

• Java Applet Support Required... message If you see a Java Applet Support Required (If you are seeing this message, you need to turn on applet support in your browser) message in a box instead of the viewer, you have not configured applet tag support. Repeat the browser configuration procedure.

• Nothing is displayed in Firefox If only a single box is displayed in Firefox, you have not enabled Java. Choose Tools→Options in Firefox, click the Content button, and ensure the Enable Java check box is selected.