NAME

CQCC::Timer - Support class to measure internal run times


CLASS DESCRIPTION

This class provides a means of measuring elapsed times for important internal operations to help identify areas for performance tuning.

It is used through three accessor functions. ``TimerStart(label)'' creates a new timer and returns it; ``TimerStop(timer)'' stops the timer; and ``TimerLog()'' will write out the timing information.

SUPPORT POLICY: See TriggerCQCC.pm for the Rational Support Policy.


METHODS

ClassInit()
This class function is automatically invoked to define class parameters using CQCC::Parm objects. Current parameters include:
CQCC_TIMER
This parameter enables internal timing data to be recorded for major operations. It can be set to 0 (off, the default) or 1 (on).

ClassTest(@args)
This class function creates several timer instances then writes them out to standard output.

new CQCC::Timer()
This method initializes the timer's attributes and starts it.

TimerLog()
This function prints the times from the timers if timers are enabled to standard output and/or the trigger output log file.

TimerStart(Label)
This method initializes a new timer, adds it to an internal list, then returns it. The caller is expected to call TimerStop(timer) later.

TimerStop(timer)
This function takes an existing timer and stops it by storing the stop time.