[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS System Analysis Tools Manual


Previous Contents Index


Chapter 9
SDA XFC Extension

The SDA extension commands for Extended File Cache (XFC) enable you to display the following information in a convenient and readable format:

  • Various XFC data structures
  • Statistics that aid in tuning the extended file cache

You can also control the types of events that are recorded by XFC's tracing feature.

9.1 SDA XFC Commands

The following pages describe the SDA XFC extension commands.

You can enter XFC commands at the SDA prompt or you can access online help, as follows:


SDA> XFC HELP 

XFC SET TRACE

Controls the types of events to be recorded by XFC's trace facility and initializes the trace structures (to eliminate events that have already been recorded).

Format

XFC SET TRACE [/SELECT=LEVEL:level] [/RESET]


Parameters

None.

Qualifiers

/SELECT=LEVEL:level

Specifies the level of tracing in XFC on a live system. The possible values for level are as follows:
1 (Default) Traces only major, unusual events.
2 Traces file access, deacess, truncate, read start and complete, and write start and complete operations. Results are displayed using the SHOW TRACE command. Setting this trace level has only a minor performance impact.
3 Performs more detailed tracing, which can be viewed using the SHOW TRACE/RAW command. Has some performance impact.
4 Performs very detailed tracing with a noticeable performance impact.

/RESET

Initializes the trace buffer to eliminate all events that have already been traced.

Description

Traceable events within the XFC facility are organized by level of importance, from level 1 for rare, unusual events only, through level 4, which is a very detailed trace of events within the I/O flow through XFC. The trace buffer can be reset to clear older trace points.

XFC SHOW CONTEXT

Displays the contents of an XFC context block (CTX).

Format

XFC SHOW CONTEXT [address][/STALLING|/FULL|/BRIEF]


Parameter

address

The address of the CTX. If no address is supplied, then all the context structures are displayed.

Qualifiers

/BRIEF

Displays a brief summary for each context; for example, the I/O type, start virtual block number (VBN), and length of I/O.

/FULL

Displays the complete context structure. This is the default.

/STALLING

Displays only contexts that are stalling; for example, those that have a stall reason code other than estrNotStalling.

Description

The SHOW CONTEXT command displays the contents of an active context block. The state of each active operation within XFC is maintained in a data structure called a context block.

Examples


This example shows the address of the context block, I/O type (the type of operation), I/O phase (what phase the operation is in), I/O stall (reason for its stalling), volume ID (address of the control volume block), start VBN (starting VBN of the I/O), length of the I/O, and I/O request packet (the address of the IRP).


2. SDA> XFC SHOW CONTEXT FFFFFFFF8190D690
List of All XFC Active Contexts (CTX) 
------------------------------------- 
Context (CTX) Address: FFFFFFFF8190D690 
I/O Phase:             eiopFillContext 
I/O Type:              eiotReadThrough 
Operation started:   17-APR-2002 11:23:29.00 
Stall Reason:          estrWindowTurn 
Stall Extent:          0000000000000000 
Stall Op (IRP):        FFFFFFFF81267A40 
Saved AST Parameter:   0000000000000000 
Restart Routine:       0000000000000000 
Context state flags    00000000 
  Cache Hit:               False 
  HWM Checked:             False 
  Fork Restarted           False 
  AST Required (flush)     False 
  Buffer locked            False 
  Stalled converting       False 
  Fork Block in use        False 
  Override resource checks False 
  Restart cluster trans    False 
  Restart cluster flush    False 
  MV volumes skipped       False 
  Depose pending           False 
  Ignore CFB Quiesce       False 
  Delete CFB               False 
  Read-ahead hit           False 
ECB Count:                      0 
Index:                 00000000 (         0) 
Start VBN:             000107C1 (     67521) 
Length in Blocks:      00000020 (        32) 
Next VBN:              000107C1 (     67521) 
I/O Extent Count:               0 
Disk I/O Length:       00000020 (        32) 
Bytes Copied:                   0 
Bytes Zeroed:                   0 
Bytes Requested:            16384 
Volume (CVB):          0000000000000000 
Volume Id:             FFFFFFFD8311BD00 
File Id:               0000000000000C54 
Cache File Block:      FFFFFFFD82CEA2A0 
Process (PCB):         FFFFFFFF818FA500

This example shows output of a full display of a context block for a read I/O.


XFC SHOW EXTENT

Displays the contents of an extent control block (ECB).

Format

XFC SHOW EXTENT address


Parameter

address

The address of the ECB.

Qualifiers

None.

Description

The SHOW EXTENT command diplays the contents of an extent control block (ECB). The data in the cache is divided into groups of VBNs called extents. Each extent is maintained in a data structure called an extent control block.

Example


SDA> XFC SHOW EXTENT FFFFFFFD82A58A20
Cache Extent Address:  FFFFFFFD82A58A20 
Type:                  Primary 
Flink:                 FFFFFFFF7F880350 
Blink:                 FFFFFFFF7F880350 
Start VBN:             00000001 (         1) 
Start LBN:             00BA711C (  12218652) 
Length in Blocks:      00000006 (         6) 
Data State:            Clean 
Pin:                   None 
Buffer Address:        FFFFFFFDB0996000 
Secondary ECB Queue:   FFFFFFFD82A58A60 
    Flink:               FFFFFFFD83199A20 
    Blink:               FFFFFFFD83199A20 
Primary ECB:           0000000000000000 
LRU Queue:             FFFFFFFD82A58AAC 
    Flink:               FFFFFFFD82A5A26C 
    Blink:               FFFFFFFD82A5344C 
Waiters Queue:         FFFFFFFD82A58A50 
    Flink:               FFFFFFFD82A58A50 
    Blink:               FFFFFFFD82A58A50 
Lock Id:               00000000 
Parent CFB:            FFFFFFFD82A61180 
ECB delete pending     False 
ECB on LRU queue       True 
ECB depose pending     False 
ECB read ahead         False 
LRU priority:             1
      

This example shows the contents of an extent control block.


XFC SHOW FILE

Displays the contents of the cache file block (CFB).

Format

XFC SHOW FILE [address] [/EXTENTS|/ID=file-id
|/CVB=address |/OPEN|/CLOSED|/STATISTICS |/FULL
|/BRIEF]


Parameter

address

The address of the CFB. The /OPEN and /CLOSED qualifiers, if present, are ignored. If no address is supplied, then all the CFBs are displayed.

Qualifiers

/BRIEF

Displays the following summary information for each cache file block (CFB): CFB address, cache volume block (CVB) address, access count, active I/O count, and file ID.

/BRIEF is incompatible with /EXTENTS, /FULL, and /STATISTICS.

If the file specification is available in LIB$FID_TO_NAME(), it is displayed; otherwise, the file ID is displayed.

Note

Because the volume is accessed through its logical name, if two volumes are mounted that have the same logical name (for example, one mounted /SYSTEM and one mounted privately, which results in the same logical name in two different access-mode logical name tables), the incorrect file specification might be displayed.

/CLOSED

Displays only CFBs whose access count is zero.

/CVB=address

Displays information only for files matching the given cache volume block address.

/DISPLAY_NAME (default)

/NODISPLAY_NAME

Controls whether the file specification is displayed.

/EXTENTS

Displays the cache extents held in cache for any displayed files. This shows the primary and secondary cache extents along with their data state, virtual block numbers (VBNs), and logical block numbers (LBNs). It also shows a summary of memory usage (pagelets used and pagelets valid) for any displayed files. The /EXTENTS qualifier is incompatible with the /BRIEF qualifier.

/FULL

Displays all fields for each cache file block. This is the default.

If the file specification is available in LIB$FID_TO_NAME(), it is displayed; otherwise, the file ID is displayed.

Note

Because the volume is accessed through its logical name, if two volumes are mounted that have the same logical name (for example, one mounted /SYSTEM and one mounted privately, which results in the same logical name in two different access-mode logical name tables), the incorrect file specification might be displayed.

/ID=file-id

Displays only information about any files matching the given file-identification (FID). The file identification (FID) is the hexadecimal file number component in a format file ID (file number, sequence number, relative volume number).

/OPEN

Displays only CFBs whose access count is greater than zero.

/STATISTICS

Displays more statistics about the specified file. The /STATISTICS qualifier is incompatible with the /BRIEF qualifier.

Description

The SHOW FILE command displays the contents of the XFC cache file block. The state of any file in the cache is maintained in a data structure called a cache file block (CFB). There is a CFB for every open file on a system and a CFB for each closed file that is still being cached.

Examples


This example shows the brief output from this command.


2. SDA> XFC SHOW FILE/STATISTICS FFFFFFFD831A24C0
Full Cache File Block (CFB) Details
-----------------------------------
CFB Address:           FFFFFFFD831A24C0 
CFB Address:           FFFFFFFD831A24C0 
Flink:                 FFFFFFFD831A22C0 
Blink:                 FFFFFFFD831A2700 
Access Count:                   1 
Write Access Count:             0 
Volume (CVB):          FFFFFFFD831FE080 
Quiescing:             False 
File (FCB):            FFFFFFFF81943D80 
Volume Id:             FFFFFFFD831FE080 
File Id:               0000000000000383 
External FID:          (899,4,0) 
Predicted Next VBN:    000000FB (       251) 
Active Caching Mode:   Write Through 
Active I/O count:               0 
Flush Fail Status:     00000000 (         0) 
No Readahead Reasons:           0 
Active Readaheads:              0 
File Bad:              False 
Caching disabled:      False 
File deleted on close: False 
File Quiescing:        False 
File Deposing:         False 
File Deleting:         False 
File BlkASTInProg:     False 
File IgnoreBlkAST      False 
File Readahead EOF     False 
PECBs Allocated:               13 (        13 pages) 
PECBs Deallocated:              0 
PECBs Deallocated:              0 
SECBs Allocated:                3 
SECBs Deallocated:             19 
Lock Id:               0C00037F 
   Granted Lock mode:  PRMode 
   Conversion phase:   Illegal 
Conversion phase count:         1 
Hash Bucket Queue:     FFFFFFFD831A2520 
    Flink:               FFFFFFFF7FF819B0 
    Blink:               FFFFFFFF7FF819B0 
PECB Queue:            FFFFFFFD831A2530 
    Flink:               FFFFFFFD8311888C 
    Blink:               FFFFFFFD831A072C 
Stalled IOs Queue:     FFFFFFFD831A24F0 
    Flink:               FFFFFFFD831A24F0 
    Blink:               FFFFFFFD831A24F0 
FAL transition Queue:  FFFFFFFD831A2500 
    Flink:               FFFFFFFD831A2500 
    Blink:               FFFFFFFD831A2500 
Contexts Waiting:      FFFFFFFD831A2510 
    Flink:               FFFFFFFD831A2510 
    Blink:               FFFFFFFD831A2510 
BlkASTs Waiting:       FFFFFFFD831A2540 
    Flink:               FFFFFFFD831A2540 
    Blink:               FFFFFFFD831A2540 
Deaccess Wait List:    FFFFFFFD831A2600 
    Flink:               0000000000000000 
Quiesce context:       0000000000000000 
Up convert context:    0000000000000000 
File IO Statistics - all in decimal 
----------------------------------- 
Statistics Valid From:   19-APR-2002 07:10:32.77 
 
Total QIOs to this file:                14 
Read IOs to this file:                  14 
Write IOs to this file:                  0 
Write IOs to this file:                  0 
Read Hits:                               6 
Hit Rate:                           42.86 % 
Average Overall I/O response time to this file 
 in milliseconds:                     0.9525 
Average Cache Hit I/O response time to this file 
 in milliseconds:                     0.0702 
Average Disk I/O response time to this file 
 in milliseconds:                     1.6141 
Accuracy of I/O resp time:                   65 % 
Read Ahead Count:                        0 
Read Through Count:                     14 
Write Through Count:                     0 
Read Around Count:                       0 
Write Around Count:                      0 
CFB FAL stalls:                          1 
CFB Operation stalls:                    0 
FAL Blocking ASTs:                       0 
Quiesce Depose:                          0 
Quiesce depose Stalls:                   0 
 
(I/O size statistics not collected for this file) 
 
Files found: 1

This example shows a collection of performance statistics for a file.


XFC SHOW HISTORY

Displays approximately three days of XFC activity in 10-minute intervals.

Format

XFC SHOW HISTORY


Parameters

None.

Qualifiers

None.

Description


XFC SHOW IRP

Displays a subset of the fields of an I/O Request Packet that has relevance for XFC debugging.

Format

XFC SHOW IRP address


Parameters

address

The address of the IRP structure whose relevant fields are to be decoded and displayed.

Qualifiers

None.

Description


XFC SHOW MEMORY

Displays information about memory used by the cache.

Format

XFC SHOW MEMORY [/BRIEF|/FULL]


Parameters

None.

Qualifiers

/BRIEF

Displays summary statistics on XFC memory use.

/FULL

Displays full statistics on XFC memory use. This is the default.

Examples

#1

SDA> XFC SHOW MEMORY
XFC Memory Statistics
---------------------
Pool allocation calls           : 430 
Pool allocation failures        : 0 
Pool deallocation calls         : 0 
 
Page allocation calls           : 2745 
Page deallocation calls         : 6 
 
Cache VA Regions and Limits 
--------------------------- 
Cache VA region from FFFFFFFD80000000 to FFFFFFFF80000000 ( 1048576 pages) 
 
  permanent area   : FFFFFFFD80000000 to FFFFFFFDBE800000 (  128000 pages) 
            pool   : FFFFFFFD80000000 to FFFFFFFD83200000 (    6400 pages) 
            data   : FFFFFFFD83200000 to FFFFFFFDBE800000 (  121600 pages) 
 
  dynamic area     : FFFFFFFDBE800000 to FFFFFFFF7F780000 (  919488 pages) 
          pool     : FFFFFFFDBE800000 to FFFFFFFDD4F2C000 (   45974 pages) 
          data     : FFFFFFFDD4F2C000 to FFFFFFFF7F780000 (  873514 pages) 
 
  extent hash table: FFFFFFFF7F780000 to FFFFFFFF7FF80000 (    1024 pages) 
  file hash table  : FFFFFFFF7FF80000 to FFFFFFFF80000000 (      64 pages) 
  file hash table  : FFFFFFFF7FF80000 to FFFFFFFF80000000 (      64 pages) 
 
qhdPermanentPoolFreePages       : FFFFFFFF80D305B8 
qhdPermanentDataFreePages       : FFFFFFFF80D305C8 
Non-Paged Pool allocated        : 45248 (44.1 KB) 
Non-Paged Pool number of - FKBs :      403 
Non-Paged Pool number of - DBMs :        3 
Non-Paged Pool number of - CTXs :       10 
Current Maximum Cache Size      : 8589934592 (8.0 GB) 
Boottime Maximum Cache Size     : -1 
 
Permanent Data Pages: Allocated :   121600 
                      In use    :     2739 
          Pool Pages: Allocated :     6400 
                      In use    :      128 
 
Dynamic Pages: Max Allowed      :   919488 
               Allocated        :        0 
               In use           :        0 
               Min Allowed      :    20971 
   Data Pages: Allowed          :   873514 
               In use           :        0 
   Pool Pages: Allowed          :    45974 
               In use           :        0 
                  PFN List      :        0 
                  Non PFN List  :        0 
 
 
Total Cache Memory (bytes)      : 1048621248 (1000.0 MB) 
 
Private PFN List Stats 
---------------------- 
Dynamic Area PFN List           : FFFFFFFF818EB340 
Free physical pages on list     : 0 
Pages attributed to this list   : 0 
Pages being requested for return: 0 
List priority                   : 0 
Callback routine                : 80DF8A40 
Free PFN queue head             : FFFFFFFF818EB350 
  First free page               : 0000000000000000 
  Last free page                : 0000000000000000 
 
MMG Callback Counters 
--------------------- 
MMG callback active             : 0 
MMG callback count              : 0 
MMG callback requeues           : 0 
MMG callback requeue again      : 0 
Expand attempts callback active : 0 
Pages reclaimed                 : 0 
Trim reclaim attempts           : 0 
LRU depose calls TrimWorkingSet : 0 
Zone Purges: Permanent          : 0 
             Dynamic PFNLST     : 0 
             Dynamic No PFNLST  : 0 
 
Pool Zone Stats (S2 Space)        Permanent    Dynamic 
SECB: Size 112,  PerPage 71 
    Pages / MaxPages             12 / 6400     |||   0 /  45974 
    FreePkts / TotalPkts         64 /  852     |||   0 /      0 
    Hits                       5499            |||   0 
    Not first page                0            |||   0 
    Misses (expns/fails)         12 (   12 /0) |||   0 (      0 /        0) 
 
PECB: Size 176,  PerPage 45 
    Pages / MaxPages             85 / 6400     |||   0 /    45974 
    FreePkts / TotalPkts          6 / 3825     |||   0 /        0 
    Hits                       3740            |||   0 
    Not first page                0            |||   0 
    Misses (expns/fails)         85 (   85 /0) |||   0 (        0 /        0) 
 
CFB: Size 544,  PerPage 14 
    Pages / MaxPages             29 / 6400     |||   0 /    45974 
    FreePkts / TotalPkts          3 /  406     |||   0 /        0 
    Hits                        488            |||   0 
    Not first page                0            |||   0 
    Misses (expns/fails)         29 (   29 /0) |||   0 (        0 /        0) 
 
CVB: Size 608,  PerPage 13 
    Pages / MaxPages              2 / 6400     |||   0 /    45974 
    FreePkts / TotalPkts         12 /   26     |||   0 /        0 
    Hits                         12            |||   0 
    Not first page                0            |||   0 
    Misses (expns/fails)          2 (    2 /0) |||   0 (        0 /        0) 
 
IOSIZE: Size 3120,  PerPage 2 
    Pages / MaxPages              0 / 6400     |||   0 /    45974 
    FreePkts / TotalPkts          0 /    0     |||   0 /        0 
    Hits                          0            |||   0 
    Not first page                0            |||   0 
    Misses (expns/fails)          0 (    0 /0) |||   0 (        0 /        0) 
 
      

This example shows the full output from this command.

#2

SDA> XFC SHOW MEMORY/BRIEF
XFC Memory Summary
------------------
Current Maximum Cache Size      : 8589934592 (8.0 GB) 
Boottime Maximum Cache Size     : -1 
 
Permanent Data Pages: Allocated :   121600 
                      In use    :     2739 
          Pool Pages: Allocated :     6400 
                      In use    :      128 
 
Dynamic Pages: Max Allowed      :   919488 
               Allocated        :        0 
               In use           :        0 
               Min Allowed      :    20971 
   Data Pages: Allowed          :   873514 
               In use           :        0 
   Pool Pages: Allowed          :    45974 
               In use           :        0 
                  PFN List      :        0 
                  Non PFN List  :        0 
 
 
Total Cache Memory (bytes)      : 1048621248 (1000.0 MB)
      

This example shows the brief output from this command.


XFC SHOW SUMMARY

Displays general information about the Extended File Cache.

Format

XFC SHOW SUMMARY [/STATISTICS]


Parameters

None.

Qualifier

/STATISTICS

Additionally, displays read and write activity arranged by I/O size.

Example


SDA> XFC SHOW SUMMARY
XFC Summary
-----------
Extended File Cache V1.0 Let unk I/Os through (Apr 18 2002 15:01:16) 
Anchor Block Address:             FFFFFFFF80D30210 
Build Id: 
Cache State:                      0000A010 
Cache in no-cache state:          False 
MaxAllowedCacheMode:              eNodeFullXFC 
Minimum cache size in Pages:      0001F400 (    128000) 
 
General 
------- 
Extent Hash Table Address:        FFFFFFFF7F780000 
Extent Hash Table Buckets:            524287 
File Hash Table Address:          FFFFFFFF7FF80000 
File Hash Table Buckets:               32767 
Count of private CTXs:                    10 
Count of private FKBs:                   403 
Count of private DIOBMs:                   3 
 
LRU 
--- 
LRU Priority 0 Queue Address:     FFFFFFFF80D30288 
               Queue Length:      00000446 (      1094) 
LRU Priority 1 Queue Address:     FFFFFFFF80D30298 
               Queue Length:      00000AA5 (      2725) 
qhdContexts Address               FFFFFFFF80D302B0 
qhdIRPs Address                   FFFFFFFF80D302C0 
 
Spinlock 
-------- 
Cache Spinlock:                   8125E780 
  Last Acquiring Module:          ROOT$:[XFC.TMPSRC]XFC_SYS.C;4 
       Acquiring Line:            2887 
       Acquiring IPL:             0 
 
Cache Tracing 
------------- 
Number of trace entries:                10000 
Size of trace buffer:                  800000 
Current trace level:                        4 
Lost trace entrys:                          0 
Current trace sequence number:         318768 
 
System Wide I/O Statistics since last reset 
------------------------------------------- 
Time of Last System-Wide Reset:   19-APR-2002 07:10:23.43 
 
Total cache calls:                      4505 
Total cache calls:                      4505 
 - Sum of Paging I/Os:                  2493 
 - and other QIOs:                      2012 
 - and NoCVB or PermNoCache QIOs:          0 
 
Total Virtual Reads:                    4197 
Total Virtual Writes:                    112 
Total PageIOs not cached:                196 
Total Logical I/Os:                        0 
Total Physical I/Os:                       0 
Total bypass write I/Os:                   0 
 
Synchronous I/O completions:             598 
Physical I/O completions:                  0 
Total PID completion I/Os:                 0 
 
Total num IOs on reserved files:        1606 
Total num IOs on global sections:        247 
Count of stalls performed:                13 
 
System Wide Read Percentage:           97.40 % 
System Wide Cache Hit ratio:           57.90 % 
 
System-Wide Read Statistics since last reset 
-------------------------------------------- 
Virtual Reads:                          4197 
  Sum of Read Around Count:              179 
  and Read Through Count:               4018 
Reads Completed:                        4197 
Read Hits:                              2495 
Read Cache Hit Percentage:             59.45 % 
Total Synch Completion Count:            598 
Read Around due to Het. Cluster:           0 
Read Around due to Modifiers:              0 
Read Around due to Size:                  16 
Total reads past EOF:                      1 
Total I/Os with read-ahead:              239 
Read Hits due to read-ahead:             307 
Paging I/Os:                            2493 
 
System-Wide Write Statistics since last reset 
--------------------------------------------- 
Virtual Writes:                          112 
  Sum of Write Around Count:               0 
  and Write Through Count:               112 
Write Around due to Het. Cluster:          0 
Writes Completed:                        112 
Write Around due to Modifiers:             0 
Write Around due to Size:                  0 
Total writes past EOF:                     0 
 
File/Volume Statistics 
---------------------- 
Open Files:                              239 
Closed Files in the Cache:               164 
Number of files truncated:                 3 
Volumes in Full XFC Mode:                  0 
Volumes in VIOC Compatible Mode:          13 
Volumes in No Caching Mode:                1 
Volumes in Perm. No Caching Mode:          0 
Volume Queue:                     FFFFFFFF80D30238 
 
File/Volume Statistics 
---------------------- 
FAL locks currently held:                370 
FAL locks chosen to skip:                  0 
FAL locks acquired since boot:           374 
FAL locks released since boot:             4 
FAL locks converted:                      55 
 
I/Os that have stalled for FAL             0 
CACHE$ACCESS stalls for CFB                0 
ulStallOpQStalls                           1 
Read-thro->Read-around conv.               0 
Writes converted to write-around           0 
ulLockResourceExhaustionRetries:           0 
ulFALLocksEverInContention:                3 
ulFALUpConversionRequests:                 3 
ulFALLocksConvertedToPR:                   0 
ulFALLocksConvertedToNL:                   0 
FAL BlkASTs received:                      1 
FAL BlkASTs ignored:                       0 
ECBs Split Right:                       2229 
ECBs Split Left:                        1710 
ECBs Split Three Ways:                   786 
ECBs Requiring no splits:               5802 
 
Volume Lock Statistics 
---------------------- 
VIL Blocking ASTs received                 0 
VIL Blocking ASTs stalled                  0 
VIL Blocking ASTs started                  0 
VIL Blocking ASTs completed                0 
VIL Up-conversion requests made            0 
VIL Up-conversion grants                   0 
VCML Blocking ASTs received                0 
VCML Blocking ASTs stalled                 0 
VCML Blocking ASTs started                 0 
VCML Blocking ASTs completed               0 
VCML Up-conversion requests made           0 
VCML Up-conversion grants                  0 
Stalls on VCML up-conversion               0 
Restarts on VCML up-conversion             0 
 
Quiesce and Depose Statistics 
----------------------------- 
Quiesce and Depose files Stalled:          0 
File Quiesce and Deposes Started:        114 
File Quiesce and Deposes Cmpltd:         114 
File Quiesce and Deposes Cmpltd:         114 
Q&D CTX used count:                        0 
Q&D CTX in use:                   False 
 
Most recent Depose time                    0.0005 msec. 
Most recent Depose ECB count               0 
Maximum Depose time                        0.1125 msec. 
Maximum ECBs deposed                       3 
Total Depose time                          0.0002 seconds 
Total ECBs deposed                         6 
 
Pending Lock Up-conversion Statistics 
------------------------------------- 
Up-conversions stalled:                    0 
Up-conversions started:                    0 
 
      

This example shows the output of detailed statistics and status for the cache.


XFC SHOW TABLES

Displays both the extent hash table (EHT) and the file hash table (FHT).

Format

XFC SHOW TABLES [/ALL][/EXTENT][/FILE][/SUMMARY]


Parameters

None.

Qualifiers

/ALL

Displays the contents of the extent hash table (EHT) and file hash table (FHT). This is the default.

/EXTENT

Displays only the contents of the EHT.

/FILE

Displays only the contents of the FHT.

/SUMMARY

Displays summary information about EHT and FHT.

Description

The SHOW TABLES command outputs information about the two hash tables used by XFC to locate key data structures.

Example


SDA> XFC SHOW TABLES/SUMMARY
Full Map of CFB HashTable
-------------------------
FHT: Contents of 32768 buckets 
 
 
 0(32366) 
 1(401) 
 2(1) 
Total number of CFBs:    403 
Longest chain length:    2 
Shortest chain length:   0 
Shortest chain length:   0 
Average chain length:        0.01 
 
 
Full Map of PECB HashTable 
-------------------------- 
EHT: verifying 524288 buckets 
 
 
 0(520501) 
 1(3755) 
 2(32) 
Total number of PECBs:   3819 
Longest chain length:    2 
Shortest chain length:   0 
Average chain length:        0.01
      

This example shows summary output about each of the hash tables.


XFC SHOW TRACE

Displays all or selected portions of the XFC trace buffer, starting with the most recent entry and moving backward in time.

Format

XFC SHOW TRACE [/ALL]/CONTAINING=value |/CPU=cpu-num
|/LINENUMBER=linenumber
|/MATCH [=[AND|OR]] |/Px=value |/RAW]


