File-Capture - IBM WebSphere XS40 Command Reference Manual

Datapower xml security gateway
Table of Contents

Advertisement

Related Commands
cancel, exit, send error-report

file-capture

Controls the file capture trace utility.
Syntax
file-capture {always | errors | off}
Parameters
always
errors Enables the file capture trace utility and provides a trace for failed
off
Guidelines
The file-capture command enables or disables the file capture trace facility. File
captures facilitate visibility into erroneous XML or XSLT content as well as provide
a record of the sources of erroneous content.
To support file capture, the appliance document trace function creates a RAM-disk
to house a WebGUI-accessible virtual file system for tracing all traffic through the
appliance. Each transaction appears in a file hierarchy broken down according to
the semantics of its URL (that is, a directory for the hostname portion and a
directory for each slash portion of the URL) and then further by individual
transaction.
Each transaction that represents a transformation stores not only the inputs, but
information on style sheets, and disposition of the transformation.
Documents are stored in compressed format to reduce byte count. Should
documents need to be removed from the RAM-disk space they will be removed on
a FIFO basis.
While browsing the virtual file system repository via the WebGUI, any point in the
directory hierarchy can be downloaded either as a tar ball or a zip file.
Note: With file capture enabled (either always or errors), significant performance
Related Commands
packet-capture
Examples
v Enables the file capture trace utility for failed transactions only.
Enables the file capture trace utility and provides a trace of all appliance
traffic.
transactions only.
(Default) Disables the file capture trace utility.
penalties are imposed. Consequently, file capture should be enabled only in
test environments, not in production environments.
# file-capture errors
File capture mode set to errors
#
Chapter 2. Global configuration mode
45

Advertisement

Table of Contents
loading

Table of Contents