Platypus Partners' Home Page

 
JET 3270 3.4E
   
   

General troubleshooting

Working with installed class files

Getting browser and virtual machine versions

 

Table of Contents

System Requirements

Installation

Upgrading

Removal

Configuration

Settings and Preferences

Scripting

Printing

Keyboard Mapping

Troubleshooting

Reference

 

How To Guide

   
JET 3270 Documentation > Troubleshooting

General troubleshooting

Solutions to the following common problems are provided in this page:

  • Doesn't run under all web browsers
  • New version of JET 3270 is still working as the old version did
  • Applet won't load under Internet Explorer
  • Can't get past "Connecting..." screen
  • Error when printing under Communicator under Linux
  • Two applets started after double-clicking under Communicator under Windows
  • Black rectangles on Session Settings and Preferences windows under Communicator under Unix
  • Keys not processed under Communciator under Unix
  • Ctrl+Pause received as Ctrl under Communicator under Linux
  • Doesn't run under all web browsers

    Description: JET 3270 does not work correctly running under Internet Explorer 3.0 or Communicator 4.04.

    Cause: JET 3270 does not support these browsers.

    Corrective Action: Run JET 3270 under a supported environment.

    New version of JET 3270 is still working as the old version did

    Description: Even though a new version of JET 3270 has been successfully installed, JET 3270 is still behaving exactly as it did for the previous version

    Cause:

    1. Browsers store loaded applets in their memory, and continue to use this code even if the Reload button is clicked, or the memory and/or disk cache is cleared.

    2. The most recently installed version of JET 3270 may have an older version number than the previously installed version (for example, you previously installed an early release but recently "fell back" to an older generally available release). In this case Internet Explorer and the SmartUpdate scritps provided will not install the older JET 3270 class files.

    3. The "useseslibarary" applet parameter in the web page you are using does not match the version number of the new version. Internet Explorer continues to use JET 3270 class files installed previously.

    Corrective Action:

    1. Restart your browser, and reload the web page or page on the local hard drive that contains the reference to the JET 3270 applet. Delete all old versions of JET software.

    2. Remove the installed class files, for instructions see Working with installed class files. Then restart your browser and reload the web page that loads the JET 3270 applet.

    3. Change the "useslibraryversion" applet parameter in all of your web pages to match the distribution unit version of the new version of JET 3270. See Creating a web page which will load JET 3270 for details.

    Applet won't load under Internet Explorer

    Description: Microsoft Internet Explorer was unable to load the JET 3270 applet.

    Cause:

    1. The browser has been configured to disable its Java support

    2. The browser could not find the JET 3270 applet files on the web server or the local hard drive

    3. A network communication error occurred while the browser was loading the applet files

    Corrective Action:

    1. Enable Java support. To do this, from the "View" menu select "Options...", select the "Security" tab. Click the "Enable Java Programs" box (in the "Active content" area) so that a tick is placed there.

    2. Ensure that the <APPLET> tag within the web page that was loaded correctly refers to com.platypuspartners.jet3270.JET3270.class and JET3270.cab. Refer to Configuration for more information.

      Ensure that all of the JET 3270 class files are correctly installed on the web server or local hard drive

    3. Ensure that there is a stable connection between the browser and the web server

    Can't get past "Connecting..." screen

    Description: The JET 3270 applet starts, and displays a screen containing the text "Connecting...", but does not get any further.

    Cause:

    1. The Domain Name Server used by the browser may be down or unable to resolve the name of the IBM host system.

    2. There may be no TN3270 Server program listening on the specified port on the IBM host system.

    3. A network Firewall may be preventing access to the IBM host system.

    Corrective Action:

    1. Ensure that the Domain Name Server used by the browser is active and able to resolve the name of the IBM host system.

    2. Ensure that there is a Telnet Server program listening on the port to which the JET 3270 applet is trying to connect. The default port number is 23. The <APPLET> tag that refers to the JET 3270 applet may override this value by containing a <PARAM NAME="port" ....> tag. Refer to Configuration for more information.

    3. Ensure that there is no firewall preventing the system on which the browser is running from reaching the IBM host system.

    Error when printing under Communicator under Linux

    Description: A dialog box with a message like "Could not execute print command: [Ljava.lang.String;@805202f" appears after clicking Print on the print dialog box when running JET 3270 under Communicator on Linux. Clicking OK dismisses the dialog box but the terminal screen is not printed.

    Cause: Communicator for Linux does not support printing from Java applets properly.

    Corrective Action:

    Login as root on the Linux machine. Create a /usr/bin/lp file with the following contents:

    #!/bin/sh
    if echo $1 | grep '^-d' > /dev/null
    then
            modified="`echo $1 | sed s/^-d/-P/`"
            shift
            set -- "$modified" "$@"
    fi
    if echo $1 | grep '^-t' > /dev/null
    then
            modified="`echo $1 | sed s/^-t/-J/`"
            shift
            set -- "$modified" "$@"
    fi
    if echo $2 | grep '^-t' > /dev/null
    then
            original1="$1"
            modified="`echo $2 | sed s/^-t/-J/`"
            shift; shift
            set -- "$original1" "$modified" "$@"
    fi
    exec /usr/bin/lpr "$@"
    Set the file's ownership and permissions with the following commands:
    chown root:root /usr/bin/lp
    chmod 755 /usr/bin/lp
    This workaround does not handle the "Copies" or "Print Command Options" fields on the print dialog box having values other than their defaults.

    Two applets started after double-clicking under Communicator under Windows

    Description: Double-clicking an HTML file to start Communicator and load JET 3270 under Windows results in two JET 3270 applets running.

    Cause: The default "open" action performed by Windows when opening an HTML file when Communicator is the default browser passes the file both as a command line argument and as a DDE message. Because of this Communicator loads the HTML page twice, resulting in two JET 3270 applets.

    Corrective Action:

    Edit the default open action so that it does not use DDE using the following instructions. Start Windows Explorer. From the View menu select Options. Select the File Types tab. Find Netscape Hypertext Document in the list of registered file types, select it and click Edit. Select the open action and click Edit. Remove the tick from the Use DDE check box. Click OK, Close and Close.

    Black rectangles on Session Settings and Preferences dialog boxes under Communicator under Unix

    Description: Solid black rectangles are displayed at the top of the right hand side of the Session Settings and Preferences windows under Communicator under Linux in an 8-bit colour mode. The rectangles do not show the title of the current category.

    Cause: With an 8-bit colour mode Communicator does not allocate different colours to the category title text and background colours, both are black.

    Corrective Action:

    1. Change to a 16-bit or higher colour mode.

    2. Start Communicator specifying the "-install" command line option. Communicator will install a private colour map and allocate different colours to the text and background. However, when Communicator or JET windows are active colours in other application's windows will be incorrect and vice versa.

    Keys not processed under Communicator under Unix

    Description: Keys pressed are not processed after the JET 3270 window is resized (for example, as a result of connecting or changing between default and alternate screen sizes) under Communicator under Unix.

    Cause: The problem is due to a bug in Communicator. After the JET 3270 window is resized it loses the keyboard focus.

    Corrective Action: Click in the terminal window to restore key processing whenever the problem occurs.

    Ctrl+Pause received as Ctrl under Communicator under Linux

    Description: The Ctrl+Pause key combination is received as Ctrl by JET 3270 under Communicator under Linux. For example, when the Add Key Combination dialog box is open typing Ctrl+Pause (pressing the Pause key while holding the Ctrl key) displays Ctrl next to Key Combination.

    Cause: Under some versions of Linux the default X keymap does not map the keycode generated by Ctrl+Pause to a keysym. This means Communicator cannot identify Ctrl+Pause properly to pass it to JET 3270.

    Corrective Action: Change the X keymap so that the Ctrl+Pause keycode is mapped to the Pause keysym. Under Red Hat 6.0 the keycode is 114. The following command changes the keymap:

    xmodmap -e "keycode 114 = Pause"
    To make this change permanent place the command or the string in quotes in the appropriate X init file. For a default Red Hat 6.0 installation put the string in quotes in .Xmodmap in your home directory.

     

    support@
    platypuspartners.com

    USA Office:
    +1.303.448.1559

    Australia Office:
    +61.2.9558.2549

    Platypus Partners Home  |   Support  |   Contact Platypus Partners



    Copyright 2002 Platypus Partners.  All Rights Reserved. 

    Java and all Java-based trademarks and logos are trademarks or registered trademarks of
    Sun Microsystems, Inc. in the United States and other countries.