Parameters

None.

Qualifiers

/ALL

Displays the entire trace buffer. This is the default.

/CONTAINING=value

Displays only records where any of the traced parameters is equal to value.

/CPU=cpu-num

Displays only records from threads executing on CPU cpu-num.

/LINENUMBER=linenumber

Displays only records from tracepoints at line linenumber in the relevant source files.

/MATCH [= AND|OR]

Alters the sense of the match condition when more than one of the filter qualifiers /CPU, /LINENUMBER, /FILENAME, /Px, or /CONTAINING are specified.

/Px=value

Displays only records where one of the traced parameters P1, P2, P3, or P4 is equal to value.

/RAW

Displays contents of trace records in hexadecimal format without interpretation. By default, the values are displayed in human readable format with filenames.

Description

The SHOW TRACE command outputs the contents of each entry in the XFC trace buffer. Currently, detailed XFC tracing is enabled only for debug versions of XFC.


Example


This example shows the output of XFC trace information.


XFC SHOW VOLUME

Displays the contents of a cache volume block (CVB).

Format

XFC SHOW VOLUME [address]/BRIEF|/FULL| /NAME=DISK $volume_label| /STATISTICS


Parameter

address

The address of a CVB. If no address is supplied, then all volumes are displayed.

Qualifiers

/BRIEF

