PulseEvent Function

Action

Provides a single operation that sets (to signaled) the state of a specified event object and then resets it (to nonsignaled) after releasing the appropriate number of waiting threads.

Include file

Kernel.bdh

Syntax

PulseEvent( in hEvent : number ): boolean;

Return value

  • true if successful
  • false otherwise
Parameter Description
hEvent Handle of event object

Example

var
  hEventGo : number; // handle for starting event

dcltrans
  transaction TInit
  begin
    hEventGo := CreateEvent("MyStarterEvent");
  end TInit; 

  transaction TStarter
  begin
    wait 10.0;
    // every 10 seconds the starter event forces all users
    // to execute a transaction at the same time
    PulseEvent(hEventGo);
  end TStarter;

Sample scripts

Trans.bdf