 |
HP OpenVMS System Analysis Tools Manual
CLUE SYSTEM
Displays the contents of the shared logical name tables in the system.
Format
CLUE SYSTEM /LOGICAL
Parameters
None.
Qualifier
/LOGICAL
Displays all the shared logical names.
Description
The CLUE SYSTEM/LOGICAL command displays the contents of the shared
logical name tables in the system.
Example
|
SDA> CLUE SYSTEM/LOGICAL
Shareable Logical Names:
------------------------
"XMICONBMSEARCHPATH" = "CDE$HOME_DEFAULTS:[ICONS]%B%M.BM"
"MTHRTL_TV" = "MTHRTL_D53_TV"
"SMGSHR_TV" = "SMGSHR"
"DECW$DEFAULT_KEYBOARD_MAP" = "NORTH_AMERICAN_LK401AA"
"CONVSHR_TV" = "CONVSHR"
"XDPS$INCLUDE" = "SYS$SYSROOT:[XDPS$INCLUDE]"
"DECW$SYSTEM_DEFAULTS" = "SYS$SYSROOT:[DECW$DEFAULTS.USER]"
"SYS$PS_FONT_METRICS" = "SYS$SYSROOT:[SYSFONT.PS_FONT_METRICS.USER]"
"SYS$TIMEZONE_NAME" = "???"
"STARTUP$STARTUP_VMS" = "SYS$STARTUP:VMS$VMS.DAT"
"PASMSG" = "PAS$MSG"
"UCX$HOST" = "SYS$COMMON:[SYSEXE]UCX$HOST.DAT;1"
"SYS$SYLOGIN" = "SYS$MANAGER:SYLOGIN"
"DNS$SYSTEM" = "DNS$SYSTEM_TABLE"
"IPC$ACP_ERRMBX" = "d.Ú."
"CDE$DETACHED_LOGICALS" = "DECW$DISPLAY,LANG"
"DECW$SERVER_SCREENS" = "GXA0"
"DNS$_COTOAD_MBX" = "ä<â."
"DNS$LOGICAL" = "DNS$SYSTEM"
"OSIT$MAILBOX" = "äAë."
"XNL$SHR_TV" = "XNL$SHR_TV_SUPPORT.EXE"
"MOM$SYSTEM" = "SYS$SYSROOT:[MOM$SYSTEM]"
"MOP$LOAD" = "SYS$SYSROOT:<MOM$SYSTEM>"
.
.
.
|
CLUE 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[,...]]
Parameters
None.
Qualifiers
/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
|
/LIMBO
Walks through the limbo queue (LRU order) and displays information for
the cached file header control blocks (FCBs).
/STATISTIC
Displays statistical and performance information related to the virtual
I/O cache.
/VOLUME
Decodes and displays the cache volume control blocks (CVCB).
Examples
| #1 |
SDA> CLUE VCC/STATISTIC
Virtual I/O Cache Statistics:
-----------------------------
Cache State pak,on,img,data,enabled
Cache Flags on,protocol_only
Cache Data Area 80855200
Total Size (pages) 400 Total Size (MBytes) 3.1 MB
Free Size (pages) 0 Free Size (MBytes) 0.0 MB
Read I/O Count 34243 Read I/O Bypassing Cache 3149
Read Hit Count 15910 Read Hit Rate 46.4%
Write I/O Count 4040 Write I/O Bypassing Cache 856
IOpost PID Action Rtns 40829 IOpost Physical I/O Count 28
IOpost Virtual I/O Count 0 IOpost Logical I/O Count 7
Read I/O past File HWM 124 Cache Id Mismatches 44
Count of Cache Block Hits 170 Files Retained 100
Cache Line LRU 82B11220 82B11620 Oldest Cache Line Time 00001B6E
Limbo LRU Queue 80A97E3C 80A98B3C Oldest Limbo Queue Time 00001B6F
Cache VCB Queue 8094DE80 809AA000 System Uptime (seconds) 00001BB0
|
| #2 |
SDA> CLUE VCC/VOLUME
Virtual I/O Cache - Cache VCB Queue:
------------------------------------
CacheVCB RealVCB LockID IRP Queue CID LKSB Ocnt State
-------- -------- -------- ----------------- ---- ---- ---- ---------------
8094DE80 80A7E440 020007B2 8094DEBC 8094DEBC 0000 0001 0002 on
809F3FC0 809F97C0 0100022D 809F3FFC 809F3FFC 0000 0001 0002 on
809D0240 809F7A40 01000227 809D027C 809D027C 0000 0001 0002 on
80978B80 809F6C00 01000221 80978BBC 80978BBC 0000 0001 0002 on
809AA000 809A9780 01000005 809AA83C 809AA03C 0007 0001 0002 on
|
| #3 |
SDA> CLUE VCC/LIMBO
Virtual I/O Cache - Limbo Queue:
--------------------------------
CFCB CVCB FCB CFCB IOerrors FID (hex)
-------- -------- -------- -Status- -------- --------------
80A97DC0 809AA000 80A45100 00000200 00000000 (076B,0001,00)
80A4E440 809AA000 809CD040 00000200 00000000 (0767,0001,00)
80A63640 809AA000 809FAE80 00000200 00000000 (0138,0001,00)
80AA2540 80978B80 80A48140 00000200 00000000 (0AA5,0014,00)
80A45600 809AA000 80A3AC00 00000200 00000000 (0C50,0001,00)
80A085C0 809AA000 809FA140 00000200 00000000 (0C51,0001,00)
80A69800 809AA000 809FBA00 00000200 00000000 (0C52,0001,00)
80951000 809AA000 80A3F140 00000200 00000000 (0C53,0001,00)
80A3E580 809AA000 80A11A40 00000200 00000000 (0C54,0001,00)
80A67F80 809AA000 80978F00 00000200 00000000 (0C55,0001,00)
809D30C0 809AA000 809F4CC0 00000200 00000000 (0C56,0001,00)
809D4B80 809AA000 8093E540 00000200 00000000 (0C57,0001,00)
[......]
80A81600 809AA000 8094B2C0 00000200 00000000 (0C5D,0001,00)
80AA3FC0 809AA000 80A2DEC0 00000200 00000000 (07EA,000A,00)
80A98AC0 809AA000 8093C640 00000200 00000000 (0C63,0001,00)
|
| #4 |
SDA> CLUE VCC/CACHE
Virtual I/O Cache - Cache Lines:
--------------------------------
CL VA CVCB CFCB FCB CFCB IOerrors FID (hex)
-------- -------- -------- -------- -------- -Status- -------- ------------
82B11200 82880000 809D0240 809D7000 80A01100 00000200 00000000 (006E,0003,00)
82B15740 82AAA000 809AA000 80A07A00 80A24240 00000000 00000000 (0765,0001,00)
82B14EC0 82A66000 809AA000 80A45600 80A3AC00 00000200 00000000 (0C50,0001,00)
82B12640 82922000 809D0240 809D7000 80A01100 00000200 00000000 (006E,0003,00)
82B123C0 8290E000 809AA000 80A45600 80A3AC00 00000200 00000000 (0C50,0001,00)
82B13380 8298C000 809D0240 809D7000 80A01100 00000200 00000000 (006E,0003,00)
82B15A40 82AC2000 809AA000 80A45600 80A3AC00 00000200 00000000 (0C50,0001,00)
82B15F40 82AEA000 809D0240 809D7000 80A01100 00000200 00000000 (006E,0003,00)
82B12AC0 82946000 809D0240 809D7000 80A01100 00000200 00000000 (006E,0003,00)
82B12900 82938000 809D0240 809D7000 80A01100 00000200 00000000 (006E,0003,00)
82B10280 82804000 809AA000 80A45600 80A3AC00 00000200 00000000 (0C50,0001,00)
82B122C0 82906000 809AA000 80A1AC00 80A48000 00000000 00000000 (0164,0001,00)
82B14700 82A28000 809AA000 809FFEC0 809F8DC0 00000004 00000000 (07B8,0001,00)
82B11400 82890000 809AA000 80A113C0 80A11840 00000000 00000000 (00AF,0001,00)
[......]
82B11380 8288C000 809AA000 809DA0C0 809C99C0 00002000 00000000 (00AB,0001,00)
82B130C0 82976000 809AA000 809DA0C0 809C99C0 00002000 00000000 (00AB,0001,00)
82B11600 828A0000 809AA000 809DA0C0 809C99C0 00002000 00000000 (00AB,0001,00)
|
CLUE XQP
Displays XQP-related information.
Format
CLUE XQP [/qualifier[,...]]
Parameters
None.
Qualifiers
/ACTIVE [/FULL]
Displays all active XQP processes.
/AQB
Displays any current I/O request packets (IRPs) waiting at the
interlocked queue.
/BFRD=index
Displays the buffer descriptor (BFRD) referenced by the index
specified. The index is identical to the hash value.
/BFRL=index
Displays the buffer lock block descriptor (BFRL) referenced by the
index specified. The index is identical to the hash value.
/BUFFER=(n,m) [/FULL]
Displays the BFRDs for a given pool. Specify either 0, 1, 2 or 3, or a
combination of these in the parameter list.
/CACHE_HEADER
Displays the block buffer cache header.
/FCB=address [/FULL]
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.
The address specified can also be either a valid volume control block
(VCB), unit control block (UCB), or window control block (WCB) address.
/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.
/GLOBAL
Displays the global XQP area for a given process.
/LBN_HASH=lbn
Calculates and displays the hash value for a given logical block number
(LBN).
/LIMBO
Searches through the limbo queue and displays FCB information from
available, but unused file headers.
/LOCK=lockbasis
Displays all file system serialization, arbitration, and cache locks
found for the specified lockbasis.
/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.
/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. If you add the /FULL qualifier, additional information is
displayed.
Description
The CLUE XQP command displays XQP information. XQP is part of the I/O
subsystem.
Examples
| #1 |
SDA> CLUE XQP/CACHE_HEADER
Block Buffer Cache Header:
--------------------------
Cache_Header 8437DF90 BFRcnt 000005D2 FreeBFRL 843916A0
Bufbase 8439B400 BFRDbase 8437E080 BFRLbase 8438F7E0
Bufsize 000BA400 LBNhashtbl 84398390 BFRLhashtbl 84399BC8
Realsize 000D78A0 LBNhashcnt 0000060E BFRLhashcnt 0000060E
Pool #0 #1 #2 #3
Pool_LRU 8437E5C0 84385F40 84387E90 8438EEB0
8437F400 84385D60 8438AC80 8438EE20
Pool_WAITQ 8437DFE0 8437DFE8 8437DFF0 8437DFF8
8437DFE0 8437DFE8 8437DFF0 8437DFF8
Waitcnt 00000000 00000000 00000000 00000000
Poolavail 00000094 00000252 00000251 00000094
Poolcnt 00000095 00000254 00000254 00000095
AmbigQFL 00000000 Process_Hits 00000000 Cache_Serial 00000000
AmbigQBL 00000000 Valid_Hits 00000000 Cache_Stalls 00000000
Disk_Reads 00000000 Invalid_Hits 00000000 Buffer_Stalls 00000000
Disk_Writes 00000000 Misses 00000000
|
The SDA command CLUE XQP/CACHE_HEADER displays the block buffer cache
header.
| #2 |
SDA> CLUE XQP/VALIDATE=(1,4)
Searching BFRD Array for possible Corruption...
Searching Lock Basis Hashtable for possible Corruption...
|
In this example, executing the CLUE XQP/VALIDATE=1,4 command indicated
that no corruption was detected in either the BFRD Array or the Lock
Basis Hashtable.
Chapter 6
SDA Alpha OCLA
The Alpha EV7 On-Chip Logic Analyzer (OCLA) utility enables the user to
tell which instructions each Alpha EV7 CPU on the system has executed.
6.1 Overview of OCLA
OCLA enables the user to tell which instructions each Alpha EV7 CPU has
executed by setting aside one seventh of the Alpha EV7 cache as
acquisition memory which stores the virtual addresses of instructions
executed by the Alpha EV7 CPU. The acquisition memory in the cache can
later be analyzed with an SDA extension.
The acquisition of instructions can be enabled or disabled while the
system is running, thereby allowing the acquisition of instruction
streams for a given period of time without the need to restart the
system.
If the OCLA is enabled and started, and your system subsequently fails
due to a crash, the current acquisition memory is automatically saved
to the system dump file. The instructions executed by each CPU prior to
the system failure can then be analyzed with SDA. Upon restart of the
system, the acquisition memory in the EV7 is still there and can be
copied into system memory using the OCLA ENABLE/OCLA DUMP command.
If the STOP/CPU command is issued on a CPU for which OCLA has been
enabled, OCLA is automatically disabled if the CPU is allowed to leave
the active set. When a CPU is started with the START/CPU command, OCLA
is not automatically enabled; rather, it must be enabled using SDA.
To use the OCLA utility, several new SDA commands and qualifiers are
available. Table 6-1 describes these SDA commands and qualifiers.
6.2 SDA OCLA Commands
Table 6-1 SDA Commands for the OCLA Utility
| Commands |
Description |
|
OCLA ENABLE
|
Enables the OCLA. The command reserves one seventh of the EV7 cache as
acquisition memory for instructions. The following qualifiers are
available:
/CPU=n
Specifies the CPU on which to enable OCLA. If this qualifier is
omitted, OCLA is enabled on every CPU in the system.
/RESET
Resets all OCLA registers to known values.
|
|
OCLA DISABLE
|
Disables the OCLA and returns the cache set to the Alpha EV7 CPU. The
following qualifier is available:
/CPU=n
Specifies the CPU on which to stop acquisition.
|
|
OCLA DUMP
|
Copies the acquisition memory in the Alpha EV7 cache to a region in
system space for later analysis by SDA. The following qualifier is
available:
/CPU=n
Specifies the CPU for which to dump the acquisition memory.
|
|
OCLA HELP
|
Provides online help about the OCLA commands.
|
|
OCLA LOAD
|
Loads the OCLA$PCTRACE execlet. This must be done prior to enabling any
OCLA. It has no qualifiers.
|
|
OCLA SHOW REGISTER
|
Displays detailed information about the OCLA registers. The following
qualifier is available:
/CPU=n
Specifies the CPU for which to display registers.
|
|
OCLA SHOW STATUS
|
Displays the status of an OCLA. The following qualifier is available:
/CPU=n
Specifies the CPU for which to show OCLA status.
|
|
OCLA SHOW TRACE
|
Decodes the acquired compressed instruction stream and displays it. The
following qualifiers are available:
/CPU=n
Specifies the CPU for which to show data.
/LAST=n
Displays the last n instructions.
/NOPAL
Do not include PALcode when displaying instructions.
/REVERSE
Displays the instructions in reverse order.
/SUMMARY
Displays the first 42 instructions.
/SYMBOLIZE
Attempts to symbolize each instruction.
|
|
OCLA START
|
Starts the acquisition of instructions into the acquisition memory. The
following qualifier is available:
/CPU=n
Specifies the CPU on which to start OCLA.
|
|
OCLA STOP
|
Stops the acquisition of instructions. The following qualifier is
available:
/CPU=n
Specifies the CPU on which to stop acquisition.
|
|
OCLA UNLOAD
|
Unloads the OCLA$PCTRACE execlet and returns the acquisition buffers to
the system.
|
OCLA DISABLE
Disables the OCLA and returns the cache set to the Alpha EV7 CPU.
Format
OCLA DISABLE [/CPU=n]
Parameters
None.
Qualifier
/CPU=n
Specifies the CPU on which to stop acquisition. If this qualifier is
omitted, OCLA is disabled on every CPU in the system.
Description
The OCLA DISABLE command disables the OCLA and returns the cache set to
the Alpha EV7 CPU.
OCLA DUMP
Copies the acquisition memory in the Alpha EV7 cache to a region in
system space for later analysis by SDA.
Format
OCLA DUMP [/CPU=n]
Parameters
None.
Qualifier
/CPU=n
Specifies the CPU for which to dump the acquisition memory. If this
qualifier is omitted, the acquisition memory is dumped for all CPUs.
Description
The OCLA DUMP command copies the acquisition memory in the Alpha EV7
cache to a region in system space for later analysis by SDA.
OCLA ENABLE
Enables the OCLA. Reserves one-seventh of the EV7 cache as acquisition
memory for instructions.
Format
OCLA ENABLE [/CPU=n]
Parameters
None.
Qualifiers
/CPU=n
Specifies the CPU on which to enable OCLA. If this qualifier is
omitted, OCLA is enabled on every CPU in the system.
/RESET
Resets all OCLA registers to known values.
Description
The OCLA ENABLE command enables OCLA.
OCLA HELP
Provides online help on OCLA commands.
Format
OCLA HELP
Parameters
None.
Qualifiers
None.
Description
The OCLA HELP command provides online help on OCLA commands.
OCLA LOAD
Loads the OCLA$PCTRACE execlet. This must be done before enabling any
OCLA.
Format
OCLA LOAD
Parameters
None.
Qualifiers
None.
Description
The OCLA LOAD command loads the OCLA$PCTRACE execlet. This must be done
before enabling any OCLA.
OCLA SHOW REGISTER
Displays detailed information about OCLA registers.
Format
OCLA SHOW REGISTER [/CPU=n]
Parameters
None.
Qualifier
/CPU=n
Specifies the CPU for which to display registers. If this qualifier is
omitted, registers are displayed for all CPUs.
Description
Displays detailed information about OCLA registers.
OCLA SHOW STATUS
Displays the status of an OCLA.
Format
OCLA SHOW STATUS [/CPU=n]
Parameters
None.
Qualifier
/CPU=n
Specifies the CPU for which to show OCLA status. If this qualifier is
omitted, status is displayed for all CPUs.
Description
Displays the status of an OCLA.
OCLA SHOW TRACE
Decodes the acquired compressed instruction stream and displays it.
Format
OCLA SHOW TRACE [/CPU=n]
[/LAST=n][/NOPAL][/REVERSE][/SUMMARY][/SYMBOLIZE]
Parameters
None.
Qualifiers
/CPU=n
Specifies the CPU for which to show data. If this qualifier is omitted,
trace data is displayed for all CPUs.
/LAST=n
Displays the last n instructions. If this qualifier is omitted, trace
data is displayed for all instructions.
/NOPAL
Do not include PAL code when displaying instructions.
/REVERSE
Displays the instructions in reverse order.
/SUMMARY
Displays the first 42 instructions.
/SYMBOLIZE
Attempts to symbolize each instruction.
Description
Decodes the acquired compressed instruction stream and displays it.
OCLA START
Starts the acquisition of instructions into acquisition memory.
Format
OCLA START [/CPU=n]
Parameters
None.
Qualifier
/CPU=n
The CPU on which to start instruction acquisition. If this qualifier is
omitted, instruction acquisition is started on all CPUs.
Description
Starts the acquisition of instructions into acquisition memory.
|