Displays summary information for each volume.

/FULL

Displays a complete list of information about each volume. This is the default.

/NAME=DISK$volume_label

Displays information for the volume with the specified name.

/STATISTICS

Displays the read and write I/O activity for this volume. The /STATISTICS qualifier is incompatible with the /BRIEF qualifier.

Description

The SHOW VOLUME command shows state information and statistics about all volumes mounted on the system.


Examples


The above example shows the output derived from invoking the /BRIEF qualifier.


2. SDA> XFC SHOW VOLUME FFFFFFFD831FE080
Cache Volume Block (CVB)
------------------------
Statistics Valid From:   19-APR-2002 07:10:23.54 
 
Name:                  DISK$FRROOG_RUBY 
CVB Address:           FFFFFFFD831FE080 
Flink:                 FFFFFFFF80D30238 
Blink:                 FFFFFFFD831FE300 
Volume (VCB):          FFFFFFFF81905100 
Unit (UCB):            FFFFFFFF8150F200 
Files Queue:           FFFFFFFD831FE0C0 
    Flink:               FFFFFFFD83111800 
    Blink:               FFFFFFFD831FC0A0 
Cached Open Files:            236 
Cached Closed Files:          157 
Files Ever Opened:            502 
Files Ever Deposed:           109 
Pages Allocated:             2726 
Total QIOs:                  4195 
Read Hit Count:              2408 
Virtual Read Count:          4085 
Virtual Write Count:          110 
Read Percentage:               97 % 
Hit Rate:                      57 % 
Average Overall I/O response time to this Volume 
 in milliseconds:             2.1186 
