forceNotify

forceNotify( $object, $event, $notified, $expires)

Notifies, or clears, the specified event.

The $notified and $expires parameters are both timers:

• If $notified is greater than or equal to $expires, then the event is cleared.

• If $notified is less-than $expires then the event is notified, or raised. The actual values of these parameters are not significant.

    # to notify an event:
    $session->forceNotify("Router::gw1",
       "Unresponsive", 0, 1);
    # to clear an event:
    $session->forceNotify("Router::gw1",
       "Unresponsive", 0, 0);