1 XFC_Extension The SDA extension commands for Extended File Cache (XFC) enable you to display the following information in a convenient and readable format: o Various XFC data structures o 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. You can enter XFC commands at the SDA prompt or you can access online help, as follows: SDA> XFC HELP 2 SET 3 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] 4 Qualifiers /SELECT /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. 2 SHOW 3 CONTEXT Displays the contents of an XFC context block (CTX). Format XFC SHOW CONTEXT [address][/STALLING|/FULL|/BRIEF] 4 Parameter address The address of the CTX. If no address is supplied, then all the context structures are displayed. 4 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. 3 EXTENT Displays the contents of an extent control block (ECB). Format XFC SHOW EXTENT address 4 Parameter address The address of the ECB. 3 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] 4 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. 4 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 /CVB=address Displays information only for files matching the given cache volume block address. /DISPLAY_NAME /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 /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. 3 HISTORY Displays approximately three days of XFC activity in 10-minute intervals. Format XFC SHOW HISTORY 3 IRP Displays a subset of the fields of an I/O Request Packet that has relevance for XFC debugging. Format XFC SHOW IRP address 4 Parameters address The address of the IRP structure whose relevant fields are to be decoded and displayed. 3 MEMORY Displays information about memory used by the cache. Format XFC SHOW MEMORY [/BRIEF|/FULL] 4 Qualifiers /BRIEF Displays summary statistics on XFC memory use. /FULL Displays full statistics on XFC memory use. This is the default. 3 SUMMARY Displays general information about the Extended File Cache. Format XFC SHOW SUMMARY [/STATISTICS] 4 Qualifier /STATISTICS Additionally, displays read and write activity arranged by I/O size. 3 TABLES Displays both the extent hash table (EHT) and the file hash table (FHT). Format XFC SHOW TABLES [/ALL][/EXTENT][/FILE][/SUMMARY] 4 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. 3 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] 4 Qualifiers /ALL Displays the entire trace buffer. This is the default. /CONTAINING /CONTAINING=value Displays only records where any of the traced parameters is equal to value. /CPU /CPU=cpu-num Displays only records from threads executing on CPU cpu-num. /LINENUMBER /LINENUMBER=linenumber Displays only records from tracepoints at line linenumber in the relevant source files. /MATCH /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 /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. 3 VOLUME Displays the contents of a cache volume block (CVB). Format XFC SHOW VOLUME [address]/BRIEF|/FULL| /NAME=DISK$volume_label| /STATISTICS 4 Parameter address The address of a CVB. If no address is supplied, then all volumes are displayed. 4 Qualifiers /BRIEF Displays summary information for each volume. /FULL Displays a complete list of information about each volume. This is the default. /NAME /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.