[an error occurred while processing this directive]

HP OpenVMS Systems Documentation
Content starts here

OpenVMS Alpha System Analysis Tools Manual

Previous Contents Index

The CLUE MEMORY/STATISTIC command displays systemwide performance data such as page fault, I/O, pool, lock manager, MSCP, and file system cache statistics.

CLUE PROCESS

Displays process-related information from the current process context.

Format

CLUE PROCESS [/qualifier[,...]]

Parameters

None.

Qualifiers

/BUFFER [/ALL]

Displays the buffer objects for the current process. If the /ALL qualifier is specified, then the buffer objects for all processes (that is, all existing buffer objects) are displayed.

/LAYOUT

Displays the process P1 virtual address space layout.

/LOGICAL

Displays the process logical names and equivalence names, if they can be accessed.

/RECALL

Displays the DCL recall buffer, if it can be accessed.

Description

The CLUE PROCESS command displays process-related information from the current process context. Much of this information is in pageable address space and thus may not be present in a dump file.

Examples

#1 

SDA>  CLUE PROCESS/LOGICAL
Process Logical Names:
----------------------
   "SYS$OUTPUT" = "_CLAWS$LTA5004:"
   "SYS$OUTPUT" = "_CLAWS$LTA5004:"
   "SYS$DISK" = "WORK1:"
   "BACKUP_FILE" = "_$65$DUA6"
   "SYS$PUTMSG" = "...À...À.."
   "SYS$COMMAND" = "_CLAWS$LTA5004:"
   "TAPE_LOGICAL_NAME" = "_$1$MUA3:"
   "TT" = "LTA5004:"
   "SYS$INPUT" = "_$65$DUA6:"
   "SYS$INPUT" = "_CLAWS$LTA5004:"
   "SYS$ERROR" = "21C00303.LOG"
   "SYS$ERROR" = "_CLAWS$LTA5004:"
   "ERROR_FILE" = "_$65$DUA6"

The CLUE PROCESS/LOGICAL command displays logical names for each running process.

#2 

SDA>  CLUE PROCESS/RECALL
Process DCL Recall Buffer:
--------------------------
Index  Command
  1    ana/sys
  2    @login
  3    mc sysman io auto /log
  4    show device d
  5    sea <.x>*.lis clue$
  6    tpu <.x>*0914.lis
  7    sh log *hsj*
  8    xd <.x>.lis
  9    mc ess$ladcp show serv
 10    tpu clue_cmd.cld
 11    ana/sys

The CLUE PROCESS/RECALL command displays a listing of the DCL commands that have been executed most recently.

CLUE REGISTER

Displays the active register set for the crash CPU. The CLUE REGISTER command is valid only when analyzing crash dumps.

Format

CLUE REGISTER

Parameters

None.

Qualifiers

None.

Description

The CLUE REGISTER command displays the active register set of the crash CPU. It also identifies any known data structures, symbolizes any system virtual addresses, interprets the processor status (PS), and attempts to interpret R0 as a condition code.

Example


