WebDocs - iSeries Edition Troubleshooting
From Support
Suggestions
- Are all required programs installed?
- Is it licensed?
If the WebDocs web interface will not load
- See if your web instance is running:
WRKSBSJOB QHTTPSVR
You should see 4 or more jobs with your instance name, and at least one of each of the following functions:
Job User Type -----Status----- Function APACHEDFT QTMHHTTP BATCHI ACTIVE PGM-QZHBMAIN APACHEDFT QTMHHTTP BATCHI ACTIVE PGM-QZSRLOG APACHEDFT QTMHHTTP BATCHI ACTIVE PGM-QZSRHTTP APACHEDFT QTMHHTTP BATCHI ACTIVE PGM-QZSRCGI
If there are none, check the QEZJOBLOG for a spool file describing the error:
WRKOUTQ QEZJOBLOG
If there is only one (usually a PGM-QZHBMAIN), put an 8 on it (Work with Job Spooled Files) and put a 5 on the spool file to view the log.
In either of these cases, typically the log will show an error with the configuration file. Note the line number that the error is on, and then view the log file. The log file is located at:
WRKLNK OBJ('/www/apachedft/conf')
Put a 5 on 'logs' and then a 2 on the httpd.conf file to edit. Alternately, access your
If there is a problem while using the WebDocs web interface
- When troubleshooting a problem with the web interface, take a look at the logs for the CGI instance on the AS/400. This can be done by running the command:
WRKSBSJOB QHTTPSVR
Your results should look something like this:
Opt Job User Type -----Status----- Function
WEBDOCSNEW QTMHHTTP BATCHI ACTIVE PGM-QZSRCGI
Please note that your job names may vary. Put a 5 in front of the job to work with it, and choose option 10 to look at it's job log. Pressing F18 (Shift+F6) will drop you to the bottom of the joblog, which should show you the error message.
- In addition, Apache keeps logs under it's directory on the IFS, which can be viewed using the command:
WRKLNK OBJ('/www/<your server name>/logs')
- For debugging or to better understand what database queries are being made, you can enable the DEBUGSQL by changing it's value to *YES. This will display the SELECT statement on the top of the page in the WebDocs browser session. Please remember that this is a global change; all your users will see the SELECT statement if DEBUGSQL is enabled.
If you need Technical Support
Have the following information on hand before you call Technical Support.
