Enabling tracing
You can enable tracing in one of the following ways:
- By defining the
TraceFile
,TraceLevel
, andTraceFileCount
global parameters in the mcxa.conf file
Additional global parameters also affect tracing. - By using the
mcxa.cmd
ormcxa.sh
commands
mcxa command options lists the command-line options that you can use to enable tracing with themcxa.cmd
ormcxa.sh
commands.
Trace files
By default, the mcxa process trace file is installationDirectory\pw\server\tmp\Adapters\mcxa.trace. Each time the adapter is started, a new trace file is created and old logs are rotated.
You can control the number of old log files through the TraceFileCount
parameter setting in the mcxa.conf file. A value of 0 (zero) removes all old trace files. For more information and default values, see the header of the mcxa.conf file.
You can specify a different trace file in a different location by using the mcxa.cmd
or mcxa.sh
commands. For more information about command-line options, see mcxa command options.
Trace levels
Use the TraceLevel
global parameter in the mcxa.conf file to specify the trace level that you want to use. This setting will apply to all adapters running in the adapter framework. You can specify the following trace levels:
- 0 - Disables all traces
- 1 - Header messages
- 2 - Fatal messages
- 3 - Major errors
- 4 - Minor errors
- 5 - Normal output
- 6 - Verbose output
Note
TraceLevel=6
produces very large trace files and is recommended only for debugging.
Errors and adapter events
In addition to logging errors to a log file, adapters send the cell error messages and notifications in the form of events in the following situations:
- When an adapter starts, it sends an MC_ADAPTER_START event.
- When an adapter stops, it sends an MC_ADAPTER_STOP event.
- When the adapter encounters a major or fatal error in the configuration file, the adapter reports the error in the trace file according to the trace level. When the error does not come from the configuration file, the adapter reports the error to the cell whose name corresponds to the
ServerName
parameter of the[eventadapter90trial:default]
(unnamed) section of the configuration file. The event class is MC_ADAPTER_ERROR.
Error and message events sent by the IP Adapters are described in Adapter status events.
Comments
Log in or register to comment.