SDA> CLUE REGISTER
Current Registers:   Process index: 0042   Process name: BATCH_3   PCB: 817660C0   (CPU 1)
------------------------------------------------------------------------------------------
   R0  =  00000000.00000000
   R1  =  FFFFFFFF.814A2C80   MP_CPU  (CPU Id 1)
   R2  =  00000000.00000000
   R3  =  00000000.23D6BBEE
   R4  =  00000000.00000064
   R5  =  FFFFFFFF.831F8000   PHD
   R6  =  00000000.12F75475
   R7  =  00000000.010C7A70
   R8  =  00000000.00000001
   R9  =  00000000.00000000
   R10 =  00000000.00000000
   R11 =  FFFFFFFF.814A2C80   MP_CPU  (CPU Id 1)
   R12 =  FFFFFFFF.810AA5E0   SYSTEM_SYNCHRONIZATION+293E0
   R13 =  FFFFFFFF.810AC408   SMP$TIMEOUT
   R14 =  FFFFFFFF.810AED00   SMP$GL_SCHED
   R15 =  00000000.7FFA1DD8
   R16 =  00000000.0000078C
   R17 =  00000000.00000000
   R18 =  FFFFFFFF.810356C0   SYS$CPU_ROUTINES_2208+1D6C0
   R19 =  FFFFFFFF.81006000   EXE$GR_SYSTEM_DATA_CELLS
   R20 =  FFFFFFFF.80120F00   SCH$QEND_C+00080
   R21 =  00000000.00000000
   R22 =  FFFFFFFF.00000000
   R23 =  00000000.00000000
   R24 =  00000000.00000000
   AI  =  FFFFFFFF.81006000   EXE$GR_SYSTEM_DATA_CELLS
   RA  =  00000000.00000000
   PV  =  00000000.00000000
   R28 =  FFFFFFFF.810194A0   EXE$GL_TIME_CONTROL
   FP  =  00000000.7FFA1F90
   PC  =  FFFFFFFF.800863A8   SMP$TIMEOUT_C+00068
   PS  =  18000000.00000804   Kernel Mode, IPL 8, Interrupt

CLUE SG

Displays the scatter-gather map.

Format

CLUE SG [/CRAB=address]

Parameters

None.

Qualifier

/CRAB=address

Displays the ringbuffer for the specified Counted Resource Allocation Block (CRAB). The default action is to display the ringbuffer for all CRABs.

Description

CLUE SG decodes and displays the scatter/gather ringbuffer entries.
Examples

In this example, the scatter-gather ringbuffer for the CRAB at address 81224740 is displayed.

In this example, the scatter-gather ringbuffer for the CRAB address 8120D600 is displayed.

CLUE STACK

Identifies and displays the current stack. Use the SDA command SHOW STACK to display and decode the whole stack for the more common bugcheck types.

Format

CLUE STACK

Parameters

None.

Qualifiers

None.

Description

The CLUE STACK command identifies and displays the current stack together with the upper and lower stack limits. In case of a FATALEXCPT, INVEXCEPTN, SSRVEXCEPT, UNXSIGNAL, or PGFIPLHI bugcheck, CLUE STACK tries to decode the whole stack.

Example


SDA>  CLUE STACK
Stack Decoder:
--------------
Normal Process Kernel Stack:
Stack Pointer         00000000.7FFA1C98
Stack Limits (low)    00000000.7FFA0000
             (high)   00000000.7FFA2000

SSRVEXCEPT Stack:
-----------------
Stack Pointer  SP =>  00000000.7FFA1C98

Information saved by Bugcheck:
a(Signal Array)       00000000.7FFA1C98  00000000.00000000

EXE$EXCPTN[E] Temporary Storage:
EXE$EXCPTN[E] Stack Frame:
PV                    00000000.7FFA1CA0  FFFFFFFF.829CF010  EXE$EXCPTN
        Entry Point                      FFFFFFFF.82A21000  EXE$EXCPTN_C
return PC             00000000.7FFA1CA8  FFFFFFFF.82A2059C  SYS$CALL_HANDL_C+0002C
saved R2              00000000.7FFA1CB0  00000000.00000000
saved FP              00000000.7FFA1CB8  00000000.7FFA1CD0

SYS$CALL_HANDL Temporary Storage:
                      00000000.7FFA1CC0  FFFFFFFF.829CEDA8  SYS$CALL_HANDL
                      00000000.7FFA1CC8  00000000.00000000
SYS$CALL_HANDL Stack Frame:
PV                    00000000.7FFA1CD0  FFFFFFFF.829CEDA8  SYS$CALL_HANDL
        Entry Point                      FFFFFFFF.82A20570  SYS$CALL_HANDL_C
                      00000000.7FFA1CD8  00000000.00000000
