Trace

Rocrail Trace, What is it good for

Traces are to make program activities visible to understand what is happening or trying to solve problems.

Rocrail trace tab.

Switch off all trace levels for better performance.


Automatic

Shows in detail what the automatic library is doing and is especially handy for tracing down problems occurring when running trains in this mode.

Monitor

Standard switched on to show activities of digital decoders and events.
Use with care because all messages are also send to Rocview which could get a queue overflow if the monitoring is very massive.
In most cases: Disable this option if all decoders are working as expected.

Calculation

Traces the speed and BBT calculations.

Byte

:!: Do not use as normal user. :!:

This is for developers only and dumps out at byte level what is send and received between Rocrail and the Command Station(s).

Info

For watching all Rocrail server activities; Should be turned off if all runs well.

Debug

:!: Do not use as normal user. :!:

All normally unnecessary remarks are shown and will probably slow down the Rocrail server. This trace level is only for developers and testers to use.

Number of trace files

The number of recycle trace files.
The default is 10.
Only one file is used if set to zero or one; This file will grow unlimited!

Trace file size

The trace file size in KB if the number is set greater then 1.
The default is 100KB.

Send all traces to Rocview

:!: Do not use as normal user. :!:

All server traces, regardless the level, are send to all Rocview clients. This is for remote support and for those who are interested in everything.
It will slowdown Rocview because of the heavy processing of the flood of trace events.


Trace file

The name of the trace file to be used. Trace files will get a running number to get a history of 10 for debugging and service.


Path

Path to store the trace files; In the working directory if left empty.

Trace line format

20081018.150939.425 g9999I main     render   1203 setting signal 8s11 to white
timestamp app code level thread object source line message
20081018.150939.425 g 9999 I main render 1203 setting signal 8s11 to white


Timestamp format

YYYYMMDD.HHmmSS.sss


Level Code

Level Code
TRCLEVEL_EXCEPTION E
TRCLEVEL_INFO I
TRCLEVEL_WARNING W
TRCLEVEL_DEBUG D
TRCLEVEL_BYTE B
TRCLEVEL_METHOD T
TRCLEVEL_MEMORY M
TRCLEVEL_PARAM A
TRCLEVEL_PROTOCOL P
TRCLEVEL_ERROR R
TRCLEVEL_PARSE S
TRCLEVEL_WRAPPER Z
TRCLEVEL_USER1 a auto mode
TRCLEVEL_USER2 b HTTP
TRCLEVEL_MONITOR c
TRCLEVEL_XMLH d
TRCLEVEL_CALC v



Personal Tools