Starts a trace using the current configuration settings. This call can work only if the INscope RT Server Component has been loaded on this RT node.

int start_RT_trace(
        UINT_8 init_trace               // Reset flag
);

Parameters

init_trace

Specifies whether to zero out the trace buffer and reset the trace header t_head and t_count values before enabling system tracing or to add new trace information to the existing buffer contents. Valid values include:

1	Init the trace buffer.
0 (zero)	Leave the trace buffer as is.

Return Values

0 (zero); tracing is disabled.
1; tracing is already enabled.

Success.

-1; the INscope RT Server Component is not loaded.
-2; the buffer has been locked.

Failure.

Requirements

See Also

INscope functions