Progress
Startup Command and Parameter
Reference


Filtering Asynchronous COM Events (-filterocxevents)

Operating 
System
and
Syntax 
UNIX
Windows 
-filterocxevents 
Use
With 
Maximum
Value 
Minimum
Value 
Single-user
Default 
Multi-user
Default 
CS

The –filterocxevents startup parameter, lets you control the conditions under which you want asynchronous COM events handled. An asynchronous COM event is one that is sent by an ActiveX control or Automation object because of an external event, rather than in response to user input. One example of this is the Tick event from the PSTimer. Another is an event signalling the receipt of a message from an external source, such as a control that implements a mail notification system.

By default, asynchronous COM events are handled when any of the following conditions occur:

  1. While an application is waiting for user input, such as during a WAIT–FOR or UPDATE statement.
  2. While an alert box from a MESSAGE statement is on the screen.
  3. During trigger processing, if the MultitaskingInterval parameter is set to a number greater than 0.

Handling COM events during the second and third conditions might cause random problems in your application, depending on what 4GL code is executed in the event trigger. You use the –filterocxevents startup parameter to prevent asynchronous COM events from being handled during the second and third conditions.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095