[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS System Analysis Tools Manual


Previous Contents Index


CLUE PROCESS

Displays process-related information from the current process context.

Format

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


Parameters

None.

Qualifiers

/ALL

Ignored except when specified with /BUFFER. Displays the buffer objects for all processes (that is, all existing buffer objects).

/BUFFER

Displays the buffer objects for the current process or for all processes if /ALL is specified.

/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 [/CPU [cpu-id|ALL]
|/PROCESS [/ADDRESS=n|INDEX=n
|/IDENTIFICATION=n|process-name|ALL]]


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 (" ").


Qualifiers

/ADDRESS=n

Specifies the PCB address of the desired process when used with CLUE REGISTER/PROCESS.

/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.

/IDENTIFICATION=n

Specifies the identification of the desired process when used with CLUE REGISTER/PROCESS.

/INDEX=n

Specifies the index of the desired process when used with CLUE REGISTER/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.

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.

If neither /CPU nor /PROCESS is specified, the parameter (cpu-id or process-name) is ignored and the registers for the SDA current process are displayed.


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 SCSI

Displays information related to SCSI and Fibre Channel.

Format

CLUE SCSI {/CONNECTION=n |/PORT=n|/REQUEST=n|/SUMMARY}


Qualifiers

/CONNECTION=scdt-address

Displays information about SCSI connections and decodes the SCSI connection descriptor data structure identified by the SCDT address.

/PORT=spdt-address

Displays all or a specific port descriptor identified by its SPDT address.

/REQUEST=scdrp-address

Displays information about SCSI requests and decodes the SCSI class driver request packet identified by the SCDRP address.

/SUMMARY

Displays a summary of all SCSI and FC ports and devices and their type and revisions.

Description

The CLUE SCSI command displays information about SCSI and Fibre Channel.

Examples

#1

SDA> CLUE SCSI/SUMMARY
SCSI Summary Configuration:
---------------------------
SPDT      Port  STDT   SCSI-Id  SCDT  SCSI-Lun  Device      UCB      Type   Rev
--------------  --------------  --------------  --------  --------  ------  --- 
854EB840  PKB0
8549B000  PKA0
                8549D880     0
                                8549DA80     0  DKA0      854C2B00  36.4G   HPC5
85250040  FGB0
                8549CC80     1
                                8549D500     0  GGA41     8569EDC0  MSA100
                                85537A40     2  DGA10     85537C00  MSA100  4.48
                                85538F00     3  DGA20     855390C0  MSA100  4.48
                                8553A040     4  DGA30     8553A200  MSA100  4.48
                                8553B340     6  DGA31     8553B500  MSA100  4.48
                                8553C480     7  DGA21     8553C640  MSA100  4.48
                                8553D140    11  DGA50     8553D300  MSA100  4.48
                                8553DE00    12  DGA51     8553DFC0  MSA100  4.48
                                8553EF40    21  DGA40     8553F100  MSA100  4.48
851BED80  FGA0
                851BBE00     1
                                851BFA80     0  GGA40     8569E780  MSA100
                                851C2040     7  DGA21     851A9740  MSA100  4.48
                                85512840     2  DGA10     85512CC0  MSA100  4.48
                                85513380     3  DGA20     85513540  MSA100  4.48
                                85513D80     4  DGA30     85529EC0  MSA100  4.48
                                8552CA40     6  DGA31     8552CC00  MSA100  4.48
                                8552F640    11  DGA50     8552F800  MSA100  4.48
                                85532240    12  DGA51     85532400  MSA100  4.48
                                85534E40    21  DGA40     85535000  MSA100  4.48
      

This example shows a full summary report, which includes all SCSI and FC ports and devices and their type and revisions.

#2

SDA> CLUE SCSI/PORT=851BED80
SCSI Port Descriptor (SPDT):
----------------------------
FGA0:                                       Driver         SYS$PGQDRIVER
SPDT Address                851BED80        Port Type      QLogic ISP23xx FibreChannel
ADP Address                 85189E00        Adapter        PCI
UCB Address                 8519B4C0        Device         00000000.00000000 ()
Busarray Address            8518A180        Port Host SCSI Id                  0
Port Flags                  mapping_reg,dir_dma,luns,cmdq,port_autosense,smart_port
Port Device Status          online
Port Dev Status at DIPL     stdt_scdt
Target inited Bus Resets           0        Number of Events                   0
Retry Attempts                     0        Curr I/Os on all Ports             0
Stray Interrupts                   0        Curr I/Os on all Devices           0
Unexpected Interrupts              0        Total Outstanding I/Os             0
Reselections                       0
CRAB Address                8515DD00        Port Wait Queue    empty
Port CRAM Address           00000000        Nonpg Pool FKB Que empty
Port IDB Address            85151340        Bus Reset Waiters  empty
 
      

This example shows a report for the PORT with SPDT address 851BED80.

#3

SDA> CLUE SCSI/CONNECTION=85512840
SCSI Connection Descriptor (SCDT):
----------------------------------
SCDT Connection Descriptor  85512840        Device                  DGA10
STDT Target Descriptor      851BBE00        Type                    MSA1000 VOLUME
SPDT Port Descriptor        851BED80        Revision                4.48
Port UCB Address            8519B4C0        Target SCSI Id                     1
Device UCB Address          85512CC0        Device SCSI Lun                  512
Connection State            open
Capability Mask             scsi_2,cmdq
Connection Flags            ena_discon
Queue Flags                 -
DIPL Queue Flags            -
Total Outstanding I/Os             0        Number of Commands sent            0
Outstanding Port I/Os              0        Number of Messages sent            0
Outstanding Device I/Os            0        Number of Bytes sent               0
Arbitration Failures               0        Parity Errors                      0
Selection Failures                 0        Missing Phase Errors               0
Count of Controller Errors         0        Bad Phase Errors                   0
Count of Bus Errors                0        Count of Retries                   0
      

This report includes information about SCSI connections and decodes the SCSI connection descriptor data structure identified by the SCDT address 85512840.


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 ring buffer for the CRAB at address 81224740 is displayed.


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


CLUE STACK

On Alpha, CLUE STACK identifies and displays the current stack. On Integrity servers, CLUE STACK only identifies the current stack without displaying it. 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


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

Displays all active XQP processes. (See also /FULL.)

/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)

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.)

/CACHE_HEADER

Displays the block buffer cache header.

/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.

/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.

/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.

/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. (See also /FULL.)

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