Perform

Evaluate c-tree Server performance.

Short Name

PERFORM()

Type

Low-level function

Declaration

COUNT Perform(COUNT status)

Description

Perform() collects statistics on the number of times each c-tree Plus function is called between PERFORM_ON and PERFORM_OFF. status is used to begin and end the evaluation process and to display the information collected. The values that can be used for status are:

Symbolic Constant	Explanation
PERFORM_ON	Begin collecting performance statistics.
PERFORM_OFF	End the performance session and calculate the elapse time.
PERFORM_DUMP	Print the performance statistics to the standard error device.

Return

Always returns zero (NO_ERROR).

Example

Perform(PERFORM_ON);


GetRecord(…);

ReWriteRecord(…);

NextRecord(…);


/* additional c-tree Plus functions */


Perform(PERFORM_OFF);


Perform(PERFORM_DUMP);