HP NonStop G-Series - Manual (Page 128)

+----bea.jolt.JoltUserEvent
The JoltUserEvent class extends JoltEvent. JoltUserEvent implements a subscription to an asynchronous (async)
notification event. An async notification is either an unsolicited event notification or event notification from the
TUXEDO Event Broker. Unsolicited notifications are produced in response to a TUXEDO tpnotify() call or a TUXEDO
tpbroadcast() call. Event notifications are produced as a result of a TUXEDO tppost() call.
The JoltUserEvent class is used in Jolt 1.1 to support notification. This class provides support for both unsolicited
notification (produced as a result of tpnotify() or tpbroadcast()) and event notifications (produced as a result of tppost()).
The String JoltUserEvent.UNSOLMSG in the class is a constant which the application programmer uses to request
unsolicited messages.
Note
In TUXEDO, an unsolicited notification is indistinguishable from event notification. This is
also reflected in Jolt.
The handler for unsolicited notification and event notification is done in the Session object. A thread is used in this class
to monitor any incoming messages.
For additional information, refer also to the JoltSession, JoltMessage, and JoltReply classes.
public class JoltUserEvent
UNSOLMSG
JoltUserEvent(String, String, Session)
UNSOLMSG
The regular expression constant for unsolicited notification subscription.
final static String UNSOLMSG
JoltUserEvent Methods
The following methods are used with the JoltUserEvent class.
JoltUserEvent
Subscribes to the specific asynchronous notification.
JoltUserEvent(String expr, String filter, Session session)
throws EventException, SessionException
expr
JoltUserEvent.UNSOLMSG for unsolicited notification or a regular expression for event notification. The
parameter expr is a string containing a regular expression of the same format as the event expression used in
tpsubscribe(). The maximum length of this parameter is 255 characters. Setting this parameter to the constant
JoltUserEvent.UNSOLMSG will allow the client to receive unsolicited messages (generated as a result of tpnotify()
or tpbroadcast()).
filter
Null or Boolean expression. The parameter filter is a string of the same format as the filter parameter passed to
tpsubscribe(). The maximum length of this parameter is 255 characters. Filter rules are specific to the buffers to
which they are applied. Refer to TUXEDO documentation for complete explanation of the filtering function.
Filtering is done on the TUXEDO server, not the Jolt client.
session
A JoltSession object. The parameter session is the JoltSession to which the subscription is bound. An event is