Deprecated feature: Configuring tracing and logging for the mass load utilities
In addition to the individual logs for some of the mass loading utilities, you can
configure a message log file, messages.txt, and a trace file,
traces.txt. You can configure the contents and location of these files by
editing the WCALoggerConfig.xml file.
Procedure
Open the file in a text editor:
WC_installdir/xml/loader/WCALoggerConfig.xml
WCDE_installdir/xml/loader/WCALoggerConfig.xml
Note: The WCALoggerConfig.xml file can be found in the following two locations:
WC_eardir/xml/loader/WCALoggerConfig.xml is used by the
loader utilities when run from the command line.
WC_installdir/instances/
instance_name/xml/loader/WCALoggerConfig.xml is used by the loader
utilities in the server context, for example during the store publish process.
Modify the contents of the file as follows:
Define the parameters for tracing:
The trace tag defines the following information about the loading utilities trace file:
The traceFile attribute defines the full path (including the trace file
name) to the trace file.
The enable attribute indicates whether tracing is enabled (enable="true")
or disabled (enable="false").
The fileSize attribute specifies the maximum size of the trace file, in
megabytes (MB). The default value is 1024. After the trace file size is exceeded, a new trace file
is started. The old trace file is backed up with a time stamp added to the trace file name.
The component tags define the components for which trace is enabled. If a
component is not listed or a component tag is commented out in the file, trace information is not
gathered for that component.
Loading utility
Trace component name
dtdgen
COMPONENT_DTDGEN
fileloader
COMPONENT_ATTACHMENT
idresgen
COMPONENT_IDRESGEN
massextract
COMPONENT_MASSEXTRACT
massload
COMPONENT_MASSLOAD
xmltransform
COMPONENT_XMLTRANS
The default location:
WC_installdir/logs/trace.txt
WC_userdir/instances/instance_name/logs/trace.txt
WCDE_installdir/logs/trace.txt
Define the parameters for logging:
The messageLog tag defines the following information about the loading
utilities log file:
The messageFile attribute defines the full path (including log file name)
to the log file.
The enable attribute indicates whether logging is enabled (enable="true")
or disabled (enable="false").
The fileSize attribute specifies the maximum size of the log file, in
megabytes. The default value is 1024. Once the log file size is exceeded, the log file is
overwritten from the start of the trace file.
The logSeverity tags define the types of messages to write to the log file.
If a message type is not listed or a logServerity tag is commented out, those
message types are not recorded in the log file. The following table lists message types that can be
logged:
logSeverity type
Description
INFO
Information messages follow events that occur while the loading utilities run. Information
messages are related to events that trigger changes in the system state.
WARNING
Warning messages reveal a potential problem.
ERROR
Error messages expose an error condition that can lead to system malfunction.
Note: You can use the -DDebug=true parameter to get more traces for the
loader utilities that can be helpful in getting more debugging information for problem
determination.
By default, only error messages are written to the message log file.
Ensure that the full path to WCALoggerConfig.xml is defined as part of the
class path environment variable before you run any of the loading utilities.