User Tools

Site Tools


rocrailini-trace-en

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.
If everything is as it should be: Turn off all trace levels.

Rocrail trace tab.

Switch off all trace levels for better performance.


User Trace level

Information

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

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.

Permissions

List up why a locomotive or train has no permission to run in a block or to use a route.

Note A handy trace to see why a loco doesn't go to the next block.

Monitor

Standard switched OFF; 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 MVTrack speed and BBT calculations.
Also the final results of the track plan Router will traced.

Find

Extra trace in case no destination is found.

Router

Traces from the Track plan Router.

Language

Language in which to output translatable server trace lines. (currently only for "Permissions" level)

Developer Trace level

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).

Memory

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

This is for developers only and traces out in case more memory is allocated.

Number of trace files

The number of recycle trace files.
The default is 3.
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.
For using the Trace Filter leave it at 100KB.

Trace file

The name of the trace file to be used.
Trace files will get a running number to get a history of 10 (see value in trace files field) for debugging and service.
If left empty no trace file will be written.

Path

Path to store the trace files; In the working directory if left empty.
Note: Starting from revision 2.1.1057 the use of environment variables in the Trace Path is allowed, for example: %HOME%/trace

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 Remark
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 automatic mode
TRCLEVEL_USER2 b HTTP
TRCLEVEL_MONITOR c
TRCLEVEL_XMLH d
TRCLEVEL_STATUS s
TRCLEVEL_XMLSCRIPT x
TRCLEVEL_CALC v
TRCLEVEL_ROUTER y
TRCLEVEL_DEVELOP q
TRCLEVEL_PERMISSION p block and route permissions


Trace IDs

ID Range Usage
2001…2099 Model route selection
4001…4199 Loco automatic
5001…5099 Block permissions
5101…5199 Route permissions
8001…8199 Router

See also: Trace Filter

Messages documentation

rocrailini-trace-en.txt · Last modified: 2022/11/05 02:02 by rainerk