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 your service updates at the latest level?
2. Have you researched your question or problem?
3. Are you receiving an error message?
4. 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
5. During installation, did Host On-Demand inform you that the GSKit install had failed?
6. Does the problem occur while configuring one of the following?
1. HTML files with the Deployment Wizard
2. the Redirector
3. TLS or SSH
4. the AS/400 proxy
5. Host On-Demand users and sessions
6. dynamically modified session properties (HTML overrides)
7. 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
8. Does the problem occur while downloading clients?
9. Is the problem associated with 3270, 5250, or VT emulation?
10. Is the problem associated with importing printer sessions from Personal Communications ?
11. Does the problem occur when starting or running the Service Manager?
12. Does the problem occur while printing?
13. Have you consulted the resources that are available to help you determine your problem?
14. Have you obtained the necessary traces to determine your problem?

1. Are your service updates at the latest level?

   You may be experiencing a problem for which there is an available fix. Refer to Service updates for more information.

2. Have you researched your question or problem?

   IBM provides numerous resources to help you find answers to questions and solutions to problems. Refer to Research your question or problem for more information.

3. 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.
4. 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 Information Center 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. i5/OS and OS/400 (iSeries) operating systems:
      1. Review installing on i5/OS and OS/400 operating systems.
      2. Use this checklist when using i5/OS and OS/400 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.
      2. Are you receiving an error message about the level of your C Set ++ Runtime Library?
   6. Solaris and HP-UX operating systems:
      1. Review installing on Solaris and HP-UX operating systems.
   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 i5/OS and OS/400 operating systems, review Installing the configuration servlet
   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.
    
5. During installation, did Host On-Demand inform you that the GSKit install had failed?

   Refer to Troubleshooting GSKit for more information.

6. 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.
   
7. 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 tutorial located in the online Host On-Demand V12.0.0 Knowledge Center.
      2. 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.
   
   
8. 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.
 
9. Is the problem associated with 3270, 5250, or VT emulation?
   1. Check the 3270 and 5250 emulation troubleshooting checklist.
   2. Check the VT emulation troubleshooting checklist.
 
10. 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.
 
11. Does the problem occur when starting or running the Service Manager?
    1. Is the Service Manager listening on the correct port (8999)? Refer to Host On-Demand functions and the ports they use in the Planning, Installing, and Configuring Host On-Demand guide for more information.
    2. Check the operating system's message logs or operator consoles.
    3. Check for Service Manager errors posted in NCoDServiceManager.txt.
    4. See the Java Console or Java log for messages about Java events.
    5. Use the Server trace and message facility to collect information about configuration services.
    6. Use the Service Manager trace facility to collect trace information about the Service Manager.
 
12. 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.
 
13. 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 V12 Knowledge Center.
    4. Review references to researching a question or problem.
 
14. Have you obtained the necessary traces to determine your problem?
    1. Use the Host On-Demand tracing checklist to obtain the necessary traces.