return PC             00000000.7FFA1CE0  FFFFFFFF.82A1E930  CHF_REI+000DC
saved FP              00000000.7FFA1CE8  00000000.7FFA1F40

Fixed Exception Context Area:
Linkage Pointer       00000000.7FFA1CF0  FFFFFFFF.80C63780  EXCEPTION_MON_NPRW+06D80
a(Signal Array)       00000000.7FFA1CF8  00000000.7FFA1EB8
a(Mechanism Array)    00000000.7FFA1D00  00000000.7FFA1D40
a(Exception Frame)    00000000.7FFA1D08  00000000.7FFA1F00
Exception FP          00000000.7FFA1D10  00000000.7FFA1F40
Unwind SP             00000000.7FFA1D18  00000000.00000000
Reinvokable FP        00000000.7FFA1D20  00000000.00000000
Unwind Target         00000000.7FFA1D28  00000000.00020000  SYS$K_VERSION_04
#Sig Args/Byte Cnt    00000000.7FFA1D30  00000005.00000250  BUG$_NETRCVPKT
a(Msg)/Final Status   00000000.7FFA1D38  829CE050.000008F8  BUG$_SEQ_NUM_OVF

Mechanism Array:
Flags/Arguments       00000000.7FFA1D40  00000000.0000002C
a(Establisher FP)     00000000.7FFA1D48  00000000.7AFFBAD0
reserved/Depth        00000000.7FFA1D50  FFFFFFFF.FFFFFFFD
a(Handler Data)       00000000.7FFA1D58  00000000.00000000
a(Exception Frame)    00000000.7FFA1D60  00000000.7FFA1F00
a(Signal Array)       00000000.7FFA1D68  00000000.7FFA1EB8
saved R0              00000000.7FFA1D70  00000000.00020000  SYS$K_VERSION_04
saved R1              00000000.7FFA1D78  00000000.00000000
saved R16             00000000.7FFA1D80  00000000.00020004  UCB$M_NI_PRM_MLT+00004
saved R17             00000000.7FFA1D88  00000000.00010050  SYS$K_VERSION_16+00010
saved R18             00000000.7FFA1D90  FFFFFFFF.FFFFFFFF
saved R19             00000000.7FFA1D98  00000000.00000000
saved R20             00000000.7FFA1DA0  00000000.7FFA1F50
saved R21             00000000.7FFA1DA8  00000000.00000000
saved R22             00000000.7FFA1DB0  00000000.00010050  SYS$K_VERSION_16+00010
saved R23             00000000.7FFA1DB8  00000000.00000000
saved R24             00000000.7FFA1DC0  00000000.00010051  SYS$K_VERSION_16+00011
saved R25             00000000.7FFA1DC8  00000000.00000000
saved R26             00000000.7FFA1DD0  FFFFFFFF.8010ACA4  AMAC$EMUL_CALL_NATIVE_C+000A4
saved R27             00000000.7FFA1DD8  00000000.00010050  SYS$K_VERSION_16+00010
saved R28             00000000.7FFA1DE0  00000000.00000000
FP Regs not valid     [...............]
a(Signal64 Array)     00000000.7FFA1EA0  00000000.7FFA1ED0
SP Align = 10(hex)    [...............]

Signal Array:
Arguments             00000000.7FFA1EB8           00000005
Condition             00000000.7FFA1EBC           0000000C
Argument #2           00000000.7FFA1EC0           00010000  LDRIMG$M_NPAGED_LOAD
Argument #3           00000000.7FFA1EC4           00000000
Argument #4           00000000.7FFA1EC8           00030078  SYS$K_VERSION_01+00078
Argument #5           00000000.7FFA1ECC           00000003

64-bit Signal Array:
Arguments             00000000.7FFA1ED0  00002604.00000005
Condition             00000000.7FFA1ED8  00000000.0000000C
Argument #2           00000000.7FFA1EE0  00000000.00010000  LDRIMG$M_NPAGED_LOAD
Argument #3           00000000.7FFA1EE8  00000000.00000000
Argument #4           00000000.7FFA1EF0  00000000.00030078  SYS$K_VERSION_01+00078
Argument #5           00000000.7FFA1EF8  00000000.00000003

