Handle Event Flags

Use the Device Communications Toolkit functions to manipulate event flags.

A CIMPLICITY software event flag is a bit within a predefined data structure. Applications can reserve some event flags to indicate some condition has occurred. Routines are provided to SET and CLEAR the event flag.

The enabler calls predefined (user-defined) functions when an event flag is SET. Ten (10) event flags are available to the enabler.

The following functions manipulate these flags:

  • dcrp_call_on_time
  • dcrp_clear_ef
  • dcrp_get_any_ef
  • dcrp_get_ef
  • dcrp_release_ef
  • dcrp_set_ef
Note: Some operating systems provide primitives for defining and manipulating event flags. It is recommended that the CIMPLICITY software-provided routines be used instead to avoid conflict with CIMPLICITY software routines within the enabler.

The Device Communications Toolkit reserves 10 event flags for use with user-customized subroutines and provides functions for reserving and manipulating the event flags.

Event flags should be cleared within the user-defined function for processing the event flag.