Troubleshooting Guide

Table of contents

Host On-Demand troubleshooting checklist

Before completing the troubleshooting checklist, consult the following resources to help you determine your problem:

Use the following checklist to identify and find solutions for problems that are occurring with Host On-Demand.

  1. Did you consult the resources that are available to help you determine your problem?
  2. Did you receive an error message?
  3. Check the installation of Host on-Demand on the server.
  4. Did the problem occur while installing the configuration servlet?
  5. Did the problem occur while installing the Deployment Wizard?
  6. Did the problem occur while configuring...
    1. HTML files with the Deployment Wizard?
    2. the Redirector?
    3. TLS, SSL, or SSH?
    4. the AS/400 proxy?
    5. Host On-Demand users and sessions?
  7. Did the problem occur while you were setting up dynamically modified session properties (HTML overrides)?
  8. Did the problem occur while using the Directory Utility?
  9. Did the problem occur while downloading clients?
  10. Did the problem occur while using Web Start client?
  11. Is the problem associated with 3270, 5250, or VT emulation?
  12. Is the problem associated with importing printer sessions from Personal Communications?
  13. Did the problem occur while using FTP/Secure FTP (sftp)?
  14. Did the problem occur while using Database On-Demand?
  15. Did the problem occur when you started or ran the Service Manager?
  16. Did the problem occur while printing, including problems using Zip Print?
  17. Did the problem occur while using Host File Transfer?
  18. Did the problem only occur with a client configured to use Web Start?
  19. Did the problem occur when using a Macintosh?
  20. Did the problem occur while using Web Express Logon?
  21. Did the problem occur while using a Host On-Demand API?
  22. Did the problem occur while using Host On-Demand's Accessiblity options?
  23. Did the problem occur while using Auto IME or On-The-Spot Conversion?

  1. Did you consult the resources that are available to help you determine your problem?

    1. See Review references to researching a question or problem in this Troubleshooting Guide.
  2.  
  3. Did you receive an error message?

    1. Did the message appear on the bottom of the emulator window? See the OIA (Operator Information Area) help.
    2. Did a pop-up message appear? See the error message help.
    3. Did a message from the Host On-Demand Service Manager appear? See the Service Manager help.
    4. Did a Java event occur? See the Java Console or Java log for messages about Java events.
  4.  
  5. Check the installation of Host on-Demand on the server.

    1. zOS (zSeries) operating systems:
      1. Review the Program Directory provided with the media for the z/OS operating system on zSeries systems. The latest version can be found in the Host On-Demand InfoCenter located on the Host On-Demand Support Web site, http://www.ibm.com/software/webservers/hostondemand/support.html.)
      2. Use this checklist when using z/OS or s390 operating systems.
    2. OS/400 (iSeries) operating systems:
      1. Review installing on OS/400 operating systems.
      2. Use this checklist when using OS/400 (iSeries) operating systems
    3. Microsoft Windows operating systems:
      1. Review installing on Microsoft Windows operating systems.
      2. Use this checklist when using Microsoft Windows operating systems.
    4. Linux operating systems:
      1. Use this checklist when using a Linux operating system.
    5. AIX operating systems:
      1. Review installing on AIX operating systems.
    6. Solaris, HP-UX:
      1. Review installing on the Solaris, and HP-UX.
    7. OS/2 operating systems:
      1. Review installing on OS/2 operating systems.
    8. Novel Netware operating systems:
      1. Review installing on Novell NetWare operating systems.
     
  6. Did the problem occur while installing the configuration servlet?

    1. For Microsoft's Windows and AIX operating systems, review installing the configuration servlet on the Windows and AIX operating systems.
    2. For OS/400 operating systems, review Installing the configuration servlet on the OS/400 (iSeries) operating systems
  7.  
  8. Did the problem occur while installing the Deployment Wizard?

    1. Review Installing the Deployment Wizard from the Host On-Demand CD
    2. Review Downloading the Deployment Wizard installation image from a Host On-Demand server.
  9.  
  10. Did the problem occur while configuring ...

    1. HTML files with the Deployment Wizard?
      1. Review Using the Deployment Wizard for an overview of how to use the Deployment Wizard.
      2. Check theDeployment Wizard troubleshooting checklist.
    2. the Redirector?
      1. Check the Redirector troubleshooting checklist.
      2. See the Server trace and message facility for instructions on how to collect information about the Redirector and configuration services.
    3. TLS, SSL, or SSH?
      1. Review your TLS or SSL configuration and setup. See Configuring clients to use client authentication.
      2. See SSH Configuration.
      3. Check the Security troubleshooting checklist.
    4. the AS/400 proxy? Review the information on the OS/400 Proxy Server.
    5. Host On-Demand users and sessions?
      1. Review Basic Configuration Steps for an overview of Host On-Demand configuration.
      2. Review Managing users and groups for an overview of how to manage users and groups.
      3. Review Working with sessions for an overview of how to manage sessions.
  11.  
  12. Did the problem occur while you were setting up dynamically modified session properties (HTML overrides)?

    1. See Modifying session properties dynamically.
  13.  
  14. Did the problem occur while using the Directory Utility?
    1. See Using the Directory Utility in the online help.
    2. For specific issues concerning running Directory Utility on the Novell platform, see the Directory Utility troubleshooting checklist.

  15. Did the problem occur while downloading clients?

    1. See Requirements.
    2. See Planning for Deployment.
    3. See Planning for Java 2 on the client.
    4. See Upgrading from earlier versions of Host On-Demand.
    5. See Upgrading from Java 1 to Java 2 on the client.
    6. Check the Client troubleshooting checklist.
    7. Check the Macintosh troubleshooting checklist.
  16.  
  17. Did the problem occur while using Web Start client?

    1. See Web Start Client.
    2. Review Web Start Settings.
    3. Check the Web Start client troubleshooting checklist.
  18.  
  19. Is the problem associated with 3270 or 5250 emulation?

    1. Check the 3270 and 5250 Emulation troubleshooting checklist.
    2. Check the VT Emulation Checklist.
  20.  
  21. Is the problem associated with importing settings from Personal Communications?

    1. Review the Importing Personal Communications 3270 printer sessions in the online help.
    2. See the Importing settings from Personal Communications in this guide.
  22.  
  23. Did the problem occur while using FTP/Secure FTP (sftp)?

    Check the following:

    1. Secure FTP troubleshooting checklist
    2. SSH FTP session fails to start.
    3. The client is not connecting.
    4. The classes.zip CLASSPATH entry is causing a connection problem.
    5. The cursor disappears from the user ID field on the FTP login window.
    6. The FTP client fails to connect to OS/2 FTP server using Japanese Windows and Netscape.
  24.  
  25. Did the problem occur while using Database On-Demand?

    1. Review Database On-Demand overview in the online help.
    2. Check the client does not connect checklist
    3. Check if the classes.zip CLASSPATH entry may cause a connection problem.
  26.  
  27. Did the problem occur when you started or ran the Service Manager?

    1. Check the operating system's message logs or operator consoles.
    2. Check for Service Manager errors posted in NCoDServiceManager.txt.
    3. See the Java Console or Java log for messages about Java events.
    4. Use the Server trace and message facility to collect information about configuration services.
    5. Use the Service Manager trace facility to collect trace information about the Service Manager.
  28.  
  29. Did the problem occur while printing, including problems using Zip Print?

    1. Check the printer status window of the printer session to view printer status and messages.
    2. See Printing troubleshooting checklist.
    3. See the printer datastream information in the Host Printing Reference.
    4. See the log file for the printer definition table.
    5. See the Zip Print troubleshooting checklist.
  30.  
  31. Did the problem occur while using Host File Transfer?

    1. Review Host File Transfer in the online help.
    2. Check the Host File Transfer troubleshooting checklist.
  32.  
  33. Did the problem only occur with a client configured to use Web Start?

    See the Web Start client troubleshooting checklist.

  34. Did the problem occur when using a Macintosh?

    See the Macintosh troubleshooting checklist.

  35. Did the problem occur while using Web Express Logon?

    1. Review the troubleshooting section of the Web Express Logon Reference.
    2. Review the Web Express Logon white paper (opens PDF) on the Host On-Demand library page.
    3. Review the Web Express Logon tutorial located in the online Host On-Demand V8 InfoCenter.
  36.  
  37. Did the problem occur while using a Host On-Demand API?

    1. Macros:
      1. Review the Macro Programming Guide.
      2. See the Macro troubleshooting checklist.
  38.  
  39. Did the problem occur while using Host On-Demand's Accessiblity options?

    1. Review Accessibility in the online help.
    2. See the Accessibility troubleshooting checklist.
  40. Did the problem occur while using Auto IME or On-The-Spot Conversion?

    See Auto IME and On-The-Spot Conversion support information.

Top of page Table of contents