Messages

On the "Messages" tab, TNCdiag shows a list of all logged diagnostics events since the last control startup.

The structure and functionality of the list is similar to other HEIDENHAIN programs such as TNCanalyzer.

List of events

The list of events and the Timeline are different representations of the same information.

The list consists of rows and adjustable columns. Each row represents one event that has been logged.

TNCdiag distributes the event data to various columns:

Index

Sequential index showing the sequence of events; if numbers are missing, not all events are visible.

Time

(Local) time of the event

Time (UTC)

Time of the event (UTC time)

Reference time

Time difference with respect to the Reference position

Path

Branch in the Device tree

Device

Device or drive the event is associated with

Category

Type of event

Mode

Indicates the category

Message

Description of the event

You can specify which columns are to be shown in the list. To do so, right-click a column header to open the context menu, and there select or deselect one of the offered columns, or use the Select columns... command to open the column-selection dialog box.

Click each column header to change the sorting sequence of the list.

TNCdiag assigns each event to an event class. These are color-coded in the first column:

Error event

Information event

Debugger event

In the timeline, TNCdiag uses the same colors for the events.

Device tree

By selecting a device or drive in the Device tree on the left-hand side, you filter the event list so that only the events of this node and its child nodes will be shown.

An exception to this are the two root nodes named Drives and MC: If you select one of these nodes, TNCdiag will display all events.

Navigation path

The Navigation path above the diagnostic window shows the current position in the device tree.

Toolbar

The event list has its own toolbar with the following functions.

Searches for the preceding error event, starting from the selected event

Searches for the subsequent error event, starting from the selected event

Opens or closes the search bar

Sets the evaluation time to the first list entry

Sets the evaluation time to the last list entry

Scrolls the list so that the evaluation time becomes visible

Sets the evaluation time to the selected list entry

Sets the evaluation time to the reference position in the list

Status display

Next to the toolbar, TNCdiag displays some status information.

The value in the first section indicates the overall number of events. The second section shows the number of errors.

The data is displayed in the following format:[number of visible events] / [number of available events].

You can define the visible events by selecting a device or axis or by selecting the displayed event classes (Information, Debug) with the View command. Events of the "Error" event class are displayed at all times.

You can use the Edit > All devices, Edit > Drives, and Edit > IO commands, or the, , and icons in the evaluation toolbar to limit the number of available events. Depending on the selection, TNCdiag displays all events or only the events relevant to the selected view.

Searching the event list

With the icon in the toolbar, you can toggle the display of the search bar. The search bar contains the following functions:

Searches for the previous event, starting from the selected event

Searches for the next event, starting from the selected event

[...]

Search term

If this icon is selected, the search will be context sensitive

If this icon is selected, the search must fully match the search term

If this icon is selected, the term will be interpreted as a regular expression

Select search columns

Opens a dialog for selecting the columns to be included in the search

TNCdiag updates the search results as you start typing: Rows with a match are highlighted in yellow, the corresponding cells are formated in bold. Starting from the selected node, TNCdiag jumps to the first matching event and selects it.

In addition, the relative position of the match is shown in the scroll bar.

You can show or hide the search results by toggling the search bar.

Reference position

You can set the reference position to the desired event with the Time evaluation > Set reference position command or the context menu. The reference position will be marked by an anchor symbol .

There is only one reference position. If the reference position had been set before, it will be moved by setting the reference position again. You can move the reference position with the mouse.

The reference position is used to mark the reference time. This is helpful if you want to display relative times. Using relative times, it is very easy to determine a time difference with respect to a certain point in time. Relative times are shown in the Reference time column.

The reference position is also shown in the Timeline.

Bookmarks

You can set a bookmark for a certain event with the Time evaluation > Set bookmark command or the context menu. You can set any number of bookmarks.

Each bookmark is indicated by a symbol in the first column. TNCdiag uses a unique number for each bookmark.

You can move the position of a bookmark with the mouse.

If multiple bookmarks are superimposed, TNCdiag displays a pile symbol.

If an event having a bookmark is removed from the list, e.g. because you select a different device in the device tree, the bookmark will be maintained. TNCdiag will then display the bookmark between the rows. This can also happen if you move a bookmark on the timeline with the mouse so that it is located between two events.

TNCdiag provides a dedicated bookmark management window. There, you can store comments for bookmarks that will then be displayed as tooltips.

Exporting data

With the Extras > Export messages as PDF file... command or the  icon in the diagnostics toolbar, you can write the list contents to a PDF file.

Alternatively, all selected rows can be copied to the clipboard with the Edit > Copy command and then pasted to other programs.