Touring AreasTour Areas: [1] Minimal Source Code Instrumentation

[6] Viewing Data in DTraq, Live and Recorded

When dtq-dv starts up, two windows are displayed, one being the DTraq control panel, and the other the Tap Data Table.

The control panel has two tabs, one for recording and logging Live data coming in from tapped applications, and the other for reviewing data logged during previous runs.

While connected to a tapped application, the Logging Status is either Recording or Suspended, which indicates whether the tapped data is coming into the server is being logged. The Resume and Suspend buttons control that activity.

The name of the currently active log file is displayed, along with a button ("Stow Current Logfile") that causes that file to be closed off, with logging restarting into a new file.

All the server configuration preferences are described in detail in the DTraq User Manual. Configuration of the logging server can only be performed while logging is suspended, so in this display the Preferences button is enabled.

The Show and Hide buttons control the visibility of the Tap Data Table (described below), while the two Exit buttons terminate either the client viewer alone or shut down the logging server, as well as the viewer.

The Tap Data Table lists all the data items for which data is being logged.

The Tap Data Table in the Recording Mode has seven columns:

Tap ID

The ID associated with a specific DTraq.Tap instantiation.

Type Name

The name of the type that is being tapped.

Log Item

Enable/disable logging of the data for that tap. Check the box to enable logging, uncheck it to stop.

View Live

Enable/disable live monitoring of the data as it is received. Check the box to open a Data Item Display window displaying the data as its is received, uncheck it to close the window and cease live viewing.

Base

The numeric base to use when viewing numeric data items or the components of composite items (records and arrays). Available bases are 2, 8, 10, and 16.

Display As

The general form in which to view the data item--string, enumeration, or one of variously sized numeric groupings, e.g., byte or word.

Comment

The optional text string that was provided when instantiating DTraq.Tap.

The buttons in the Logging and Viewing button rows operate on the Log Item and View Live settings as a whole. Enable All/View All sets all the checkboxes in the respective columns and triggers the corresponding action, while Disable All/Close All unchecks them. Clicking Invert checks all boxes that are unchecked, and unchecks all boxes that are checked. And Undo Last undoes whatever button action was last made.

Clicking the Configuration Save button stores all the current Enabled and Viewing settings to a file that can later be reloaded by clicking on the Configuration Load button.

Hide iconifies the Display.