Compaq Crash Analysis Tool User Guide The Compaq Crash Analysis Tool User Guide tells you how to use the Compaq Crash Analysis Tool (CCAT) software on all supported operating systems, includ- ing Compaq Tru64 UNIX, OpenVMS/Alpha, and Microsoft Windows NT. Compaq Computer Corporation Colorado Springs, Colorado Tru64 UNIX Version V4.0 and above OpenVMS/Alpha Version V7.1-2 and above Windows NT Version 4.0 Copyright 2000 Compaq Computer Corporation. COMPAQ and the Compaq logo Registered in U.S. Patent and Trademark Office. Tru64 and OpenVMS are trade- marks of Compaq Information Technologies Group, L.P. Microsoft, Windows, Windows NT, and MS-DOS are trade- marks of Microsoft Corporation. Intel is a trademark of Intel Corporation. UNIX is a trademark of The Open Group. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq or required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard com- mercial license. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The limited warranties for Compaq products are ex- clusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty. Compaq service tool software, including associated documentation, is the property of and contains con- fidential technology of Compaq Computer Corporation. Service customer is hereby licensed to use the soft- ware only for activities directly relating to the delivery of, and only during the term of, the appli- cable services delivered by Compaq or its authorized service provider. Customer may not modify or reverse engineer, remove or transfer the software or make the software or any resultant diagnosis or system management data available to other parties without Compaq's or its authorized service provider's con- sent. Upon termination of the services customer will, at Compaq's or its service provider's option, destroy ii or return the software and associated documentation in its possession. Printed in U.S.A. iii Preface ________________________________________________________________ Compaq Crash Analysis Tool (CCAT) is a software ap- plication that enables Compaq Customer Services engi- neers and system administrators to analyze operating system crashes. CCAT matches information collected about a crash against a set of operating-system- specific rules to determine if the footprint of the collected crash data matches any known crash data footprints for which a solution or corrective action has been found. Use of CCAT greatly reduces customer downtime by shortening the time required to analyze system crashes and eliminates the need for customer site visits. v Overview ________________________________________________________________ The Compaq Crash Analysis Tool User Guide provides general information about the CCAT software. It also tells you how to access and use the CCAT Graphical User Interface (GUI). The organization of the CCAT User Guide is described in the following table: Table_1:_CCAT_User_Guide_Contents_____________________ Chapter_____Contents__________________________________ Chapter 1 Describes the automated CCAT process Chapter 2 Describes how to use the CCAT GUI for Compaq Tru64 UNIX Chapter 3 Describes how to use the CCAT GUI for OpenVMS Alpha Chapter 4 Describes how to use the CCAT GUI for Windows NT (Intel) Chapter 5 Describes how to use the CCAT GUI for ____________Windows_NT_(Alpha)________________________ vii Intended Audience ________________________________________________________________ The Compaq Crash Analysis Tool Users Guide is in- tended for use by system administrators and Compaq Customer Services engineers who use the CCAT software on all supported operating systems, including Compaq Tru64 UNIX, OpenVMS/Alpha, and Microsoft Windows NT. ix Documentation Conventions ________________________________________________________________ The following conventions are used in this manual: User Entries Information that should be entered exactly as it apears in the document is shown in bold. System Responses from the system are shown in Output a monospaced font. xi Further Information ________________________________________________________________ CCAT is a member of the Web-Based Enterprise Service (WEBES) suite of products. For more information on the other WEBES applications, visit the support web site at the following URL: http://www.support.compaq.com/svctools xiii Contents ________________________________________________________________ __________________________________________________________ PREFACE v __________________________________________________________ OVERVIEW vii __________________________________________________________ INTENDED AUDIENCE ix __________________________________________________________ DOCUMENTATION CONVENTIONS xi __________________________________________________________ FURTHER INFORMATION xiii ________________________________________________________________ CHAPTER 1 RUNNING CCAT AUTOMATICALLY 1-1 1.1 OVERVIEW 1-1 1.2 CONFIGURING CCAT TO RUN AUTOMATICALLY 1-3 ________________________________________________________________ CHAPTER 2 USING THE CCAT GUI FOR COMPAQ TRU64 UNIX 2-1 2.1 CCAT GUI OVERVIEW 2-1 2.2 STARTING THE GUI 2-2 2.3 PERFORMING A MANUAL CRASH ANALYSIS 2-3 2.3.1 Compaq Tru64 UNIX Crash Data Parameters 2-3 2.3.2 Entering Parameters 2-5 2.3.2.1 Selecting and Opening a Crash File 2-5 2.3.2.2 Inserting Crash Data Parameters Using Icons2-6 2.3.2.3 Typing In Crash Parameters 2-8 2.3.3 Saving the Results File 2-9 iii 2.4 VIEWING SAVED RESULTS FILES 2-10 2.5 EXITING FROM THE CCAT GUI 2-10 ________________________________________________________________ CHAPTER 3 USING THE CCAT GUI FOR OPENVMS/ALPHA 3-1 3.1 OVERVIEW 3-1 3.2 STARTING THE GUI 3-2 3.3 PERFORMING A MANUAL CRASH ANALYSIS 3-2 3.3.1 OpenVMS/Alpha Crash Data Parameters 3-3 3.3.2 Entering Parameters 3-4 3.3.2.1 Selecting and Opening a Crash File 3-5 3.3.2.2 Inserting Crash Parameters Using Icons 3-6 3.3.2.3 Typing In Crash Parameters 3-7 3.3.3 Saving the Results File 3-8 3.4 VIEWING SAVED RESULTS FILES 3-9 3.5 EXITING FROM THE CCAT GUI 3-10 ________________________________________________________________ CHAPTER 4 USING THE CCAT GUI FOR WINDOWS NT (INTEL) 4-1 4.1 OVERVIEW 4-1 4.2 STARTING THE GUI 4-2 4.3 PERFORMING A MANUAL CRASH ANALYSIS 4-3 4.3.1 Windows NT (Intel) Crash Data Parameters 4-3 iv 4.3.2 Entering Parameters 4-5 4.3.2.1 Selecting and Opening a Crash File 4-6 4.3.2.2 Inserting Crash Data Parameters Using Icons4-7 4.3.2.3 Typing In Crash Parameters 4-8 4.3.3 Saving the Results File 4-9 4.4 VIEWING SAVED RESULTS FILES 4-10 4.5 EXITING FROM THE CCAT GUI 4-11 ________________________________________________________________ CHAPTER 5 USING THE CCAT GUI FOR WINDOWS NT (ALPHA) 5-1 5.1 OVERVIEW 5-1 5.2 STARTING THE GUI 5-2 5.3 PERFORMING A MANUAL CRASH ANALYSIS 5-3 5.3.1 Windows NT (Alpha) Crash Data Parameters 5-3 5.3.2 Entering Parameters 5-4 5.3.2.1 Selecting and Opening a Crash File 5-5 5.3.2.2 Inserting Crash Data Parameters Using Icons5-6 5.3.2.3 Typing In Crash Parameters 5-7 5.3.3 Saving the Results File 5-8 5.4 VIEWING SAVED RESULTS FILES 5-9 5.5 EXITING FROM THE CCAT GUI 5-10 v ________________________________________________________________ INDEX Index-1 ________________________________________________________________ TABLES 1 CCAT User Guide Contents vii 2-1 Compaq Tru64 UNIX Crash Data Parameters 2-3 3-1 OpenVMS/Alpha Crash Data Parameters 3-3 4-1 Windows NT (Intel) Crash Data Parameters 4-3 5-1 Windows NT (Alpha) Crash Data Parameters 5-3 vi Chapter 1 Running CCAT Automatically ________________________________________________________________ __________________________________________________________ 1.1 Overview This manual tells you how to use Compaq Crash Analysis Tool (CCAT) to process crash files manu- ally. However, CCAT is used most efficiently as an automatic process requiring no input from the user. This chapter describes the automatic operation of CCAT. Topics discussed in this chapter include: o The automated CCAT Process o Configuring CCAT to Run Automatically NOTE: CCAT is only supported on the following oper- ating systems and versions: o Tru64 UNIX V4.0 and higher o OpenVMS/ALPHA V7.1 and higher o Windows NT V4.0 and up For older versions of these operating sys- tems and Open VMS/VAX, you must use the Crash Analysis Data Collector (CADC) for operating system diagnostics. For more information about installing and using CADC, see the CADC user documentation. Running CCAT Automatically 1-1 The automated CCAT process begins when a system crashes and consists of the following steps: 1. When the system reboots, a system utility or other software collects data about the cause of the crash and creates a crash file. On Tru64 UNIX systems, the crashdc utility creates the crash file. On OpenVMS/Alpha systems, the Clue utility creates the crash file. On Windows NT systems, you must install the Windows NT version of CADC in order for the crash file to be created. 2. CCAT automatically starts when a system reboots from a crash, and detects that there is a crash file to process. CCAT analyzes the crash file against the local CCAT knowledge base and pro- duces a crash data analysis file which contains the crash parameters, and may include the possible cause and solution for the system crash. 3. CCAT sends an email message to the system ad- ministrator or other specified local addressee containing information about the crash. NOTE: In order for CCAT to perform the following functions automatically, DSNlink must be installed and running on the system. 4. CCAT opens a service request containing the crash parameters and the crash data analysis file at the Customer Support Center (CSC) using DSNlink. (If DSNlink is not available, the customer can provide the crash data analysis file to the CSC via email or storage medium (e.g., diskette or tape). 1-2 Running CCAT Automatically 5. The crash is analyzed again when the message con- taining the crash parameters and the crash data analysis file arrives at the CSC, in case the CCAT server at the local CSC may have updated rule sets that can provide additional insight into the cause of the crash and problem resolution. 6. The results of the analysis performed at the cus- tomer site and at the CSC are entered into the Call Handling System. 7. The CSC notifies the customer of the final analysis results via email or by means of a call from a crash analysis specialist. __________________________________________________________ 1.2 Configuring CCAT to Run Automatically If you want CCAT to process a footprint automatically and send the footprint and the results to the CSC, you must do the following: o Make sure your system is equipped to generate a footprint when it reboots from a crash. In order for CCAT to determine the cause of a sys- tem crash and log a call to the CSC for further analysis, your system must be able to collect in- formation about what was happening at the time of the crash into a crash file, or footprint. This data collection may be done by a utility included with your operating system, or by software you install for that purpose. All OpenVMS/Alpha and Tru64 UNIX operating systems supported by CCAT include system utilities which collect the crash data into a footprint. The Windows NT operating system does not include a utility for collecting crash files. On Windows NT systems, you must install the Crash Analysis Data Collector (CADC) software in order for the footprint to be created. For more information about Running CCAT Automatically 1-3 CADC for Windows NT, see the CADC for Windows NT user documentation. o Make sure your system is equipped to email the footprint, the analysis results, or both to speci- fied email addresses. o Make sure DESTA Director starts and is running before CCAT starts. The WEBES installation modifies your startup pro- cedure so that when your system reboots after a crash, the DESTA Director starts before CCAT. In the unlikely event that the DESTA Director fails to start, CCAT will not start and a communication error message appears. For more information, see the chapter in this manual that pertains to your operating system. o Make CCAT a part of the startup procedure. The WEBES installation modifies your startup pro- cedure so that when your system reboots after a crash, CCAT starts after the DESTA Director. o Make sure DSNlink is installed and running before CCAT starts. For more information, refer to the DSNlink user documentation. 1-4 Running CCAT Automatically Chapter 2 Using the CCAT GUI for Compaq Tru64 UNIX ________________________________________________________________ This chapter tells you how to use the Compaq Crash Analysis Tool (CCAT) Graphical User Interface (GUI) for Compaq Tru64 UNIX. Topics discussed in this chap- ter include o CCAT GUI Overview o Starting the GUI o Performing a Manual Crash Analysis o Viewing Saved Results Files o Exiting From the CCAT GUI __________________________________________________________ 2.1 CCAT GUI Overview The CCAT GUI is an interactive tool you can use to analyze crash files manually. It is important to keep in mind that the CCAT GUI is used only for onsite manual tasks. It does not log calls or send crash parameters or results files to the CSC, nor does it send email notification to anyone. The CCAT GUI allows you to perform the following tasks: o Input operating system crash data parameters for a manual CCAT analysis. Using the CCAT GUI for Compaq Tru64 UNIX 2-1 o Produce and save results files. o View the saved results files. __________________________________________________________ 2.2 Starting the GUI To start the CCAT GUI, enter the following command: /usr/sbin/ccat gui The DESTA Director must be running before you start the CCAT GUI. Ordinarily, the WEBES Common Components installation configures your startup procedure so that the DESTA Director starts every time your system reboots. If the DESTA Director fails to start at system startup, when you try to start the CCAT GUI a communication error message appears. If you see the communication error message, execute the following command: /usr/sbin/desta start You can use the following command to confirm that the DESTA Director started. ps -ef | grep desta_exec If the DESTA Director is running, the system will display multiple instances of the desta_exec process. When CCAT starts as it should, the Compaq Crash Analysis Tool (CCAT) window appears. Note the horizontal scroll bar at the bottom of the upper right-hand frame of the CCAT window. You can resize the CCAT window to best suit your needs and the size of your monitor. Use the scroll bar to view information in the crash data parameter fields which falls outside the frame area. 2-2 Using the CCAT GUI for Compaq Tru64 UNIX __________________________________________________________ 2.3 Performing a Manual Crash Analysis To analyze a crash manually, you must enter the pa- rameters from the crash data file into the fields in the CCAT window. __________________________________________________________ 2.3.1 Compaq Tru64 UNIX Crash Data Parameters The Tru64 UNIX crash data parameters and what they mean are listed in Table 2-1. Table_2-1:_Compaq_Tru64_UNIX_Crash_Data_Parameters____ Parameter_____________Explanation_____________________ OS Version The version number of the failed operating system Architecture The hardware architecture (e.g., alpha) Panic String A brief description of why the system crashed Stack Trace A list of the functions the system was executing when it crashed, with the ending line of code for each Crash Time The time of the system crash Up Time How long the system that crashed had been running since the last reboot Host Name The node on which the crash occurred Firmware Revision The machine hardware type of the failed CPU System String The System Information String, e.g AlphaServer 4100 5/400 4MB Using the CCAT GUI for Compaq Tru64 UNIX 2-3 Table 2-1 (Cont.): Compaq Tru64 UNIX Crash Data ___________________Parameters_________________________ Parameter_____________Explanation_____________________ Number of CPUs The number of CPUs available to the system Physical Memory The memory in megabytes Panic CPU The CPU that caused the system to crash Available CPUs The CPUs that are currently being used Virtual Address The virtual address that caused a kernel memory fault, and subsequent system crash (valid for kernel memory fault panics only) Faulting PC The PC at which the fault oc- curred Exception Frame A pointer to the exception Pointer frame that contains register information about the state of the failed CPU (valid prior to V4.0 only) PC/I Module The Program Counter/Instruction at the time of the trap or exception that led to the sys- tem crash (valid prior to V4.0 only) Return Address The address of the instruction inmmediately prior to the trap or exception that led to the system crash (valid prior to ______________________V4.0_only)______________________ 2-4 Using the CCAT GUI for Compaq Tru64 UNIX __________________________________________________________ 2.3.2 Entering Parameters You can enter crash data parameters in any of the following ways: o Select and open a crash file. o Click on an icon on the left side of the CCAT win- dow. o Type the parameter in the field on the right side of the CCAT window. NOTE: To edit the contents of a parameter field, click on the field and use the arrow and Backspace keys to remove unwanted characters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. __________________________________________________________ 2.3.2.1 Selecting and Opening a Crash File To populate the crash data parameter fields by se- lecting and opening a crash file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. 2. Click on Select Crash File.... The Open window appears. By default, crash files are written to the /usr/opt/compaq/svctools/ccat/data directory. The Open window displays a list of the files in this directory. If you store crash files in another directory, use the pull-down menu in the Look in: field to navigate to the directory where the crash files are stored. 3. Click on the crash file you want to analyze. The name of the file you select appears in the File name: field. Using the CCAT GUI for Compaq Tru64 UNIX 2-5 4. Click on OPEN. The CCAT Message Processing window appears, telling you that the crash file is being analyzed. During analysis, CCAT populates the parameter fields. When analysis is complete, the results appear in the CCAT Results frame at the bottom of the CCAT window. NOTE: When the results file is displayed in the CCAT Results frame, the two frames at the top of the CCAT window may be "grayed out." To display the contents of these frames, click on the operating system tab. __________________________________________________________ 2.3.2.2 Inserting Crash Data Parameters Using Icons If you do not have access to the crash data file, you may have to enter the parameters manually from another source, for example, a hard copy of a portion of the crash file or a mail message containing the parameters. In this case, you may be able to populate the parameter fields by clicking on the icons in the upper left-hand frame of the CCAT window. Each icon in the list of parameters on the left side of the CCAT window indicates that possible values may exist that you can click on to populate a parameter field. These values are read from a file each time you open CCAT. The two kinds of icons displayed are document icons and folder icons. The document icon looks like a blank page with one corner folded down. The folder icon looks like a file folder. The folder icon always has a button next to it. In most cases, when you click on a document icon, the contents of the document are inserted into the corresponding parameter field. 2-6 Using the CCAT GUI for Compaq Tru64 UNIX The exception to clicking on a document icon and having the contents inserted into the parameter field is the case of the Crash Time. When you click on the Crash Time document icon, the Compaq Tru64 UNIX CCAT DateTime window appears. Each field in the Compaq Tru64 UNIX CCAT DateTime window has a pulldown menu you can use to enter in- formation about the date and time of the crash. Find the date and time of the crash in the crash data file, and click on the appropriate option on each of the pulldown menus to enter the day, month, year, hour, minute, second, and millisecond of the crash. When all fields are populated, click on APPLY to populate the parameter field on the right side of the CCAT window. When you click on the button next to a folder icon, the contents of the folder are displayed. A folder may contain subfolders or documents. Click on the folder icon which contains the information you want until the document containing that information is displayed. Then click on the document icon to populate the corresponding parameter field on the right side of the CCAT window. The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Once you have entered all the crash data parameters available to you, click on the APPLY button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults are displayed in the frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the results. Using the CCAT GUI for Compaq Tru64 UNIX 2-7 __________________________________________________________ 2.3.2.3 Typing In Crash Parameters The information you access by clicking on the icons on the left side of the CCAT window may not include one or more of the crash parameters in the crash data file. In this case, you must enter the crash parame- ters manually. To enter a crash parameter manually, click on the appropriate field and type the parameter exactly as it appears in the crash data file. NOTE: When you are entering crash data parameters manually, it is important to remember the following: o Crash data information is case sensitive. o CCAT does not automatically zero-fill. For example, if you are entering the crash pa- rameter "00000005" you must type in the seven zeroes. CCAT does not interpret "5" as "00000005." You can also use the Cut and Paste functions to copy information from an electronic file, for example, an email message, to the parameter fields. If you make a mistake or need to edit the contents of a parameter field, click on the field and use the ar- row and Backspace keys to remove unwanted characters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Once you have entered all the crash data parameters available to you, click on the APPLY button on the right side of the CCAT window to start the crash analysis. 2-8 Using the CCAT GUI for Compaq Tru64 UNIX When CCAT has completed the crash analysis, the re- sults file is displayed in the frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the file. __________________________________________________________ 2.3.3 Saving the Results File You may want to save the results file to view again later. To save the results file, make sure the file is still displayed in the frame at the bottom of the CCAT window. Then follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Save Results File As.... The Save window appears. 3. Enter the name you want to assign to the saved results file in the FILE NAME: field and click on SAVE. NOTE: When you open the SAVE window, the LOOK IN: field shows the default directory where the file will be saved. This default directory is usually /usr/opt/compaq/svctools/ccat /data. To save the file to another direc- tory, click on the Look In: field and use the pulldown menu that appears to navigate to another directory. Using the CCAT GUI for Compaq Tru64 UNIX 2-9 __________________________________________________________ 2.4 Viewing Saved Results Files You can use the CCAT GUI to view results files you have saved. To view a results file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on View Saved Results File.... The OPEN win- dow appears. NOTE: The Open window displays the files in the default directory in which results files are normally saved, usually /usr/opt/compaq /svctools/ccat/data. If the results files are saved in another directory, click on the Look in: field and use the pull-down menu that appears to navigate to the other directory. 3. Click on the results file you want to display. The name of the file you selected appears in the File name: field. 4. Click on OPEN. CCAT displays the results file in the CCAT Results frame at the bottom of the CCAT window. __________________________________________________________ 2.5 Exiting From the CCAT GUI To exit from the CCAT GUI, click on File in the upper left-hand corner of the CCAT window to display the pull-down menu, and then click on EXIT. A CCAT Warning message window may appear, telling you that the communication interface has been shut down. This warning message window is normal and does not indicate a problem. 2-10 Using the CCAT GUI for Compaq Tru64 UNIX Click on OK to exit from CCAT. Using the CCAT GUI for Compaq Tru64 UNIX 2-11 Chapter 3 Using the CCAT GUI for OpenVMS/Alpha ________________________________________________________________ This chapter tells you how to use the Compaq Crash Analysis Tool (CCAT) Graphical User Interface (GUI) for OpenVMS/Alpha. Topics discussed in this chapter include o CCAT Gui Overview o Starting the GUI o Performing a Manual Crash Analysis o Viewing Saved Results Files o Exiting From the CCAT GUI __________________________________________________________ 3.1 Overview The CCAT GUI is an interactive tool you can use to analyze crash files manually. It is important to keep in mind that the CCAT GUI is used only for onsite manual tasks. It does not log calls or send crash parameters or results files to the CSC, nor does it send email notification to anyone. The CCAT GUI allows you to perform the following tasks: o Input operating system crash data parameters for a manual CCAT analysis. Using the CCAT GUI for OpenVMS/Alpha 3-1 o Produce and save results files. o View the saved results files. __________________________________________________________ 3.2 Starting the Gui To start the CCAT GUI, enter the following command: $ @SVCTOOLS_HOME:[BIN]CCAT GUI The DESTA Director must be running before you start the CCAT GUI. Ordinarily, the WEBES Common Components installation configures your startup procedure so that the DESTA Director starts every time your system reboots. If the DESTA Director fails to start at system startup, when you try to start the CCAT GUI a communication error message appears. If you see the communication error message, execute the following command: $ DESTA START You can use the SHOW PROCESS command to confirm that the DESTA Director started. If the DESTA Director is running, the results of the SHOW PROCESS command will display a DESTA Director process. When CCAT starts as it should, the Compaq Crash Analysis Tool (CCAT) window appears. Note the horizontal scroll bar at the bottom of the upper right-hand frame of the CCAT window. You can resize the window to best suit your needs and the size of your monitor. Use the scroll bar to view information which falls outside the window area. __________________________________________________________ 3.3 Performing a Manual Crash Analysis To analyze a crash manually, you must enter the pa- rameters from the crash data file into the fields in the CCAT window. 3-2 Using the CCAT GUI for OpenVMS/Alpha __________________________________________________________ 3.3.1 OpenVMS/Alpha Crash Data Parameters The OpenVMS/Alpha crash data parameters and what they mean are listed in Table 3-1. Table_3-1:_OpenVMS/Alpha_Crash_Data_Parameters________ Parameter_____________Explanation_____________________ OS Version The version number of the failed operating system Crash Time The date and time the system crash occurred Bugcheck The type of diagnostic check logged by the operating system Host Name The node on which the crash occurred CPU Type The model number of the CPU Process Name The name of the process active at the time of the crash Image Name The name of the image being executed at the time of the crash Signal Array The Signal Array count. The Signal Array contains the ex- ception code, zero or more exception parameters, the PC, and the PSL. Condition Code The symbolic value assigned to the specific condition Reason Mask The longword mask Virtual Address The virtual address the failing instruction tried to reference Exception PC The instruction whose attempted execution resulted in the unex- pected executive or kernel mode exception Using the CCAT GUI for OpenVMS/Alpha 3-3 Table_3-1_(Cont.):_OpenVMS/Alpha_Crash_Data_Parameters Parameter_____________Explanation_____________________ Exception PSL Processor Status Longword (PSL) at the time of the exception Module The name of the failed module Name Module The offset of the failed moduleOffset Instruction The failing instruction cor- responding to the exception PC Map Module The name of the map module in use when the crash occurred Map Offset The beginning memory location where the map module driver resides __________________________________________________________ 3.3.2 Entering Parameters You can enter a crash data parameter in any of the following ways: o Select and open a crash file. o Click on an icon on the left side of the CCAT win- dow. o Type the parameter in the field on the right side of the CCAT window. NOTE: To edit the contents of a parameter field, click on the field and use the arrow and Backspace keys to remove unwanted characters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. 3-4 Using the CCAT GUI for OpenVMS/Alpha __________________________________________________________ 3.3.2.1 Selecting and Opening a Crash File To populate the crash data parameter fields by se- lecting and opening a crash file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Select Crash File.... The Open window ap- pears. By default, crash files are written to the SVCTOOLS_HOME:[CCAT.DATA] directory. The Open win- dow displays a list of the files in this directory. If you store crash files in another directory, use the pull-down menu in the Look in: field to nav- igate to the directory where the crash files are stored. 3. Click on the crash file you want to analyze. The name of the file you select appears in the File name: field. 4. Click on OPEN. The CCAT Message Processing window appears, telling you that the crash file is being analyzed. During analysis, CCAT populates the parameter fields. When analysis is complete, the results appear in the CCAT Results frame at the bottom of the CCAT window. NOTE: When the analysis results are displayed in the CCAT Results frame, the two frames at the top of the CCAT window may be "grayed out." To display the contents of these frames, click on the operating system tab. Using the CCAT GUI for OpenVMS/Alpha 3-5 __________________________________________________________ 3.3.2.2 Inserting Crash Parameters Using Icons If you do not have access to the crash data file, you may have to enter the parameters manually from another source, for example a hard copy of a portion of the crash file or a mail message containing the parameters. In this case, you may be able to populate the parameter fields by clicking on the icons in the upper left-hand frame of the CCAT window. Each icon in the list of parameters on the left side of the CCAT window indicates that data may exist that you can click on to populate a parameter field. This data is read from a file each time you open CCAT. The two kinds of icons displayed are document icons and folder icons. The document icon looks like a blank page with the corner folded down. The folder icon looks like a file folder. The folder icon always has a button next to it. When you click on a document icon, the contents of the document are inserted into the corresponding parameter field. The exception to clicking on a document icon and having the contents inserted into the parameter field is the case of the Crash Time. When you click on the Crash Time icon, the OPENVMS ALPHA CCAT Date Time window appears. Each field in the DateTime window has a pull-down menu you can use to enter information about the date and time of the crash. Find the date and time of the crash in the crash data file, and click on the appropriate option on each of the pull-down menus to enter the day, month, year, hour, minute, second, and millisecond of the crash. When all fields are populated, click on Apply to populate the parameter field on the right side of the CCAT window. 3-6 Using the CCAT GUI for OpenVMS/Alpha When you click on the button next to a folder icon, the contents of the folder are displayed. A folder may contain subfolders or documents. Click on the folder icon which contains the information you want until the document containing that information is displayed. Then click on the document icon to populate the corresponding parameter field on the right side of the CCAT window. The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Once you have entered all the crash data parameters available to you, click on the APPLY button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults are displayed in the frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the results. __________________________________________________________ 3.3.2.3 Typing In Crash Parameters The information you access by clicking on the icons on the left side of the CCAT window may not include one or more of the crash parameters in the crash data file. In this case, you must manually enter the crash parameters. To enter a crash parameter manually, click on the appropriate field and type the parameter exactly as it appears in the crash data file. NOTE: When you are entering crash data parameters manually, it is important to remember the following: o Crash data information is case sensitive. Using the CCAT GUI for OpenVMS/Alpha 3-7 o CCAT does not automatically zero-fill. For example, if you are entering the crash pa- rameter "00000005" you must type in the seven zeroes. CCAT does not interpret "5" as "00000005." You can also use the Cut and Paste functions to copy information from an electronic file, for example, an email message, to the parameter fields. If you make a mistake or need to edit the contents of a parameter field, click on the field and use the ar- row and Backspace keys to remove unwanted characters. (Be aware that, due to Java issues on the OpenVMS platform, the BACKSPACE key deletes the character to the right of the cursor.) Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Once you have entered all the crash data parameters available to you, click on the APPLY button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults file is displayed in the CCAT Results frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the file. __________________________________________________________ 3.3.3 Saving the Results File You may want to save the results file to view again later. 3-8 Using the CCAT GUI for OpenVMS/Alpha To save the results file, make sure the file is still displayed in the frame at the bottom of the CCAT window. Then follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Save Results File As... The Save window appears. 3. Enter the name you want to assign to the saved results file in the File name: field and click on SAVE. NOTE: When you open the Save window, the LOOK IN: field shows the default directory where the file will be saved. This default directory is usually SVCTOOLS_HOME:[CCAT.DATA]. To save the file to another directory, click on the LOOK IN: field and use the pulldown menu that appears to navigate to another directory. __________________________________________________________ 3.4 Viewing Saved Results Files You can use the CCAT GUI to view results files you have saved. To view a saved results file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on View Saved Results File... The Open window appears. NOTE: The Open window displays the files in the default directory in which results files are normally saved, usually SVCTOOLS_ HOME:[CCAT.DATA]. If the results files Using the CCAT GUI for OpenVMS/Alpha 3-9 are saved in another directory, click on the Look In: field and use the pull-down menu that appears to navigate to the other directory. 3. Click on the results file you want to display. The name of the file you selected appears in the File name: field. 4. Click on OPEN. CCAT displays the file in the CCAT Results frame at the bottom of the CCAT window. __________________________________________________________ 3.5 Exiting From the CCAT GUI To exit from the CCAT GUI, click on FILE in the upper left-hand corner of the CCAT window to display the pull-down menu, and then click on EXIT. A CCAT Warning message window may appear, telling you that the communication interface has been shut down. This warning message window is normal and does not indicate a problem. Click on OK to exit from CCAT. 3-10 Using the CCAT GUI for OpenVMS/Alpha Chapter 4 Using the CCAT GUI for Windows NT (Intel) ________________________________________________________________ This chapter tells you how to use the Compaq Crash Analysis Tool (CCAT) Graphical User Interface (GUI) for Windows NT (Intel). Topics discussed in this chapter include o CCAT GUI Overview o Starting the GUI o Performing a Manual Crash Analysis o Viewing Saved Results Files o Exiting From the CCAT GUI __________________________________________________________ 4.1 Overview The CCAT GUI is an interactive tool you can use to analyze crash files manually. It is important to keep in mind that the CCAT GUI is used only for onsite manual tasks. It does not log calls or send crash parameters or results files to the CSC, nor does it send email notification to anyone. The CCAT GUI allows you to perform the following tasks: o Input operating system crash data parameters for a manual CCAT analysis. o Produce and save results files. Using the CCAT GUI for Windows NT (Intel) 4-1 o View the saved results files. __________________________________________________________ 4.2 Starting the GUI To start the CCAT GUI, from the Windows NT Taskbar execute the following command: Start\Programs\Compaq Service Tools\Compaq Crash Analysis Tool\ Compaq Crash Analysis Tool The DESTA Director must be running before you start the CCAT GUI. Ordinarily, the WEBES Common Components installation configures your startup procedure so that the DESTA Director starts every time your system reboots. If the DESTA Director fails to start at system startup, when you try to start the CCAT GUI a communication error message appears. If you see the communication error message, execute the following command: Start\Programs\Compaq Service Tools\Web Based Enterprise Service\Start Director You can use the Windows Task Manager to confirm that the DESTA Director started. If the DESTA Director is running, Task Manager will display two instances of the DESTA_exec.exe image. When CCAT starts as it should, the Compaq Crash Analysis Tool (CCAT) window appears. Note the horizontal scroll bar at the bottom of the upper right-hand portion of the CCAT window. You can resize the window to best suit your needs and the size of your monitor. Use the scroll bar to view information in the crash data parameter fields which falls outside the window area. 4-2 Using the CCAT GUI for Windows NT (Intel) __________________________________________________________ 4.3 Performing a Manual Crash Analysis To analyze a crash manually, you must enter the pa- rameters from the crash data file into the fields in the CCAT window. __________________________________________________________ 4.3.1 Windows NT (Intel) Crash Data Parameters The Windows NT (Intel) crash data parameters and what they mean are listed in Table 4-1. Table_4-1:_Windows_NT_(Intel)_Crash_Data_Parameters___ Parameter_____________Explanation_____________________ OS Version The version number of the failed NT operating system Minor Version The NT build number (for NT 4.0, 1381) Service Pack The number of the Service Pack installed on the failed machine Machine Image Type "alpha" or "intel" BugCheckCode The number of the stop that occurred, which can be used to determine what trap occurred BugCheckParam #1 The four parameters normally BugCheckParam #2 included with the BugCheckCode BugCheckParam #3 that give clues to the nature BugCheckParam #4 of the BugCheckCode Failing Module The name of the driver that failed Failing Module The offset of the failed driver Offset Failing Module The date and time the failed Timestamp driver was built Using the CCAT GUI for Windows NT (Intel) 4-3 Table 4-1 (Cont.): Windows NT (Intel) Crash Data ___________________Parameters_________________________ Parameter_____________Explanation_____________________ Crash Process Name The name of the process that was running when the system crashed Failing Routine The name of the failing routine Failing Routine The failing address location Offset within the failing routine, offset from the start of the routine Pool Information The address within a Page or NonPage pool, depending on the stopcode Canonical Stopcode Address or status register Parameter 1 variables (see the Kanalyze Canonical Stopcode documentation for more informa- Parameter 2 tion) Canonical Stopcode Parameter 3 Canonical Stopcode Parameter 4 Keyword 1 Items on the stack that point Keyword 2 to the cause of the failure Keyword3 (see the Kanalyze documentation Keyword 4 for more information) 4-4 Using the CCAT GUI for Windows NT (Intel) Table 4-1 (Cont.): Windows NT (Intel) Crash Data ___________________Parameters_________________________ Parameter_____________Explanation_____________________ Driver List The Driver Name, Driver Load Address, Driver Size, and Driver Date. These values are derived from the failing ad- dress information contained in the Bugcheck Parameter fields. Which Bugcheck Parameter field you use depends on the Bugcheck Code. The Driver List cor- responds to the driver base address when compared to the address of the Stopcode. Stack Trace A list of the functions the system was executing when it crashed, with the ending line of code for each Call Site List Addresses taken from the Stack Trace used to identify failing areas __________________________________________________________ 4.3.2 Entering Parameters You can enter a crash data parameter in any one of the following ways: o Select and open a crash file. o Click on an icon on the left side of the CCAT window. o Type the parameter in the field on the right side of the CCAT window. NOTE: To edit the contents of a parameter field, click on the field and use the Delete and Using the CCAT GUI for Windows NT (Intel) 4-5 Backspace keys to remove unwanted charac- ters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. __________________________________________________________ 4.3.2.1 Selecting and Opening a Crash File To populate the crash data parameter fields by se- lecting and opening a crash file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Select Crash File.... The Open window appears. By default, crash files are written to the C:\Program Files\Compaq\svctools\ccat\data directory. The Open window displays a list of the files in this directory. If you store crash files in another directory, use the pull-down menu in the Look in: field to navigate to the directory where the crash files are stored. 3. Click on the crash file you want to analyze. The name of the file you select appears in the File name: field. 4. Click on OPEN. The CCAT Message Processing window appears, telling you that the crash file is being analyzed. During analysis, CCAT populates the parameter fields. When analysis is complete, the results file appears in the CCAT Results frame at the bottom of the CCAT window. NOTE: When the results file is displayed in the CCAT Results frame, the two frames at the top of the CCAT window may be "grayed out." To display the contents of these frames, click on the operating system tab. 4-6 Using the CCAT GUI for Windows NT (Intel) __________________________________________________________ 4.3.2.2 Inserting Crash Data Parameters Using Icons If you do not have access to the crash data file, you may have to enter the parameters manually from another source, for example, a hard copy of a portion of the crash file or a mail message containing the parameters. In this case, you may be able to populate the parameter fields by clicking on the icons in the upper left-hand frame of the CCAT window. Each icon in the list of parameters on the left side of the CCAT window indicates that possible values may exist that you can click on to populate a parameter field. These values are read from a file each time you open CCAT. The two kinds of icons displayed are document icons and folder icons. The document icon looks like a blank page with one corner folded down. The folder icon looks like a file folder. The folder icon always has a button next to it. When you click on a document icon, the contents of the document are inserted into the corresponding parameter field. When you click on the button next to a folder icon, the contents of the folder are displayed. A folder may contain subfolders or documents. Click on the folder icon which contains the information you want until the document containing that information is displayed. Then click on the document icon to populate the corresponding parameter field on the right side of the CCAT window. The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Using the CCAT GUI for Windows NT (Intel) 4-7 Once you have entered all the crash data parameters available to you, click on the Apply button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults are displayed in the frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the results. __________________________________________________________ 4.3.2.3 Typing In Crash Parameters The information you access by clicking on the icons on the left side of the CCAT window may not include one or more of the crash parameters in the crash data file. In this case, you must manually enter the crash parameters. To enter a crash parameter manually, click on the appropriate field and type the parameter exactly as it appears in the crash data file. NOTE: When you are entering crash data parameters manually, it is important to remember the following: o Crash data information is case sensitive. o CCAT does not automatically zero-fill. For example, if you are entering the crash pa- rameter "00000005" you must type in the seven zeroes. CCAT does not interpret "5" as "00000005." You can also use the Cut and Paste functions to copy information from an electronic file, for example, an email message, to the parameter fields. If you make a mistake or need to edit the contents of a parameter field, click on the field and use the ar- row and Backspace keys to remove unwanted characters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. 4-8 Using the CCAT GUI for Windows NT (Intel) The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Once you have entered all the crash data parameters available to you, click on the APPLY button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults are displayed in the CCAT Results frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the results. __________________________________________________________ 4.3.3 Saving the Results File You may want to save the results file to view again later. To save the results file, make sure the file is still displayed in the frame at the bottom of the CCAT window. Then follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Save Results File As... The Save window appears. 3. Enter the name you want to assign to the saved results file in the File Name: field and click on SAVE. NOTE: When you open the Save window, the Look In: field shows the default directory where the file will be saved. This de- fault directory is usually C:\Program Files\Compaq\svctools\ccat\data. To save the file to another directory, click on the Look Using the CCAT GUI for Windows NT (Intel) 4-9 In: field and use the pulldown menu that appears to navigate to another directory. __________________________________________________________ 4.4 Viewing Saved Results Files You can use the CCAT GUI to view results files you have saved. To view a saved results file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on View Saved Results File.... The Open win- dow appears. NOTE: The Open window displays the files in the default directory in which results files are normally saved, usually C:\Program Files\Compaq\svctools\ccat\data. If the results files are saved in another direc- tory, click on the Look In: field and use the pull-down menu that appears to navigate to the other directory. 3. Click on the results file you want to display. The name of the file you selected appears in the File name: field. 4. Click on Open. CCAT displays the results file in the CCAT Results frame at the bottom of the CCAT window. 4-10 Using the CCAT GUI for Windows NT (Intel) __________________________________________________________ 4.5 Exiting From the CCAT GUI To exit from the CCAT GUI, click on File in the upper left-hand corner of the CCAT window to display the pull-down menu, and then click on EXIT. A CCAT Warning message window may appear, telling you that the communication interface has been shut down. This warning message window is normal and does not indicate a problem. Click on OK to exit from CCAT. Using the CCAT GUI for Windows NT (Intel) 4-11 Chapter 5 Using the CCAT GUI for Windows NT (Alpha) ________________________________________________________________ This chapter tells you how to use the Compaq Crash Analysis Tool (CCAT) Graphical User Interface (GUI) for Windows NT (Alpha). Topics discussed in this chapter include o CCAT GUI Overview o Starting the GUI o Performing a Manual Crash Analysis o Viewing Saved Results Files o Exiting From the CCAT GUI __________________________________________________________ 5.1 Overview The CCAT GUI is an interactive tool you can use to analyze crash files manually. It is important to keep in mind that the CCAT GUI is used only for onsite manual tasks. It does not log calls or send crash parameters or results files to the CSC, nor does it send email notification to anyone. The CCAT GUI allows you to perform the following tasks: o Input operating system crash data parameters for a manual CCAT analysis. Using the CCAT GUI for Windows NT (Alpha) 5-1 o Produce and save results files. o View the saved results files. __________________________________________________________ 5.2 Starting the GUI To start the CCAT GUI, from the Windows NT Taskbar execute the following command: Start\Programs\Compaq Service Tools\Compaq Crash Analysis Tool\ Compaq Crash Analysis Tool The DESTA Director must be running before you start the CCAT GUI. Ordinarily, the WEBES Common Components installation configures your startup procedure so that the DESTA Director starts every time your system reboots. If the DESTA Director fails to start at system startup, when you try to start the CCAT GUI a communication error message appears. If you see the communication error message, execute the following command: Start\Programs\Compaq Service Tools\Web Based Enterprise Service\Start Director You can use the Windows Task Manager to confirm that the DESTA Director started. If the DESTA Director is running, Task Manager will display two instances of the DESTA_exec.exe image. When CCAT starts as it should, the Compaq Crash Analysis Tool (CCAT) window appears. Note the horizontal scroll bar at the bottom of the upper right-hand portion of the CCAT window. You can resize the window to best suit your needs and the size of your monitor. Use the scroll bar to view information in the crash data parameter fields which falls outside the window area. 5-2 Using the CCAT GUI for Windows NT (Alpha) __________________________________________________________ 5.3 Performing a Manual Crash Analysis To analyze a crash manually, you must enter the pa- rameters from the crash data file into the fields in the CCAT window. __________________________________________________________ 5.3.1 Windows NT (Alpha) Crash Data Parameters The Windows NT (Alpha) crash data parameters and what they mean are listed in Table 5-1. Table_5-1:_Windows_NT_(Alpha)_Crash_Data_Parameters___ Parameter_____________Explanation_____________________ OS Version The version number of the failed NT operating system Minor Version The NT build number (for NT 4.0, 1381) Service Pack The number of the Service Pack installed on the failed machine Machine Image Type "alpha" or "intel" BugCheckCode The number of the stop that occurred, which can be used to determine what trap occurred BugCheckParam #1 The four parameters normally BugCheckParam #2 included with the BugCheckCode BugCheckParam #3 that give clues to the nature BugCheckParam #4 of the BugCheckCode Return PC The address of the next in- struction in the calling pro- gram to be executed after the current procedure completes its task Failing Module The name of the driver that failed Using the CCAT GUI for Windows NT (Alpha) 5-3 Table 5-1 (Cont.): Windows NT (Alpha) Crash Data ___________________Parameters_________________________ Parameter_____________Explanation_____________________ Failing Module The date and time the failed Timestamp driver was built Failing Module The offset of the failed driver Offset Crash Process Name The name of the process that was running when the system crashed __________________________________________________________ 5.3.2 Entering Parameters You can enter a crash data parameter in any one of the following ways: o Select and open a crash file. o Click on an icon on the left side of the CCAT win- dow. o Type the parameter in the field on the right side of the CCAT window. NOTE: To edit the contents of a parameter field, click on the field and use the Delete and Backspace keys to remove unwanted charac- ters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. 5-4 Using the CCAT GUI for Windows NT (Alpha) __________________________________________________________ 5.3.2.1 Selecting and Opening a Crash File To populate the crash data parameter fields by se- lecting and opening a crash file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Select Crash File. The Open window ap- pears. By default, crash files are written to the C:\Program Files\Compaq\svctools\ccat\data direc- tory. The Open window displays a list of the files in this directory. If you store crash files in an- other directory, use the pull-down menu in the Look in: field to navigate to the directory where the crash files are stored. 3. Click on the crash file you want to analyze. The name of the file you select appears in the File name: field. 4. Click on OPEN. The CCAT Message Processing window appears, telling you that the crash file is being analyzed. During analysis, CCAT populates the parameter fields. When analysis is complete, the results file appears in the CCAT Results frame at the bottom of the CCAT window. NOTE: When the results file is displayed in the CCAT Results frame, the two frames at the top of the CCAT window may be "grayed out." To display the contents of these frames, click on the operating system tab. Using the CCAT GUI for Windows NT (Alpha) 5-5 __________________________________________________________ 5.3.2.2 Inserting Crash Data Parameters Using Icons If you do not have access to the crash data file, you may have to enter the parameters manually from another source, for example, a hard copy of a portion of the crash file or a mail message containing the parameters. In this case, you may be able to populate the parameter fields by clicking on the icons in the upper left-hand frame of the CCAT window. Each icon in the list of parameters on the left side of the CCAT window indicates that possible values may exist that you can click on to populate a parameter field. These values are read from a file each time you open CCAT. The two kinds of icons displayed are document icons and folder icons. The document icon looks like a blank page with one corner folded down. The folder icon looks like a file folder. The folder icon always has a button next to it. When you click on a document icon, the contents of the document are inserted into the corresponding parameter field. When you click on the button next to a folder icon, the contents of the folder are displayed. A folder may contain subfolders or documents. Click on the folder icon which contains the information you want until the document containing that information is displayed. Then click on the document icon to populate the corresponding parameter field on the right side of the CCAT window. The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. 5-6 Using the CCAT GUI for Windows NT (Alpha) Once you have entered all the crash data parameters available to you, click on the Apply button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults are displayed in the frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the results. __________________________________________________________ 5.3.2.3 Typing In Crash Parameters The information you access by clicking on the icons on the left side of the CCAT window may not include one or more of the crash parameters in the crash data file. In this case, you must manually enter the crash parameters. To enter a crash parameter manually, click on the appropriate field and type the parameter exactly as it appears in the crash data file. NOTE: When you are entering crash data parameters manually, it is important to remember the following: o Crash data information is case sensitive. o CCAT does not automatically zero-fill. For example, if you are entering the crash pa- rameter "00000005" you must type in the seven zeroes. CCAT does not interpret "5" as "00000005." You can also use the Cut and Paste functions to copy information from an electronic file, for example, an email message, to the parameter fields. If you make a mistake or need to edit the contents of a parameter field, click on the field and use the ar- row and Backspace keys to remove unwanted characters. Do not click on the CLEAR button. The CLEAR button clears all of the parameter fields. Using the CCAT GUI for Windows NT (Alpha) 5-7 The crash data file may not contain all of the param- eters listed in the CCAT window. When the crash data file does not contain a parameter, leave the tilde (~) in the field to indicate that the parameter is not available. Once you have entered all the crash data parameters available to you, click on the Apply button on the right side of the CCAT window to start the crash analysis. When CCAT has completed the crash analysis, the re- sults are displayed in the CCAT Results frame at the bottom of the CCAT window. You can resize the window and use the scroll bar to view the results. __________________________________________________________ 5.3.3 Saving the Results File You may want to save the results file to view again later. To save the results file, make sure the file is still displayed in the frame at the bottom of the CCAT window. Then follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on Save Results File As... The Save window appears. 3. Enter the name you want to assign to the saved results file in the File Name: field and click on SAVE. NOTE: When you open the SAVE window, the Look In: field shows the default directory where the file will be saved. This de- fault directory is usually C:\Program Files\Compaq\svctools\ccat\data. To save the file to another directory, click on the Look 5-8 Using the CCAT GUI for Windows NT (Alpha) In: field and use the pulldown menu that appears to navigate to another directory. __________________________________________________________ 5.4 Viewing Saved Results Files You can use the CCAT GUI to view results files you have saved. To view a saved results file, follow these steps: 1. Click on File in the upper left corner of the CCAT window. A pull-down menu appears. 2. Click on View Saved Results File.... The Open win- dow appears. NOTE: The Open window displays the files in the default directory in which results files are normally saved, usually C:\Program Files\Compaq\svctools\ccat\data. If the results files are saved in another direc- tory, click on the Look In: field and use the pull-down menu that appears to navigate to the other directory. 3. Click on the results file you want to display. The name of the file you selected appears in the File name: field. 4. Click on OPEN. CCAT displays the results file in the CCAT Results frame at the bottom of the CCAT window. Using the CCAT GUI for Windows NT (Alpha) 5-9 __________________________________________________________ 5.5 Exiting From the CCAT GUI To exit from the CCAT GUI, click on File in the upper left-hand corner of the CCAT window to display the pull-down menu, and then click on EXIT. A CCAT Warning message window may appear, telling you that the communication interface has been shut down. Click on OK to exit from CCAT. 5-10 Using the CCAT GUI for Windows NT (Alpha) Index __________________________________________________________ ___________________________ A Crash data parameters ___________________________ Defined (cont'd) Architecture 2-3 Windows NT (Alpha) 5-3 Available CPUs 2-4 Windows NT (Intel) 4-3 ___________________________ Entering 2-5, 3-4, 4-5, B ___________________________ 5-4 Bugcheck 3-3 By selecting a fileo BugCheckCode 4-3, 5-3 2-5, 3-5, 4-6, 5-5 BugCheckParam 4-3, 5-3 By typing in 2-8, 3-7, ___________________________ 4-8, 5-7 C Using icons 2-6, 3-6, ___________________________ 4-7, 5-6 Call site list 4-5 Crash process name 4-4, Canonical Stopcode Parameter 4-4 5-4 CCAT GUI Crash time 2-3, 3-3 Exiting from 2-10, 3-10, Crash time, entering 4-11, 5-10 OpenVMS/Alpha 3-6 Starting Tru64 UNIX 2-7 OpenVMS/Alpha 3-2 ___________________________ Tru64 UNIX 2-2 D Windows NT (Alpha) 5-2 ___________________________ Windows NT (Intel) 4-2 Document icon 2-6, 3-6, When to use 2-1, 3-1, 4-7, 5-6 4-1, 5-1 Driver list 4-5 CCAT window, resizing 2-2, ___________________________ E 3-2, 4-2, 5-2 ___________________________ Condition code 3-3 Exception frame pointero CPU type 3-3 2-4 Crash data parameters Exception PC 3-3 Defined Exception PSL 3-4 OpenVMS/Alpha 3-3 Tru64 UNIX 2-3 Index-1 Exiting from CCAT GUI ___________________________ 2-10, 3-10, 4-11, 5-10 K ___________________________ ___________________________ F Keyword 4-4 ___________________________ ___________________________ Failing module 4-3, 5-3 M Failing module offset 4-3, ___________________________ 5-4 Machine image type 4-3, Failing module timestamp 5-3 4-3, 5-4 Map module 3-4 Failing routine 4-4 Map offseto3-4 Faulting PC 2-4 Minor versiono4-3, 5-3 Firmware revision 2-3 Module nameo3-4 Folder icon 2-6, 3-6, 4-7, Module offseto3-4 ___________________________ 5-6 N ___________________________ ___________________________ G Number of CPUso2-4 ___________________________ ___________________________ GUI, CCAT O Starting ___________________________ OpenVMS/Alpha 3-2 OS version Tru64 UNIX 2-2 OpenVMS/Alphao3-3 Windows NT (Alpha) 5-2 Tru64 UNIXo2-3 Windows NT (Intel) 4-2 Windows NT (Apha)o5-3 When to use 2-1, 3-1, Windows NT (Intel)o4-3 4-1, 5-1 ___________________________ ___________________________ P H ___________________________ ___________________________ Panic CPUo2-4 Host nameo2-3, 3-3 Panic stringo2-3 ___________________________ Parameter icono2-6, 3-6, I 4-7, 5-6 ___________________________ Parameters, crash data Icon, document 2-6, 3-6, Defined 4-7, 5-6 OpenVMS/Alphao3-3 Icon, folder 2-6, 3-6, Tru64 UNIXo2-3 4-7, 5-6 Windows NT (Alpha)o5-3 Icon, parameter 2-6, 3-6, Windows NT (Intel)o4-3 4-7, 5-6 Entering 2-5, 3-4, 4-5, Image name 3-3 5-4 Instruction 3-4 By selecting a file 2-5, 3-5, 4-6, 5-5 By typing ino2-8, 3-7, 4-8, 5-7 Using icons 2-6, 3-6, 4-7, 5-6 2-Index PC/I moduleo2-4 System stringo2-3 Physical memoryo2-4 ___________________________ Pool informationo4-4 U Process nameo3-3 ___________________________ ___________________________ Up timeo2-3 R ___________________________ ___________________________ V Reason mask 3-3 ___________________________ Resizing CCAT window 2-2, Viewing saved results file 3-2, 4-2, 5-2 OpenVMS/Alphao3-9 Results file Tru64 UNIXo2-10 Saving Windows NT (Alpha)o5-9 Changing default Windows NT (Intel)o4-10 directory 2-9, 3-9, Virtual address 2-4, 3-3 4-9, 5-8 OpenVMS/Alpha 3-8 Tru64 UNIX 2-9 Windows NT (Alpha) 5-8 Windows NT (Intel) 4-9 Viewing saved OpenVMS/Alpha 3-9 Tru64 UNIX 2-10 Windows NT (Alpha) 5-9 Windows NT (Intel) 4-10 Return address 2-4 Return PC 5-3 ___________________________ S ___________________________ Saving results file Changing default directory 2-9, 3-9, 4-9, 5-8 OpenVMS/Alpha 3-8 Tru64 UNIX 2-9 Windows NT (Alpha) 5-8 Windows NT (Intel) 4-9 Service pack 4-3, 5-3 Signal array 3-3 Stack trace 2-3, 4-5 Starting the GUI OpenVMS/Alpha 3-2 Tru64 UNIX 2-2 Windows NT (Alpha) 5-2 Windows NT (Intel) 4-2 Index-3