DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_tracelevel_set()

The mi_tracelevel_set() function sets the tracing level for specified trace classes.

Syntax

mi_integer mi_tracelevel_set(setcommands)

		const mi_string *setcommands; 


setcommands
is a list of pairs, separated by spaces, each pair including a trace class name followed by an integer trace level.







 



Valid in Client Application?

Valid in Server Routine?

No
Yes

Usage

A trace class name must be inserted into the systraceclasses system catalog table before mi_tracelevel_set() can run. By default, tracing is off; that is, the current trace level is set to zero for all trace classes.

A trace level can be any integer from 0 to the maximum long integer value for the development platform.

Return Values

MI_OK
The function was successful.

MI_ERROR
The function was not successful.

Example

The following example sets the current level of class funcEntry to 50 and the level for class outData to 35:

mi_integer status;
status = mi_tracelevel_set("funcEntry 50 outData 35");

The following typical trace statement would then execute, and its output would be written to the current trace file, because the value (10) in the argument to DPRINT is not greater than the current level (50) of funcEntry.

DPRINTF("funcEntry", 10,
		("Entering compute_output with inStr = %s", inStr));

DataBlade API Programmer's ManualChapter 12: DataBlade API Function Descriptions Home Contents Index Master Index New Book

mi_tracelevel_set()

Syntax

Usage

Return Values MI_OK The function was successful. MI_ERROR The function was not successful.

Example

Related Topics

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

Return Values

MI_OK
The function was successful.

MI_ERROR
The function was not successful.