1. Shut down the WebZ system.

2. In the <WebZ_root>/logs directory, make backup copies of existing log files you want to keep in a separate directory and remove the remaining log files.

3. Restart the WebZ system.

4. Before completing any other tasks, set logging for the WebZ system to "TRACE_ALL" using the settrace command in the ssadmin interface. By default upon installation, the WebZ system tracks minimal system activity and stores it in the <WebZ_root>/logs directory. By setting the settrace command to "TRACE_ALL" for a specific log file(s), the WebZ system will track more detailed information about system and user activity. Below is a list of each type of log file that can be created and maintained by WebZ.

• access.serverLog
• jassi.serverLog
• jassi.userLog
• opserve.serverLog
• zbase.serverLog

In most instances, the JaSSI user and server log files are the most useful log files for troubleshooting the system.

5. Recreate the problem in the WebZ interface (e.g., perform the exact same search again, move to a specific HTML page to check what information is being sent through the URL, etc.).

6. Exit your session and logoff immediately after the problem occurs.

7. Shut down the WebZ system.

8. Move to the <WebZ_root>/logs directory and review the log files to locate information about the problem. Refer to the Tips for Navigating WebZ Log Files section below for recommendations on how to navigate through the log files to quickly find the problem.

Purpose

The DumpTool gadget can be used to track the information contained in a user hash table to ensure that the correct configuration information is being read into the WebZ system. The gadget will display user hash table information such as interface styles, available databases and topic lists, sessionid, user autho, HTTP messages, and the current HTML page.

Configuration File

The DumpTool gadget is defined in the [DumpTool] section of the interface style definition file.

Java Class

The Java class that builds this gadget is ORG.oclc.gadgets.dump.

Entity

The following entity should be added to the bottom of any HTML file before the </BODY> and </HTML> tags to execute the ORG.oclc.gadgets.dump class:

&StyleTable.DumpTool.gadget;

After adding this entity to the appropriate HTML file, view the page in the OBI to see the user state information.

Sample Output

The following is an example of the type of user state information that is displayed by the DumpTool gadget:

Purpose

The DumpRecord gadget can be used to easily identify which fields in a record are formatted for display. The WebZ system locates ASN.1/BER database records that match the criteria for a search and converts the records into Machine-Readable Cataloging (MARC) format for display. This gadget outputs the MARC fields, subfields, and data for each record in a color-coded format. The output allows you to quickly determine if the formatting classes defined for a specific database display the fields and types of information that you defined and expected to see.

Configuration File

The DumpRecord gadget is defined in the [DumpRecord] section of the DisplayGadgets.ini.

Java Class

The Java class that builds this gadget is ORG.oclc.gadgets.FormatRecords.

Entity

The following entity reference should be added to the bottom of any HTML file before the </BODY> and </HTML> tags to execute the ORG.oclc.gadgets.FormatRecords class:

&FmtDisplay.DumpRecord.gadget;

After adding this entity to the appropriate HTML file, view the page in the OBI to see the formatted MARC output for record results.

Sample Output

The following is an example of the type of record information that is displayed by the DumpRecord gadget. Notice that the MARC field is labelled in green, the MARC subfield is labelled in red, and the data contained in the field is black.