Net.Data Administration and Programming Guide for OS/400

Appendix A. Problem Analysis

This section describes problem analysis techniques you can use when debugging Net.Data.

For the following problems, assume that the Net.Data CGI-BIN program object, DB2WWW, has been moved to a library named WWWCGI, where CGI-BIN programs reside.

• Symptom: Error 500:

      Bad script request -- '/QSYS.LIB/WWWCGI.LIB/DB2WWW.PGM/
      QSYS.LIB' not executable
  

  Cause: An Exec rule is incorrect.

  Exec /QSYS.LIB/WWWCGI.LIB/DB2WWW.PGM/*
  Exec /qsys.lib/wwwcgi.lib/db2www.pgm/*
  

  Solution: Specify an Exec rule that supplies only the path to the DB2WWW program. For example:

  Exec /QSYS.LIB/WWWCGI.LIB/*
  Exec /qsys.lib/wwwcgi.lib/*
  

• Symptom: Error 404:

      Not found - file doesn't exist or is read protected
      Even tried multi"
  

  Cause: An Exec rule is missing.

  Solution: Specify an Exec rule that supplies the path to the DB2WWW program in both upper and lower case. For example:

  Exec /QSYS.LIB/WWWCGI.LIB/*
  Exec /qsys.lib/wwwcgi.lib/*
  

• Symptom: Error 403:

      Forbidden - by rule
  

  Cause: A Map or Exec rule is missing or incorrect.

  Solution: Specify a Map and Exec rule for the DB2WWW program in both upper and lower case. For example:

  Map /cgi-bin/db2www/* /QSYS.LIB/WWWCGI.LIB/DB2WWW.PGM/*
  Map /CGI-BIN/DB2WWW/* /QSYS.LIB/WWWCGI.LIB/DB2WWW.PGM/*
  Exec /QSYS.LIB/WWWCGI.LIB/*
  

• Symptom: The configuration statements in the Web server configuration file are correct but Net.Data is not processing macro files correctly. There are several possible causes and solutions:

  • Cause: The Map, Exec, or Pass rules are not in the correct order.

    Solution: When a URL is evaluated against a Map, Exec or Pass rule, it is processed based on the first matching rule. Ensure that the statement to be evaluated is not remapped or altered prior to reaching the desired rule. Also, make sure that the user does not have a Pass /* statement in the configuration file.

  • Cause: User profile QTMHHTP1 does not have proper authority to access Net.Data macros.

    Solution: All CGI-BIN programs run under the user profile QTMHHTP1. The QTMHHTP1 user profile must be granted authority to all objects that Net.Data accesses while processing a Net.Data macro.

  • Cause: The Path statements in the Net.Data initialization file are not correct.

    Solution: Ensure that either the object references are fully qualified or the Net.Data initialization file has the proper path statements. Net.Data uses the path statements in the initialization file (if there is one) to resolve to any Net.Data macro or executable references in the Net.Data macro that is being processed. If the object references are not fully qualified and the path statements in the initialization file are not correct, Net.Data indicates that the object being referenced is not found.