SWAN Concentrator and WAN Subsystem Troubleshooting Guide

Installing and Using the SWAN Tools
SWAN Concentrator and WAN Subsystem Troubleshooting Guide—426992-008
5-2
QUEST
QUEST
The QUEST tool helps you analyze CLIP dumps. This off-line tool provides insight to
the various parameters in the CLIP dump file. The input to the QUEST tool is the CLIP
dump file, which is a memory image along with a few structures of the CLIP software.
QUEST provides these types of output:
•
The cause of the CLIP dump including the complete stack frame.
•
A memory dump of the required memory address along with ASCII display and
configurable start address and size of memory to be printed.
•
A readable display of the SWAN control table.
•
A readable display of the line control table.
•
Version (VPROC) strings of SWAN firmware and SNMP software, along with the
version strings of STARTED lines.
•
A memory search given an ASCII string within the dump file.
•
Display of the task control blocks of each task (both short listing and long listing).
This display is available only in Format ID #3 (FID3) and above.
•
Creates an IEEE format file from the dump file useful for downloading to a probed
CLIP.
From the QUEST output, you can:
•
Find out which task caused the exception.
•
Find out the error details of the exception.
•
Find out which offset within a SWAN software module caused the exception, and
therefore the exact line of source code which caused the exception, along with the
help of map files and list files.
•
Manually find the stack trace from the stack frame in the dump, along with the map
files and list files.
Dump Formats
The SWAN CLIP dump file has several formats. The earlier formats supported some of
the data structures in the dump file, the later formats support more data structures and
debug information.
The QUEST tool supports Format IDs from 1 to 4 (FID1, FID2, FID3, and FID4).
Table 5-1 provides a list of information provided in each dump according to the Format
ID.