Troubleshooting Guide

Table of contents

IBM eServer iSeries troubleshooting checklist

  1. Are you experiencing problems with your Host On-Demand installation?
  2. Confirm that the Service Manager is running.
  3. Check the Java level on the iSeries server.
  4. Check the job log for QHODSVM for error messages.
  5. Check the Start Job.
  6. Is the Web server configured properly?
  7. Are you experiencing printing problems with the iSeries server?
  8. Are you experiencing Host File Transfer problems with the iSeries server?

  1. Are you experiencing problems with your Host On-Demand installation?

  2. Confirm that the Service Manager is running.
    1. At the command line, enter WRKACTJOB.
    2. Look for the QSYSWRK SUBSYSTEM:
      • Job QHODSVM should be in TIMW state.
      • Job QJVACMDSVR should be in JVAW state.

  3. Check the Java level on the iSeries server.

    The following are the minimum levels of Group PTFs recommended.

    • V5R1: SF99069
    • V5R2: SF99169

    To verify your OS/400 operating system has the latest level of fixes for Java, do the following:

    • Use the Display Data Area command for OS/400 V5.1 and earlier, for example, DSPDTAARA QJAVA/SFnnnnn, Where SFnnnnn is the Group PTF identifier for the OS/400 Version/Release you are using.
    • For OS/400 V5R2, use the WRKPTFGRP PTFGRP(SF99169) command. Install is the correct status returned by this command when you apply the Group PTF.

    Java PTFs must be ordered separately from the cumulative fixes. PTFs can be found at http://www-912.ibm.com/supporthome.nsf/document/17403848.

  4. Check the job log for QHODSVM for error messages.
  5. Check the Start job.
    1. At the command line, enter GO HOD.
    2. Select option 1.
      • If no DATA - Enter the command DLTDTAARA QUSRSYS/QHODCFGD, then select option 1 again.
      • If the start job is still blank, repeat these steps.

  6. Is the Web server configured properly?

    Once you verify that the HTTP server is running, take the following steps:

    You may perform these steps through the Web interface, for example, http://fullyqualifiedsystemname:2001. You will need to start the HTTP ADMIN instance first.
    1. Stop the Web server using the following command:
      ENDTCPSVR *HTTP HTTPSVR(DEFAULT) 

      Note that this command assumes that you are using the default instance of the IBM HTTP server. If you created an instance other than the default supplied by IBM, substitute the name of the instance created for Host On-Demand in this command. For example, if you created an instance called HODWEBSVR, enter the following to stop the instance:

      ENDTCPSVR *HTTP HTTPSVR(HODWEBSVR) 
    2. Configure the Web server using the following command:
      WRKHTTPCFG 

      Make sure that active Enable POST and Enable GET entries exist and are not commented out. Add the following entry (there must be one space before the first slash (/) and after the first asterisk (*)):

      pass /hod/* /QIBM/ProdData/hostondemand/HOD/* 

      This entry creates an alias, hod, for the path to the Host On-Demand files. You must type it exactly as you typed the original directory names, matching upper and lower case.

      Press F3 to exit the WRKHTTPCFG tool.

    3. Start the Web server using the following command:
      STRTCPSVR *HTTP HTTPSVR(DEFAULT)
  7. Are you experiencing printing problems with the iSeries server?
    1. Refer to the iSeries printing problems checklist.

  8. Are you experiencing Host File Transfer problems with the iSeries server?
    1. Refer to Host File Transfer troubleshooting checklist.

    Top of page Table of contents