Average Cache Hit I/O response time to this Volume 
 in milliseconds:             0.0789 
Average Disk I/O response time to this Volume 
 in milliseconds:             4.8671 
Accuracy of I/O resp time:     83 % 
Readahead Count:              233 
Volume Caching Mode:   evcmVIOCCompatible 
Mounted /NOCACHE:      False     VCML Allows Caching:   True 
Quiescing:             False     Quiesce in Progress:   False 
No Cache from Logio:   False     VIL Blk AST Stall:     False 
Flush Pending:         False     VCML Blk AST Stall:    False 
VCML Blk CTX Stall:    False     VIL Blk CTX Stall:     False 
Dismount Stall:        False     Logio Stall:           False 
Flush in Progress:     False     Cluster Trans Stall:   False 
Dismount Pending:      False     VIL Up Needed:         False 
Tqe In Use:            False     VCML Up Needed:        False 
VIL blocking AST CTX:  0000000000000000 
VCML blocking AST CTX: 0000000000000000 
Dismount Stall CTX:    0000000000000000 
LogIO Stall CTX:       0000000000000000 
Up conversion CTX:     0000000000000000 
VIL lock id:           0100007A 
VIL LogIO lock id:     00000000 
VCML lock id:          010000FF 
VCML LogIO lock id:    00000000 
Logical IO safety:     elogioNotSafe 
LogIOMutex:            00000000818EB610 
Last LogIO time:       00000000 
Active I/O count:              0 
Stalled Ops Queue:     FFFFFFFD831FE0B0 
    Flink:               FFFFFFFD831FE0B0 
    Blink:               FFFFFFFD831FE0B0 
 
 
Volumes found: 1

This example shows the output for a specific cache volume block (CVB).


Previous Next Contents Index