Causing an Event

The jomCauseEvent call, shown in the following example, requests the JADE Object Manager server to cause a USER notification event on all matching USER notification requests.

int jomCauseEvent(const DskHandle   *pHandle,
                  const DskObjectId *pTarget,
                  UInt32            eventType,
                  UInt16            immediate,
                  DskParam          *pInfo,
                  DskObjectId       *pCausedBy
                  UInt32            lineNo)

This call can be made from an execution thread that does not correspond to a process of the current node. For threads that do not correspond to a process of the current node, the request is executed by the background process thread.

Events are processed at the time of execution, and the notifications are sent immediately or at the end of transaction time to those users who have a matching subscriber.

The parameters for this call are described in the following subsections.