Interrupt/Exception Frame:
saved R2              00000000.7FFA1F00  00000000.00000003
saved R3              00000000.7FFA1F08  FFFFFFFF.80C63460  EXCEPTION_MON_NPRW+06A60
saved R4              00000000.7FFA1F10  FFFFFFFF.80D12740  PCB
saved R5              00000000.7FFA1F18  00000000.000000C8
saved R6              00000000.7FFA1F20  00000000.00030038  SYS$K_VERSION_01+00038
saved R7              00000000.7FFA1F28  00000000.7FFA1FC0
saved PC              00000000.7FFA1F30  00000000.00030078  SYS$K_VERSION_01+00078
saved PS              00000000.7FFA1F38  00000000.00000003  IPL INT CURR PREV
SP Align = 00(hex)    [...............]                      00  0  Kern User

Stack Frame:
PV                    00000000.7FFA1F40  00000000.00010050  SYS$K_VERSION_16+00010
        Entry Point                      00000000.00030060  SYS$K_VERSION_01+00060
                      00000000.7FFA1F48  00000000.00010000  LDRIMG$M_NPAGED_LOAD
return PC             00000000.7FFA1F50  FFFFFFFF.8010ACA4  AMAC$EMUL_CALL_NATIVE_C+000A4
saved FP              00000000.7FFA1F58  00000000.7FFA1F70

Stack (not decoded):
                      00000000.7FFA1F60  00000000.00000001
                      00000000.7FFA1F68  FFFFFFFF.800EE81C  RM_STD$DIRCACHE_BLKAST_C+005AC

Stack Frame:
PV                    00000000.7FFA1F70  FFFFFFFF.80C6EBA0  EXE$CMKRNL
        Entry Point                      FFFFFFFF.800EE6C0  EXE$CMKRNL_C
                      00000000.7FFA1F78  00000000.829CEDE8  EXE$SIGTORET
                      00000000.7FFA1F80  00010050.00000002
                      00000000.7FFA1F88  00000000.00020000  SYS$K_VERSION_04
                      00000000.7FFA1F90  00000000.00030000  SYS$K_VERSION_01
return PC             00000000.7FFA1F98  FFFFFFFF.800A4D64  __RELEASE_LDBL_EXEC_SERVICE+00284
saved R2              00000000.7FFA1FA0  00000000.00000003
saved R4              00000000.7FFA1FA8  FFFFFFFF.80D12740  PCB
saved R13             00000000.7FFA1FB0  00000000.00010000  LDRIMG$M_NPAGED_LOAD
saved FP              00000000.7FFA1FB8  00000000.7AFFBAD0

Interrupt/Exception Frame:
saved R2              00000000.7FFA1FC0  00000000.7FFCF880  MMG$IMGHDRBUF+00080
saved R3              00000000.7FFA1FC8  00000000.7B0E9851
saved R4              00000000.7FFA1FD0  00000000.7FFCF818  MMG$IMGHDRBUF+00018
saved R5              00000000.7FFA1FD8  00000000.7FFCF938  MMG$IMGHDRBUF+00138
saved R6              00000000.7FFA1FE0  00000000.7FFAC9F0
saved R7              00000000.7FFA1FE8  00000000.7FFAC9F0
saved PC              00000000.7FFA1FF0  FFFFFFFF.80000140  SYS$CLREF_C
saved PS              00000000.7FFA1FF8  00000000.0000001B  IPL INT CURR PREV
SP Align = 00(hex)    [...............]                      00  0  User User

CLUE STACK identifies and displays the current stack and its upper and lower limit. It then decodes the current stack if it is one of the more common bugcheck types. In this case, CLUE STACK tries to decode the entire INVEXCEPTN stack.

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.

Previous Next Contents Index