DOSD (Dump Off System Disk) allows you to write the system dump
file to a device other than the system disk. For SDA CLUE to
be able to correctly find the dump file to be analyzed after a
system crash, you need to perform the following steps:
1. Modify the command procedure SYS$MANAGER:SYCONFIG.COM to
add the system logical name CLUE$DOSD_DEVICE to point to
the device where the dump file resides. You need to supply
only the physical or logical device name without a file
specification.
2. Modify the command procedure SYS$MANAGER:SYCONFIG.COM to mount
systemwide the device where the dump file resides. Otherwise,
SDA CLUE cannot access and analyze the dump file.
In the following example, the dump file has been placed on
device $3$DUA25, which has the label DMP$DEV. You need to add
the following commands to SYS$MANAGER:SYCONFIG.COM:
$ MOUNT/SYSTEM/NOASSIST $3$DUA25: DMP$DEV DMP$DEV
$ DEFINE/SYSTEM CLUE$DOSD_DEVICE DMP$DEV
1 – CALL_FRAME
Valid for Alpha only.
Displays key information, such as the PC of the caller, from the
active call frames at the time of the crash.
Format
CLUE CALL_FRAME [/CPU [cpu-id|ALL]
|/PROCESS [/ADDRESS=n|INDEX=n
|/IDENTIFICATION=n|process-name|ALL]]
1.1 – Parameters
ALL
When used with /CPU, it requests information about all CPUs in
the system. When used with /PROCESS, it requests information
about all processes that exist in the system.
cpu-id
When used with /CPU, it gives the number of the CPU for which
information is to be displayed. Use of the cpu-id parameter
causes the CLUE CALL_FRAME command to perform an implicit SET CPU
command, making the indicated CPU the current CPU for subsequent
SDA commands.
process-name
When used with /PROCESS, it gives the name of the process for
which information is to be displayed. Use of the process-name
parameter, the /ADDRESS qualifier, the /INDEX qualifier, or the
/IDENTIFICATION qualifier causes the CLUE CALL_FRAME command to
perform an implicit SET PROCESS command, making the indicated
process the current process for subsequent SDA commands. You can
determine the names of the processes in the system by issuing a
SHOW SUMMARY command.
The process-name can contain up to 15 letters and numerals,
including the underscore (_) and dollar sign ($). If it contains
any other characters, you must enclose the process-name in
quotation marks (" ").
1.2 – Qualifiers
1.2.1 /ADDRESS
/ADDRESS=n
Specifies the PCB address of the desired process when used with
CLUE CALL_FRAME/PROCESS.
1.2.2 /CPU
/CPU [cpu-id|ALL]
Indicates that the call frame for a CPU is required. Specify the
CPU by its number or use ALL to indicate all CPUs.
1.2.3 /IDENTIFICATION
/IDENTIFICATION=n
Specifies the identification of the desired process when used
with CLUE CALL_FRAME/PROCESS.
1.2.4 /INDEX
/INDEX=n
Specifies the index of the desired process when used with CLUE
CALL_FRAME/PROCESS.
1.2.5 /PROCESS
/PROCESS [process-name|ALL]
Indicates that the call frame for a process is required. The
process should be specified with either one of the qualifiers
/ADDRESS, /IDENTIFICATION, or /INDEX, or by its name, or by using
ALL to indicate all processes.
2 – CLEANUP
Performs housekeeping operations to conserve disk space. If the
CLUE$COLLECT:CLUE$*.LIS files occupy more space than the logical
CLUE$MAX_BLOCKS allows (the default is 5,000 blocks), the oldest
files are deleted until the threshold is reached.
Format
CLUE CLEANUP
3 – CONFIG
Displays the system, memory, and device configurations.
Format
CLUE CONFIG
3.1 – Qualifiers
3.1.1 /ADAPTER
Displays only the part of the system configuration that contains
information about the adapters and devices on the system.
3.1.2 /CPU
Displays only the part of the system configuration that contains
information about the CPUs.
3.1.3 /MEMORY
Displays only the part of the system configuration that contains
information about the layout of physical memory.
4 – CRASH
Displays a crash dump summary, which includes the following
items:
o Bugcheck type
o Current process and image
o Failing PC and PS
o Executive image section name and offset
o General registers
o Failing instructions
o Exception frame, signal and mechanism arrays (if available)
o CPU state information (spinlock related bugchecks only)
Upon system startup after a system failure, this summary is
automatically captured and stored in the file CLUE$nodename_
ddmmyy_hhmm.LIS. Begin your analysis of the crash dump by
examining this summary.
Format
CLUE CRASH
5 – ERRLOG
Extracts the error log buffers from the dump file and places them
into the binary file called CLUE$ERRLOG.SYS.
Format
CLUE ERRLOG [/OLD]
5.1 – Qualifier
5.1.1 /OLD
Dumps the errorlog buffers into a file using the old errorlog
format. The default action, if /OLD is not specified, is to dump
the errorlog buffers in the common event header format.
5.2 – Description
CLUE ERRLOG extracts the error log buffers from the dump file and
places them into the binary file called CLUE$ERRLOG.SYS.
These buffers contain messages not yet written to the error log
file at the time of the failure. When you analyze a failure on
the same system on which it occurred, you can run the Error
Log utility on the actual error log file to see these error
log messages. When analyzing a failure from another system, use
the CLUE ERRLOG command to create a file containing the failing
system's error log messages just prior to the failure. System
failures are often triggered by hardware problems, so determining
what, if any, hardware errors occurred prior to the failure can
help you troubleshoot a failure.
You can define the logical CLUE$ERRLOG to any file specification
if you want error log information written to a file other than
CLUE$ERRLOG.SYS.
NOTE
You need at least DECevent V2.9 to analyze the new common
event header (CEH) format file. The old format file can be
analyzed by ANALYZE/ERROR or any version of DECevent.
6 – FRU
Outputs the Field Replacement Unit (FRU) table to a file for
display by DECevent.
Format
CLUE FRU
7 – HISTORY
Updates history file and generates crash dump summary output.
Format
CLUE HISTORY [/qualifier]
7.1 – Qualifier
7.1.1 /OVERRIDE
Allows execution of this command even if the dump file has
already been analyzed (DMP$V_OLDDUMP bit set).
8 – MCHK
This command is obsolete.
Format
CLUE MCHK
9 – MEMORY
Displays memory- and pool-related information.
Format
CLUE MEMORY [/qualifier[,...]]
9.1 – Qualifiers
9.1.1 /FILES
Displays information about page and swap file usage.
9.1.2 /FREE
Validates and displays dynamic nonpaged free packet list queue.
(See also /FULL.)
9.1.3 /FULL
Ignored except when used with /FREE or /GH. When used with /FREE,
the first 16 bytes of each entry on the free packet list is
displayed. When used with /GH, a list of the images that use
each granularity hint region is displayed.
9.1.4 /GH
Displays information about the granularity hint regions. (See
also /FULL.)
9.1.5 /LAYOUT
Decodes and displays much of the system virtual address space
layout.
9.1.6 /LOOKASIDE
Validates the lookaside list queue heads and counts the elements
for each list.
9.1.7 /STATISTIC
Displays systemwide performance data such as page fault, I/O,
pool, lock manager, MSCP, and file system cache.
10 – PROCESS
Displays process-related information from the current process
context.
Format
CLUE PROCESS [/qualifier[,...]]
10.1 – Qualifiers
10.1.1 /ALL
Ignored except when specified with /BUFFER. Displays the buffer
objects for all processes (that is, all existing buffer objects).
10.1.2 /BUFFER
Displays the buffer objects for the current process or for all
processes if /ALL is specified.
10.1.3 /LAYOUT
Displays the process P1 virtual address space layout.
10.1.4 /LOGICAL
Displays the process logical names and equivalence names, if they
can be accessed.
10.1.5 /RECALL
Displays the DCL recall buffer, if it can be accessed.
11 – REGISTER
Displays the active register set for the crash CPU. The CLUE
REGISTER command is valid only when analyzing crash dumps.
Format
CLUE REGISTER [/CPU [cpu-id|ALL]
|/PROCESS [/ADDRESS=n|INDEX=n
|/IDENTIFICATION=n|process-name|ALL]]
11.1 – Parameters
ALL
When used with /CPU, it requests information about all CPUs in
the system. When used with /PROCESS, it requests information
about all processes that exist in the system.
cpu-id
When used with /CPU, it gives the number of the CPU for which
information is to be displayed. Use of the cpu-id parameter
causes the CLUE REGISTER command to perform an implicit SET CPU
command, making the indicated CPU the current CPU for subsequent
SDA commands.
process-name
When used with /PROCESS, it gives the name of the process for
which information is to be displayed. Use of the process-name
parameter, the /ADDRESS qualifier, the /INDEX qualifier, or the
/IDENTIFICATION qualifier causes the CLUE REGISTER command to
perform an implicit SET PROCESS command, making the indicated
process the current process for subsequent SDA commands. You can
determine the names of the processes in the system by issuing a
SHOW SUMMARY command.
The process-name can contain up to 15 letters and numerals,
including the underscore (_) and dollar sign ($). If it contains
any other characters, you must enclose the process-name in
quotation marks (" ").
11.2 – Qualifiers
11.2.1 /ADDRESS
/ADDRESS=n
Specifies the PCB address of the desired process when used with
CLUE REGISTER/PROCESS.
11.2.2 /CPU
/CPU [cpu-id|ALL]
Indicates that the registers for a CPU are required. Specify the
CPU by its number or use ALL to indicate all CPUs.
11.2.3 /IDENTIFICATION
/IDENTIFICATION=n
Specifies the identification of the desired process when used
with CLUE REGISTER/PROCESS.
11.2.4 /INDEX
/INDEX=n
Specifies the index of the desired process when used with CLUE
REGISTER/PROCESS.
11.2.5 /PROCESS
/PROCESS [process-name|ALL]
Indicates that the registers for a process are required. The
process should be specified with either one of the qualifiers
/ADDRESS, /IDENTIFICATION, or /INDEX, or by its name, or by using
ALL to indicate all processes.
12 – SCSI
Displays information related to SCSI and Fibre Channel.
Format
CLUE SCSI {/CONNECTION=n |/PORT=n|/REQUEST=n|/SUMMARY}
12.1 – Qualifiers
12.1.1 /CONNECTION
/CONNECTION=scdt-address
Displays information about SCSI connections and decodes the
SCSI connection descriptor data structure identified by the SCDT
address.
12.1.2 /PORT
/PORT=spdt-address
Displays all or a specific port descriptor identified by its SPDT
address.
12.1.3 /REQUEST
/REQUEST=scdrp-address
Displays information about SCSI requests and decodes the SCSI
class driver request packet identified by the SCDRP address.
12.1.4 /SUMMARY
Displays a summary of all SCSI and FC ports and devices and their
type and revisions.
13 – SG
Displays the scatter-gather map.
Format
CLUE SG [/CRAB=address]
13.1 – Qualifier
13.1.1 /CRAB
/CRAB=address
Displays the ringbuffer for the specified Counted Resource
Allocation Block (CRAB). The default action is to display the
ringbuffer for all CRABs.
14 – STACK
On Alpha, CLUE STACK identifies and displays the current stack.
On Integrity servers, CLUE STACK only identifies the current
stack without displaying it.
In the case of a FATALEXCPT, INVEXCEPTN, SSRVEXCEPT, UNXSIGNAL,
or PGFIPLHI bugcheck, CLUE STACK tries to decode the whole
stack. Use the SDA command SHOW STACK on both Alpha and Integrity
servers to display and decode the whole stack for the more common
bugcheck types.
Format
CLUE STACK
15 – SYSTEM
Displays the contents of the shared logical name tables in the
system.
Format
CLUE SYSTEM /LOGICAL
15.1 – Qualifier
15.1.1 /LOGICAL
Displays all the shared logical names.
16 – VCC
Displays virtual I/O cache-related information.
NOTE
If extended file cache (XFC) is enabled, the CLUE VCC
command is disabled.
Format
CLUE VCC [/qualifier[,...]]
16.1 – Qualifiers
16.1.1 /CACHE
Decodes and displays the cache lines that are used to correlate
the file virtual block numbers (VBNs) with the memory used for
caching. Note that the cache itself is not dumped in a selective
dump. Use of this qualifier with a selective dump produces the
following message:
%CLUE-I-VCCNOCAC, Cache space not dumped because DUMPSTYLE is selective
16.1.2 /LIMBO
Walks through the limbo queue (LRU order) and displays
information for the cached file header control blocks (FCBs).
16.1.3 /STATISTIC
Displays statistical and performance information related to the
virtual I/O cache.
16.1.4 /VOLUME
Decodes and displays the cache volume control blocks (CVCB).
17 – XQP
Displays XQP-related information. XQP is part of the I/O
subsystem.
Format
CLUE XQP [/qualifier[,...]]
17.1 – Qualifiers
17.1.1 /ACTIVE
Displays all active XQP processes. (See also /FULL.)
17.1.2 /AQB
Displays any current I/O request packets (IRPs) waiting at the
interlocked queue.
17.1.3 /BFRD
/BFRD=index
Displays the buffer descriptor (BFRD) referenced by the index
specified. The index is identical to the hash value.
17.1.4 /BFRL
/BFRL=index
Displays the buffer lock block descriptor (BFRL) referenced by
the index specified. The index is identical to the hash value.
17.1.5 /BUFFER
/BUFFER=(n,m)
Displays the BFRDs for a given pool. Specify either 0, 1, 2 or
3, or a combination of these in the parameter list. (See also
/FULL.)
17.1.6 /CACHE_HEADER
Displays the block buffer cache header.
17.1.7 /FCB
/FCB=address
Displays all file header control blocks (FCBs) with a nonzero
DIRINDX for a given volume. If no address is specified, the
current volume of the current process is used. (See also /FULL.)
The address specified can also be either a valid volume control
block (VCB), unit control block (UCB), or window control block
(WCB) address.
17.1.8 /FILE
/FILE=address
Decodes and displays file header (FCB), window (WCB), and cache
information for a given file. The file can be identified by
either its FCB or WCB address.
17.1.9 /FULL
Ignored except when used with certain other qualifiers. When
used with /ACTIVE, CLUE displays additional data on the XQP's
caller (for Alpha only). When used with /BUFFER or /VALIDATE,
CLUE displays additional data on each buffer descriptor. When
used with /FCB, CLUE displays all FCBs, including any that are
unused.
17.1.10 /GLOBAL
Displays the global XQP area for a given process.
17.1.11 /LBN_HASH
/LBN_HASH=lbn
Calculates and displays the hash value for a given logical block
number (LBN).
17.1.12 /LIMBO
Searches through the limbo queue and displays FCB information
from available, but unused file headers.
17.1.13 /LOCK
/LOCK=lockbasis
Displays all file system serialization, arbitration, and cache
locks found for the specified lockbasis.
17.1.14 /THREAD
/THREAD=n
Displays the XQP thread area for a given process. The specified
thread number is checked for validity. If no thread number
is specified, the current thread is displayed. If no current
thread, but only one single thread is in use, then that thread
is displayed. If more than one thread exists or an invalid thread
number is specified, then a list of currently used threads is
displayed.
17.1.15 /VALIDATE
/VALIDATE=(n,m)
Performs certain validation checks on the block buffer cache to
detect corruption. Specify 1, 2, 3, 4, or a combination of these
in the parameter list. If an inconsistency is found, a minimal
error message is displayed. (See also /FULL.)