Setting Up Data Capture

The Data Capture Setup dialog box lets you specify the number of events to capture, select the percentage of events to capture prior to a trigger, and select a pre-defined filter to filter out unwanted data.

To set up data capture options:

From the Trigger Setup dialog box, click Next to display the Data Capture dialog.
In the Number of Events box, type in the number of events that you want RTX Time View to store in RTV log file. The maximum number allowed is 5,000,000.

NOTE: Selecting more than one million events takes significant disk space and time to process when you attempt to view the log.

NOTE: Unlike the GUI, the command-line version of RTX Time View is not limited to 5,000,000 events. When you use command-line functions, there is no limit on the maximum number of events except those system limits imposed by your disk space. However, be aware that large data collection uses significant disk space. Conversion and data display can be time consuming. If you exceed the maximum number of events, an error message is displayed.

Indicate when you want RTX Time View to stop logging events:

Stop when number of events reached: RTX Time View stops capturing events after it reaches the number of events specified in the Number of Events box.
Run until stopped: RTX Time View does not stop capturing events until you click the Stop button (which becomes available after you click Start). If RTX Time View reaches the Number of events value before it is stopped, it begins deleting the oldest events to allow it to capture new events without exceeding the Number of events value.

The frequency that data will be written to the log file is determined by the number of milliseconds entered. To avoid buffer data overflow, default times are set so that

Systems with...	Will have data written to the log file
1-7 processors	Every 1000ms
8-15 processors	Every 500 ms
> 16 processors	Every 250 ms

If the time between data log writes is set to be longer (larger value) than the default, it will be overwritten.

RTX Time View provides the user with the capability to look at events leading up to the trigger event. RTX Time View monitors events as soon as the logging program begins but only saves events to a log file when the specified trigger is detected. The number of events to save before the trigger is determined by the Percentage Slide Selector.

For example, if you have selected to log 10,000 events and log 50% of the events before the trigger, then the 5,000 events collected before the trigger event is detected will be saved to the log along with the 5,000 events collected after the trigger. If the trigger occurs before 5,000 events are collected, then RTX Time View continues to collect events until 10,000 total events have been collected.

NOTE: When the trigger is set to Immediate or Any User event, the percentage prior to the trigger is set to zero and cannot be changed.

RTX Time View provides a mechanism that lets you filter the information captured to a file. Only the events specified by the filter are written into the log file. You can use a filter with pre-selected events provided by RTX Time View or customize the filter. Select the desired filter type from the Capture Filters drop list menu or click Advanced to customize the events that are written into the log file. See Customizing Filters for detailed information on what is logged for each filter, as well as how to customize a filter for your specific needs.
Click Start to begin the RTX Time View data collection process, and then start the RTSS process you wish to examine. If you chose Stop when number of events reached, Timeview will collect the specified number of events and return you to the main RTX Time View window. If you chose Run until stopped, you must click the Stop button to terminate logging and return to the main window.