View COPIAFACTS and FFTRACE Trace Files

TRCVIEW

The TRCVIEW Program is used to view CopiaFacts daily call trace files from the main COPIAFACTS engine (nodename.TRx) or from all other programs via FFTRACE (nodename.FTx). In these filenames, 'x' designates the day of week.

When run on the same machine as COPIAFACTS, loading or reloading the trace file into TRCVIEW automatically causes CopiaFacts to flush the latest buffered data out to the file. This provides an easy way of viewing earlier data than is available in the COPIAFACTS.EXE scroll back buffer. If viewing a COPIAFACTS trace from another machine, click on the globe image in COPIAFACTS to force the trace file to be flushed to disk before loading it in TRCVIEW.

The TRx and FTx files can optionally be associated with TRCVIEW in the installer, so you may double-click them in Explorer. When you restart COPIAFACTS several times in succession, only the latest session appears initially in TRCVIEW. Earlier sessions in the file can be retrieved using the sessions menu. You can also display data for selected groups of lines only.  When used to display files created by FFTRACE, the menu allows selection of the different applications to be viewed.

The toolbar on the right provides various ways of navigating the file and highlighting information. See the tool-tip hints for details of the use of each button.  Individual text lines can be copied from the trace by scrolling the line to the center yellow line and double-clicking it.  This will pop up a window to allow text to be copied.  You can also highlight a filename in the pop-window and right-click it, then if the file can be found a pop-up menu line will allow you to view the file.  Most common file extensions are supported, and for files such as PDF or DOC an appropriate application must be registered to process the view.  Filenames without a path element are searched for in the appropriate locations.

TRCVIEW is limited to viewing trace files of up to about 512MB, and if the file is larger will load only the last 512MB. This limit will still require your machine to have ample free memory. To load a smaller part of the tail of the file, specify a value smaller than 512 in the environment variable TRCVIEW_LIMIT.  Also, consider disabling some of the trace settings to make the file size manageable.

Automatic Line Number and Application Filter

The F9 key can only be used with engine trace files or with FFTRACE files that show line numbers. When first pressed, the display is filtered on the "CopiaFacts line number" of the trace line that is shown on the yellow highlight line.  The highlight-line color changes to blue.  Pressing F9 a second time restores the full display.  When this special filter is active the line number settings from the Lines menu item are ignored.  Reloading the same or another file clears the filter if enabled.

Background Colors

Normal Center Bar

Center Bar when Filtered on Line Number (F9)

Result: Error (no more retries)1

Result: Error (will be retried)

Result: Success

Keyboard Shortcuts:

Ctrl-Fopens the highlight/search dialog: you can specify multiple strings delimited by '|' (and change the delimiter character).
Ctrl-Topens the 'go to time' dialog
F1show this help topic
F3/shift-F3move forward/back to the next highlight
F4/shift-F4 move forward/back to the next error message
F5reload trace file
F9toggle temporary filter using the line number of the trace line on center highlight bar
F11show last session only
F12show all sessions
0scroll to start of line
Shift-ctrl-1 drop bookmark 1 (nine are available, using up to shift-ctrl-9) on the center highlighted line.  The bookmark is shown in red at the start of the line, next to the left edge of the window, even if the display has scrolled horizontally.  Pressing the same set bookmark keys on the same line clears the bookmark.  Setting a different bookmark on a bookmarked line replaces the original bookmark.
Ctrl-1go to bookmark 1 (nine are available, up to ctrl-9).  If the bookmark is on a line that is hidden by filtering on session, line or application, a 'beep' sounds.  If no matching bookmark has been set, the key is ignored.
Shift-ctrl-0save all bookmarks in the registry.  Only one set can be saved and it is not associated with a filename.
Ctrl-0load saved bookmarks.  If the bookmarks were saved while viewing a different file, loading them will not be very useful.

The bookmarks are all cleared on loading a new file, but not on a reload of the same file using F5 or the reload button.

Mouse Operations

Left button dragScroll the display up and down.
Left double clickScroll clicked line to center line.
Right button dragSelect one or more lines for copying.  Release the mouse button to open a copy dialog, in which a single-line selection can be made to open a file or copy text to the highlight window.

To optimize the speed of TRCVIEW, and to provide faster highlighting, the display window does not allow normal selection and copying.  Instead, right-click and drag over a set of lines you want to extract or copy from, to quickly pop up a window which does allow selection.  In this window you can highlight and right-click a path name to open common file types shown in the trace, and to copy the selected text into the FFTRACE highlight strings.  If you click OK to close the pop-up window, any selected text is placed on the clipboard.

When sending traces to Copia support, please do not send extracted snippets: sending the whole trace file will usually help to resolve the issue more quickly.