Host On-Demand troubleshooting checklist

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

1. Are you receiving an error message?
2. Does the problem occur while installing or using one of the following?
   1. the Host on-Demand server
   2. the configuration servlet
   3. the Deployment Wizard
3. Does the problem occur while configuring one of the following?
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
6. dynamically modified session properties (HTML overrides)
4. Does the problem occur while using one of the following?
   1. the Directory Utility
   2. the Web Start client
   3. FTP/Secure FTP (sftp)
   4. Database On-Demand?
   5. Host File Transfer?
   6. a Macintosh operating system
   7. Web Express Logon
   8. a Host On-Demand API
   9. Host On-Demand's Accessiblity options
   10. Auto IME or On-The-Spot Conversion
5. Does the problem occur while downloading clients?
6. Is the problem associated with 3270, 5250, or VT emulation?
7. Is the problem associated with importing printer sessions from Personal Communications ?
8. Does the problem occur when starting or running the Service Manager?
9. Does the problem occur while printing?
10. Have you consulted the resources that are available to help you determine your problem?
11. Have you obtained the necessary traces to determine your problem?

1. Are you receiving an error message?
   1. Does the message appear on the bottom of the emulator window? See the OIA (Operator Information Area) help.
   2. Does a pop-up message appear? See the error message help.
   3. Does a message from the Host On-Demand Service Manager appear? See the Service Manager help.
   4. Does a Java event occur? See the Java Console or Java log for messages about Java events.
 
2. Does the problem occur while installing or using one of the following?
   1. the Host On-Demand 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.
   2. 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
   3. 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.
    
3. Does the problem occur while configuring one of the following?
   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 the Deployment 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. Review the Redirector chapter in the Planning, Installing, and Configuring Host On-Demand guide.
   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
      1. 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.
   6. dynamically modified session properties (HTML overrides)
      1. See Modifying session properties dynamically.
   
4. Does the problem occur while using one of the following?
   1. 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.
   2. Web Start client
      1. See Web Start Client.
      2. Review Web Start Settings.
      3. Check the Web Start client troubleshooting checklist.
   3. FTP/Secure FTP (sftp)
      1. Review documentation about FTP.
      2. Review documentation about Secure FTP.
      3. See the Secure FTP troubleshooting checklist
   4. 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.
   5. Host File Transfer
      1. Review Host File Transfer in the online help.
      2. Check the Host File Transfer troubleshooting checklist.
   6. a Macintosh
      1. See the Macintosh troubleshooting checklist.
   7. Web Express Logon
      1. Review the Web Express Logon white paper (opens PDF) on the Host On-Demand library page.
      2. Review the Web Express Logon tutorial located in the online Host On-Demand V8 Information Center.
      3. Review the troubleshooting section of the Web Express Logon Reference.
   8. a Host On-Demand API
      1. Macros:
         1. Review the Macro Programming Guide.
         2. Review the chapter about macros in the Host Access Client Package V4 Update Redbook (SG24-6182-02), located on the IBM Redbook Web site at http://www.redbooks.ibm.com.
         3. See the Macro troubleshooting checklist.
      2. Programmable Host On-Demand:
         1. Review the Programmable Host On-Demand book.
         2. See the Programmable Host On-Demand troubleshooting checklist.
      3. Host Access Class Library Toolkit:
         1. Review the Host Access Class Library Toolkit.
         2. See the Host Access Class Library Toolkit troubleshooting checklist.
   9. Host On-Demand's Accessibility options
      1. Review Accessibility in the online help.
      2. See the Accessibility troubleshooting checklist.
   10. Auto IME or On-The-Spot Conversion
       See Auto IME and On-The-Spot Conversion support information.
   
   
5. Does 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 troubleshooting checklist for Macintosh users.
 
6. Is the problem associated with 3270, 5250, or VT emulation?
   1. Check the 3270 and 5250 Emulation troubleshooting checklist.
   2. Check the VT Emulation Checklist.
 
7. 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.
 
8. Does the problem occur when starting or running 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.
 
9. Does the problem occur while printing?
   1. See the Host Printing Reference.
   2. See Printing troubleshooting checklist.
   3. See the ZipPrint troubleshooting checklist.
   4. Check the printer status window of the printer session to view printer status and messages.
   5. See the printer datastream information in the Host Printing Reference.
   6. See the log file for the printer definition table.
 
10. Have you consulted the resources that are available to help you determine your problem?
    1. See Researching a question or problem in this Troubleshooting Guide.
    2. Search the IBM Websphere Host On-Demand Web site for Technotes and available fix packs.
    3. Search the Host On-Demand documentation for keywords in the online Host On-Demand V8 Information Center.
    4. Review references to researching a question or problem.
 
11. Have you obtained the necessary traces to determine your problem?
    1. Use the Host On-Demand tracing checklist to obtain the necessary traces.