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.