Displays information contained in various internal XFC data structures.
1 – CONTEXT
Displays the contents of one or more XFC context blocks (CTX). Format SHOW CONTEXT [address] [/BRIEF] [/FULL] [/STALLING]
1.1 – Parameters
address The address of a context block. If no address is specified, then all context blocks are displayed.
1.2 – Qualifiers
1.2.1 /BRIEF
For each context block, displays a brief summary that includes such contents as the I/O type, the start virtual block number (VBN), and the I/O block count.
1.2.2 /FULL
Displays the complete contents of each selected context block. This is the default.
1.2.3 /STALLING
Shows only contexts that are in a stalled state (i.e., have a stall reason code other than estrNotStalling).
2 – EXTENT
Displays the contents of an extent control block (ECB). Format SHOW EXTENT address
2.1 – Parameters
address The address of the extent control block (ECB).
3 – FILE
Displays the contents of one or more cache file blocks (CFB). Format SHOW FILE [address] [/BRIEF] | [/EXTENTS] | [/FULL] | [/STATISTICS] [/CLOSED] [/CVB=] [/ID=] [/OPEN] [/DISPLAY_NAME]
3.1 – Parameter
address The address of the cache file block (CFB). If no address is specified, then all cache file blocks are displayed (subject to selection by the /CLOSED, /CVB, /ID, and /OPEN qualifiers) .
3.2 – Qualifiers
3.2.1 /BRIEF
Displays summary information for each CFB: CFB address, CVB address, access count, active I/O count, and file specification or ID*. The /BRIEF qualifier is incompatible with each of the /EXTENTS, /FULL, and /STATISTICS qualifiers. *If the file specification is available, via LIB$FID_TO_NAME(), it is displayed; otherwise, the FID is displayed. Note that, 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.
3.2.2 /CLOSED
Displays only CFBs whose access count is zero.
3.2.3 /CVB
/CVB=address Displays CFBs whose CVB address matches the specified one.
3.2.4 /DISPLAY_NAME
/DISPLAY_NAME (default) /NODISPLAY_NAME Controls whether the file specification is displayed.
3.2.5 /EXTENTS
/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 and VBNs. 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.
3.2.6 /FULL
Displays all fields for each Cache File Block except for those displayed by the /EXTENTS and the /STATISTICS qualifiers. This is the default. If the file specification is available, via LIB$FID_TO_NAME(), it is displayed; otherwise, the FID is displayed. Note that, 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.
3.2.7 /ID
/ID=file-id Displays only information about files whose file ID match the one specified. The file id (FID) is the hex file number component in a [file number, sequence number, relative volume number]-format file ID.
3.2.8 /OPEN
Displays only CFBs whose access count is greater than zero.
3.2.9 /STATISTICS
/STATISTICS Displays more statistics about the specified file. The /STATISTICS qualifier is incompatible with the /BRIEF qualifier.
4 – HISTORY
Displays XFC activity in 20 minute intervals.
5 – IRP
Displays a subset of the contents of an I/O Request Packet that has relevance for XFC debugging. Format SHOW IRP address
5.1 – Parameters
address The address of the IRP structure whose relevant fields are to be decoded and displayed.
6 – MEMORY
Displays information about memory used by the cache. Format SHOW MEMORY [/BRIEF | /FULL] [/VERIFY]
6.1 – Qualifiers
6.1.1 /BRIEF
Displays summary statistics on XFC memory usage.
6.1.2 /FULL
Displays full statistics on XFC memory usage. This is the default.
6.1.3 /VERIFY
Displays detailed page distribution of memory use.
7 – SUMMARY
Displays general information about the Extended File Cache. Format SHOW SUMMARY [/STATISTICS]
7.1 – Qualifiers
7.1.1 /STATISTICS
Displays read and write activity by IO size.
8 – TABLES
Displays contents of both the extent hash table (EHT) and the file hash table (FHT) table. Format SHOW TABLES
8.1 – Qualifiers
8.1.1 /ALL
Displays the contents of both the EHT and FHT. This is the default.
8.1.2 /EXTENT
Displays the contents of the EHT only.
8.1.3 /FILE
Displays the contents of the FHT only.
9 – TRACE
Displays all or selected portions of the XFC trace buffer starting with the most recent entry and moving backward in time. Format SHOW TRACE [/ALL] [/COUNT] [/CPU] [/LINENUMBER] [/LABEL] [/P1][/P2][/P3][/P4][/PX] [/MATCH]
9.1 – Qualifiers
9.1.1 /ALL
Displays the entire trace buffer.
9.1.2 /COUNT
/COUNT=count Restricts the display to the first 'count' matching records.
9.1.3 /CPU
/CPU=cpu-num Display only records from threads executing on CPU cpu-num.
9.1.4 /LABEL
/LABEL=string Displays only records for which the label field contains string.
9.1.5 /LINENUMBER
/LINENUMBER=linenumber Displays only records from tracepoints at line linenumber in the relevant source files.
9.1.6 /MATCH
/MATCH[=[AND|OR]] (default /MATCH=OR) Alters the sense of the match condition when multiple filter qualifiers (/CPU, /LINENUMBER, /LABEL, /P1, /P2, /P3, /P4, or /PX) are specified.
9.1.7 /P1
/P1=value Displays only records for which the traced parameter P1 is equal to value.
9.1.8 /P2
/P2=value Displays only records for which the traced parameter P2 is equal to value.
9.1.9 /P3
/P3=value Displays only records for which the traced parameter P3 is equal to value.
9.1.10 /P4
/P4=value Displays only records for which the traced parameter P4 is equal to value.
9.1.11 /PX
/PX=value Displays only records where one or more of the traced parameters are equal to value.
10 – VOLUME
Displays cache information about cached volumes. Format SHOW VOLUME [address] [/FULL] [/BRIEF] [/STATISTICS]
10.1 – Parameters
address The address of a specific volume descriptor (CVB), otherwise all volumes are displayed.
10.2 – Qualifiers
10.2.1 /BRIEF
Displays summary information for each volume: Volume label, CVB address, number of cached files.
10.2.2 /FULL
(Default) Displays a complete list of information about the volume(s).
10.2.3 /NAME
/NAME=DISK$volume_label Displays information for the volume with the specified name.
10.2.4 /STATISTICS
/STATISTICS Displays the read and write IO activity for this volume. Incompatible with /BRIEF.