Saves the contents of the trace buffer to the specified file. This call can work only if the INscope RT Server Component has been loaded on this RT node and the trace is not currently running.

int save_RT_trace(
    char * filename // Full path and file name where the log is to be stored
);

Parameters

filename

Specifies the full path where the contents of the trace buffer are written

Return Values

0 (zero)

Success.

-1

Failure, Either the trace was running, or the file could not be opened

0xffff

rtscope.rta has not been loaded

Requirements