Trace Filter

ContentRocview

  • Trace filter

Menu location: Rocview→Help→Trace


Introduction

With this dialog Rocrail server trace files can be loaded and filtered to find out some problems in the automatic sequence or other issues.
The traces are in English only and are only of help if the user can read them.
For novice users the Forum is the first choice looking for help.


Features

  • Requests from server all available trace file names which are listed beside the Open button.
  • Requests from server the currently used trace file and display it.
  • Color highlighting.
  • Trace ID selection.
  • Trace level selection.
  • Object selection.
  • Free search by the Text field.
  • Real time trace tab.


Restrictions


Color

Trace level Char Color
Exception E red
Warning W yellow
Automatic a green
Calculation v blue


Functions



ID

Qualification
Trace line ID. (At the moment most lines have the 9999 ID… → WIP.)
Range: …9999. An asterisk is a place holder for every number between 0…9.
After changing this value the Enter key or the Search button have to be activated.
See also: Trace IDs

Level

Select a trace level or All.
See Color

Type

Object type to search for.
Left empty to view all.

Type Object
OAction Action
OBlock Block
OCar Car
OFBack Sensor
OLoc Locomotive
OModel Model
OOperator Operator
OOutput Output
OPowerMan Power manager
ORoute Route
OSelTab Fiddle Yard
OSignal Signal
OStage Staging block
OSwitch Switch
OText Text
OTT Turntable or Traverser
OWeather Weather
OXmlScript XmlScript

Text

Free text to search for. (May be left empty.)
After changing this value the Enter key or the Search button have to be activated.

Open

Open a server trace file.
If a trace is selected in the drop down box it will be requested from the server, otherwise a file chooser dialog will be pop up to open a local trace file.
Rocview traces may also be opened in this dialog but are mostly irrelevant.

Server

The list of available trace file names received from the server with file size and file date.
After a selection change the file will be requested from the server.

Save

The filtered trace can be saved locally for further use like reporting it in the Forum or in combination with an Issue

Search

Reload the selected server trace file with a new type and ID filter.

State

Show the processing state.

Help

Opens this Wiki page in the default WEB browser.


Trace Header

The trace header is on top of the trace text field and looks like this:

yyyyMMDD.HHMMSS.mmm a ID l Thread   Object   Line Message
Column Description
yyyy Year
MM Month
DD Day
HH Hour
MM Minutes
SS Seconds
mmm Milliseconds
a Application code
ID Trace line ID
l Trace level
Thread Thread name
Object Object type
Line Line in the source code. This line can be found in the source file of the Object implementation.
Message The trace message.

Source line

Example:
If the object type is OLoc the corresponding source file is:

Rocrail/rocrail/impl/loc.c

The Object source file relation can be found in:

Rocrail/rocrail/rocrail.xml
Rocrail/rocdigs/rocdigs.xml
Rocrail/roclcdr/roclcdr.xml
Rocrail/rocs/rocs.xml


Messages documentation

Memory

For developers to check memory usage in Rocview.
The labels on this tab are not translated.

This tab shows the use of Rocs objects in Rocview.
The Refresh button replaces the left panel with the current use and the right panel with the previous use.
Both panels are compared with each other and the lines who differ are highlighted with a red background color.
The Fix previous option will prevent replacing the contents of the right panel.


Personal Tools