Collecting and Logging Data

RtssLogger.rtss is an RTSS application that captures selected event data and saves the data in a binary log file. RtssLogger.rtss must be used in conjunction with rtssrun.

Usage

rtsslogger [/?] [/n N] [/p P] [/g g1,g2,g3,...] 
           [/t a] [/r A] [/s S] [/o O] [/c C] [/f fileName]
           [/w fileName]

Parameters

/n N

The number of events to capture (default 10,000). Unlike with the GUI, this number is not limited to 5,000,000. 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.

/p P

Percent of events prior to a trigger (0-100, default is 50%). This parameter is not used for Immediate triggers or for Any User Event trigger.

/g g1, g2...

Specifies which groups to capture (default is all groups). Groups are specified as /g g1,g2, etc. There are no spaces between the group numbers. See the RTX Time View Events for a listing of group numbers as well as group names, their contents, and filters they are associated with.

/t TriggerEvent

The integer representing a trigger event using the RTX Time View ID convention (default is immediate). Trigger event numbers are defined in RTX Time View Events.

/r Forever

Traces are logged forever (0 for FALSE, 1 for TRUE. Default is 0).

/s Frequency

Frequency of logging traces to file in milliseconds (default is 1000 ms).

/o Occurrence

The occurrence of the trigger event from which log tracing starts (default is 1).

/f filename

Forces the specified RTX Time View log file to always be created. The filename must contain the absolute path and the extension rtv. Double quotations must be used if there is white space. (default is C:\RtxTrace.rtv)

/w <filename>

Warns that the RTX Time View log filename already exists. The filename must contain the absolute path and the extension rtv. Double quotations must be used if there is white space. (default is C:\RtxTrace.rtv)

Exit tracing.

Help on usage.

Comments

The RTX Time View tool uses rtsslogger command line functionality to capture events based on selected groups (or types of events) requested. If rtsslogger is used on a multiprocessor system, and the group Internal Service Request Interrupt (SRI) Activity (group 16) is selected, then the time values captured for RTSS events will be valid, but those captured for Win32 processes will be invalid.

Example

rtssrun rtsslogger /n 1000 /t 2048 /o 1 /p 30 /g g1,g2,g4,g22 /f "D:\temp.rtv"