Z and I Emulator for Web troubleshooting checklist

Use the following checklist to identify and find solutions for problems that are occurring with Z and I Emulator for Web.

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 Z and I Emulator for Web server
   2. the configuration servlet
   3. the Deployment Wizard
5. 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. Z and I Emulator for Web users and sessions
6. dynamically modified session properties (HTML overrides)
6. 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 Z and I Emulator for Web API
   9. Z and I Emulator for Web's Accessiblity options
   10. Auto IME or On-The-Spot Conversion
7. Does the problem occur while downloading clients?
8. Is the problem associated with 3270, 5250, or VT emulation?
9. Is the problem associated with importing printer sessions from Z and I Emulator for Windows ?
10. Does the problem occur when starting or running the Service Manager?
11. Does the problem occur while printing?
12. Have you consulted the resources that are available to help you determine your problem?
13. 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?

   HCL 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 Z and I Emulator for Web 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 Z and I Emulator for Web 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 Z and I Emulator for Web Information Center located on the Z and I Emulator for Web Support Web site, https://www.hcltech.com/software/support.
      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 Z and I Emulator for Web CD
      2. Review Downloading the Deployment Wizard installation image from a Z and I Emulator for Web server.
    

5. 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 Z and I Emulator for Web 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. Z and I Emulator for Web users and sessions
      1. Review Basic Configuration Steps for an overview of Z and I Emulator for Web 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.
   
6. 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. Check the Web Start client troubleshooting checklist.
   3. FTP/Secure FTP (sftp)
      1. Review documentation about FTP and Secure FTP.
      2. 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 documentation located in the Z and I Emulator for Web infocenter
   8. a Z and I Emulator for Web API
      1. Macros:
         1. Review the Macro Programming Guide.
         2. See the Macro troubleshooting checklist.
      2. Host Access Class Library Toolkit:
         1. Review the Host Access Class Library Toolkit.
         2. See the Host Access Class Library Toolkit troubleshooting checklist.
   9. Z and I Emulator for Web'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.
   
   
7. 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 Java 1 to Java 2 on the client.
   5. Check the Client troubleshooting checklist.
   6. Check the troubleshooting checklist for Macintosh users.
 
8. 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.
 
9. Is the problem associated with importing settings from Z and I Emulator for Windows?
   1. Review the Importing Z and I Emulator for Windows 3270 printer sessions in the online help.
   2. See the Importing settings from Z and I Emulator for Windows in this guide.
 
10. Does the problem occur when starting or running the Service Manager?
    1. Is the Service Manager listening on the correct port (8999)? Refer to Z and I Emulator for Web functions and the ports they use in the Planning, Installing, and Configuring Z and I Emulator for Web 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.
 
11. 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.
 
12. 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 https://www.hcltech.com/software/support for more information.
    3. Search the Z and I Emulator for Web documentation for keywords in the online Z and I Emulator for Web v1.0 Infocenter.
    4. Review references to researching a question or problem.
 
13. Have you obtained the necessary traces to determine your problem?
    1. Use the Z and I Emulator for Web tracing checklist to obtain the necessary traces.