% Librarian T09-2074,4,5 CLUE4,1 CLUED CLUE reads a dump file and displays a summary of the crash. A wild A card filespec is supported. If no filetype is specified, .DMP is assumed.B If the /CANASTA qualifier is specified, an input file for CANASTA will be generated.D If /BINARY is specified, a summary of the crash will be written to  a binary file.F The binary file generated by CLUE/BINARY can be read by CLUE/DISPLAY. Format: CLUE dumpfile_spec 2 LogicalsH Define the logical CL UE$DIRECTORY to point to the location of CLUE.EXE.B If CLUE$OUTPUT is defined, the files generated by the /OUTPUT and1 /BINARY qualifiers are placed in that directory.E If CLUE$MAX_ENTRIES is defined, the number of entries in the binary A file will be limited to the number specified by this logical by  deleting the oldest entries.H If CLUE$EXCLUDE_OPERS is defined, Operator Shutdowns will not be added I to the history file when /BINARY is used. By default Operator Shutdowns  are a dded to the history file.K If CLUE$INHIBIT is defined, CLUE will not analyze a dump. This is used to E suppress CLUE execution when CLUE is called from startup procedures.K If CLUE$CLEANUP is defined, CLUE will delete the previous output listing. < This ensures that only the latest CLUE listing is retained.D If CLUE$NOSUMMARY is defined, CLUE will not extract the Summary of H Processes from a dump. This provides a way to suppress the summary dataD without editing the command procedure s containing the CLUE command.B If analyzing a dump from another version of VMS and you have the B Executive Images and Symbol table files from that version of VMS C available, define logicals, CLUE$EXEC_IMAGES_Vxy and CLUE$STB_Vxy E where x is the major VMS version Number and y is the minor version, I e.g. for VMS V5.3, define logicals CLUE$EXEC_IMAGES_V53 and CLUE$STB_V53F to point to the directories where the appropriate files are located. D If these logicals are not defined, CLUE will  read symbols from the H running system's executive images and symbol table files which may not 4 give the correct symbolizing of the stack contents.F If CANASTA$WORK is defined, the CANASTA file produced by the /CANASTA' qualifier is placed in that directory. 2 /BINARY /BINARY = fileF Write the crash data to the specified binary file. If no filename is * supplied, CLUE$HISTORY.DATA will be used.E If CLUE$OUTPUT is defined, the binary file will be generated in that directory. 2 /CANASTA /CANASTA [= filename]J CANASTA (Crash ANAlysiS Troubleshooting Assistant) is a tool that is usedL at the Customer Support Centers to assist Customer Support Center engineersO in the complex task of analyzing operating system crashes. This tool uses the N parameters collected and transferred from the customer site at the CSC to 0 assist in resolving an operating system crash. O To write the CANASTA parameters to an ASCII file for later transfer to the " CSC use CLUE/ CANASTA [=filename].N If a full filename.extension is specified, it will be used as the name of theN CANASTA file. If no value is supplied, then CANASTA-INPUT-DATA.TMP O will be the filename - using the nodename contained in the dump specified. If P only the filename value is supplied then CANASTA-INPUT-DATA.TMP will ' be the name of the file. O If the logical CANASTA$WORK is specified, the above named file will be created< in that directory, otherwise the default directory is used.2 /DEBUG /DEBUGD This qualifier records the disk blocks retrieved from the dump and A creates a file, CLUE.DBG, showing how many blocks were accessed. 2 /DISPLAY - /DISPLAY = display_command/quals.. filenameC The display module of CLUE reads the specified CLUE History file, D generated by the CLUE/BINARY command, and prompts for user action. B A number of commands, as listed below, are available to the user D from the "CLUE_DISPLAY >" prompt. These commands may also be given A as a value with /DISPLAY from the DCL command line, for example:< CLUE/DISPLAY=DIR/SINCE=1-JAN/OUT=TMP.LIS CLUE$HISTORY.DATA. 5 If no filename is specified, the default filename is CLUE$HISTORY.DATA. 3 DIRECTORY DIRECTORYE This displays a brief summary of each entry in the CLUE History fileF with the most recent entry shown first. The following qualifiers may  be used with this command: 4 /MODULE /MODULE = failing_moduleG This qualifier lists all crashes which failed in a particular module. 4 /OFFSET /OFFSET = nnnnH This qualifier lists all crashes which failed at a particular offset. 4 /OUTPUT /OUTPUT = fileC This qualifier writes the directory listing to the specified file.. The default filename is CLUE_DISPLAY_DIR.TXT.4 /SINCE /SINCE = dd-mmm-yyyy< This qualifier lists all crashes since a particular date. 4 /TYPE /TYPE = crash_type8 This qualifier lists all crashes of a particular type. 4 ExamplesF # Node Time Type Process Name Module OffsetF 1 VAXA 19-FEB-1991 01:21 SECAUDEXH AUDIT_SERVER UNKNOWN 77FEF 2 VAXA 14-JAN-1991 21:42 NETNOBUF NETACP NETACP 1969FF 3 VAXA 1-NOV-1990 15:52 SSRVEXCEPT SNAPSHOT$DETCHD EXE$QIOW_3 0F 4 VAXA 25-SEP-1990 11:52 NETNOSTATE NETACP NETACP 19B0CF 5 VAXA 16-AUG-1990 08:24 INVEXCEPTN NONE PADRIVER 37A43 SHOW SHOW info_type nF This command allows the user to see the detailed data associated withE a particular crash. The types of information which can be displayedE are :- CANASTA, CRASH, STACK, EXECUTIVE, ISTREAM, SUMMARY, SYMBOLS G and ALL. If the crash number is not specified, the most recent crash, #1, is chosen by default. 3 EXTRACT EXTRACT nF This command is used to extract specific record entries from a binaryG file and write them to either an ASCII or a binary file. The default is ASCII. 4 /OUTPUT /OUTPUT = filename.txtF If no filename is specified, the default is CLUE_DISPLAY_EXTRACT.TXT. 4 /BINARY /BINARY = filename.binE This qualifier will write a CLUE History file entry to the specifiedF filename. The default filename is the next version of the file which was read in.3 DELETE DELETE nB This command permanently removes a particular CLUE History entry.E Upon exiting, the remainder of the data will be written to the next 2 higher version of the CLUE History binary file. 3 EXIT EXIT  This exits from CLUE. 2 /ERROR_LOGS /ERROR_LOGS = filenameC Extracts the Error Log messages from the Error Log buffers in the C Dump and writes them to the specified file. The default file name  is CLUE_ELOG.SYS.B This file can later be analyzed using the VMS Error Log utility, ANAL/ERR.C The Entry Type, Sequence Number, and Time of each error log entry 9 in the dump will also be displayed on the output device.2 /HELP /HELP Displays the CLUE Online Help.G The following directories will be searched for the CLUE Help Library, CLUE.HLB:  SYS$HELP CLUE$DIRECTORY the current directory2 /LOCAL /LOCALG If /LOCAL is specified, the node name in the dump must match the node F name of the running system. If the node names do not match, the CLUE E History file will not be updated when /BINARY is used and the ASCII " file generated will be truncated.C If the node names do match, the  CLUE History file will be updated  (if /BINARY specified).I When /LOCAL is used, a Symbol, CLUE$PREV_CRASH, will be defined by CLUE.I This symbol will be set to the Crash type (e.g. INVEXCEPTN or OPERATOR).E If the dump is not from the local system, this symbol will be set toD "WRONG_NODE". The purpose of this symbol is allow other software to7 tell if CLUE processed a valid crash from this system. 2 /OUTPUT /OUTPUT = filenameG The data extracted from the dump file will be written to the specifiedD file. If /OUTPUT is used without a filename, CLUE.LIS will be used.C If CLUE$OUTPUT is defined, the output file will be placed in that directory.2 /PCHB /PCHB = filenameG This qualifier is used to read a VAX9000 PC History Buffer file. AfterF the CLUE analysis of the dump, the PC History Buffer file is read and the PCs interpreted.A If the file is not a valid PCHB file, this qualifier is ignored.2 /READ_SYMBOLS /READ_SYMBOLS = filenameC If the specified file is an .STB file, the global symbols will be D read in by CLUE. Otherwise, the file should contain a list of .STB E files. The symbols from the files listed in the specified file will ) be read in and added to the symbol tree.C Executive images should not be specified with /READ_SYMBOLS as theG base address will not yet be available when the symbols are being read in. 3 Examples:: CLUE/READ_SYMBOLS = SYS$SYSTEM:SCSDEF.STB 9 Reads the symbols from the Symbol Table file SCSDEF.STB.- CLUE/READ_SYMBOLS = STB.FILS & where STB.FILS contains, for example, SYS$SYSTEM:DCLDEF.STB SYS$SYSTEM:RMSDEF.STB SYS$SYSTEM:SYSDEF.STB. Symbols from the above files will be read in. 2 /SUMMARY /[NO]SUMMARY E A summary of the processes current on the System at the time of the @ crash will be displayed. The information shown for each processC includes the Process Control Block (PCB), Process Name, Usernam e, $ State, and Image name if available.G Also a listing of major code modules will be displayed. This includes C the name, address, and length of the code modules. Among the code B modules displayed are the executive loaded images and all loaded drivers.D If there is a current process, the recall buffer will be displayed.F This qualifier is supplied by default. To suppress the summary data, E use /NOSUMMARY. The summary data may also be suppressed by define a H logical, CLUE$NOSUMMARY, to any value. This provides a simple mechanismD to suppress the summary data without editing the command procedure  containing the CLUE command. 2 /SYMBOLS /SYMBOLS = fileE The values of symbols listed in the specified file will be included ? in the output of CLUE. The file must conform to the following convention: Symbol_name Length Code0 "Code" can be one of (A)scii, (H)ex, or (T)ime.F If Length or Code are not specified, defaults of 4 and H are assumed. 3 Examples /SYMBOLS = SYMBOL.FIL SYMBOL.FIL contains: EXE$GQ_SYSTIME 8 T SYS$GQ_VERSION 8 A EXE$GL_FLAGSH The three symbols in SYMBOL.FIL will be found in the dump and displayedF as a VMS Time string, 8 character ASCII string, and a Longword in HEX respectively.G If the first character of a Symbol is "*", all symbols containing this( string will be retrieved and displayed.F If the first character is "@", the contents of the address pointed to! by the symbol will be displayed.D If no file is specified with the /SYMBOLS qualifier, symbols may be/ entered interactively as the dump is analyzed.ww