Measure Function

Action

Specifies whether to perform measurements. This function turns the generation of results that are written to report files and the result repository on or off. Calling this function is only successful if neither a warm-up time nor a measurement time is specified in the workload settings.

Note: This function does not affect the creation of time series data files.

Include file

Kernel.bdh

Syntax

Measure( in nStatus: number ): boolean;

Return value

true if successful
false otherwise

Parameter	Description
nStatus	Specifies whether to enable or disable measurements. This parameter must contain one of the following flags: MEASURE_ON. Enables measurements MEASURE_OFF. Disables measurements

Parameter

Description

nStatus

Specifies whether to enable or disable measurements. This parameter must contain one of the following flags:

MEASURE_ON. Enables measurements
MEASURE_OFF. Disables measurements

Example

dclrand
  rWait: RndUniF(0.0 .. 1.0);

dcltrans
  transaction TInit
  begin
    Measure(MEASURE_OFF);
  end TInit;

  transaction TMain
  var
    nCount: number init 0;
  begin
    nCount := nCount + 1;
    if nCount = 10 then Measure(MEASURE_ON) end;
    if nCount = 20 then Measure(MEASURE_OFF) end;
  end TMain;