WebDocs - iSeries Edition Troubleshooting

From Support

Jump to: navigation, search


Suggestions

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.


Knowledge Base articles for WebDocs - iSeries Edition

-

1

3

4

5

B

C

D

E

F

H

I

L

N

P

R

S

U

W

X

Personal tools