net.rim.device.api.system
Interface GlobalEventListener

The listener interface for receiving global events.
Arbitrary applications may use global events for inter-process communication (IPC).
The BlackBerry OS can also generate global events, such as those defined by
the ServiceBook API. See the BlackBerry Application Developer Guide
Volume 2: Advanced Topics for more information on ServiceBook global events.

To receive a global event, an application must implement the
net.rim.device.api.system.GlobalEventListener interface and implement the
GlobalEventListener.eventOccurred method, which is invoked when a global event
occurs. In its implementation of eventOccurred(), the application specifies
which actions to perform when a global event is received.

Register the GlobalEventListener by invoking the
Application.addGlobalEventListener(GlobalEventListener) method.
Example:

When the time zone changes, the system sends out a global event message to the
applications. To catch it, implement the GlobalEventListener interface and
register the listener by calling Application.addGlobalEventListener().
Your eventOccurred() method should look similar to this:

eventOccurred

The eventOccurred method provides two object parameters and two integer
parameters for supplying details about the event itself. The developer
determines how the parameters will be used.

For example, if the event corresponded to sending or receiving a mail message, the
object0 parameter might specify the mail message itself, while the
data0 parameter might specify the identification details of
the message, such as an address value.