Configuring mcell.trace

The trace configuration file, mcell.trace, configures the tracing of the cell's operation. Tracing messages are divided in several levels. Every module of the cell can be configured differently. An output destination can be determined per message level and per module. Messages also can be disabled at the same granularity.

The default location is installationDirectory\pw\server\etc.

The configuration commands in mcell.trace are incremental. Every new command adds to the configuration, possibly overriding previous commands either completely or partly.

The following figure shows the format of a configuration line in the mcell.trace file.

Format of configuration line in mcell.trace file

<Module>  <Level>   <Destination>
SWITCH    <Switch>  <Destination>

The following table lists the parameters that must be defined in a configuration line.

Trace configuration file parameters

Parameter	Description
`Destination`	Destination file name or predefined value for the selected trace messages or switch. Predefined values are: `no`—Disables these tracing messages `console`—Sends to the console device `stderr`—Sends to standard error stream
`Level` ^a	Message severity value level Predefined values are:
`Level` ^a	`FATAL` `ERROR` `WARNING`	`INFORM` `VERBOSE`
`Module` ^a	Name of module, each of which corresponds to a particular category of information, such as filtering or configuration; values are as follows:
`Module` ^a	`ACTION` `COLLECT` `COLLMAP` `CONFIG` `CONTROL` `DATAPROC` `DBDATAID` `DBEVTID` `DBEVTTM` `EVTLOG` `EVTPROC` `EXPORT` `FILTER`	`HEARTBEAT` `INTEVT` `MC2TEC` `MCBAROC` `MESSAGES` `METRIC` `PROPAGATE` `QUERY` `RECOVERY` `RECTRL` `REGEX` `REGULATE`	`RESULT` `ROLES` `RULES` `SERVICE` `SRVMGT` `STATBLD` `SVCMGT` `SVRCOMM` `SVRDIR` `SYNCH` `SYSPROC` `TRACE`
`SWITCH`	Keyword that enables access to a sublevel or category of messages for a module
`Switch`	Switch name
^a You can also specify `ALL` or `*` (wildcard) for these parameters.

Configuring mcell.trace

Comments