8.5 Subscribing to Events

The tpsubscribe(3c) function enables an Oracle Tuxedo system ATMI client or server to subscribe to an event.

A subscriber can be notified through an unsolicited notification message, a service call, a reliable queue, or other notification methods configured by the application administrator. (For information about configuring alternative notification methods, refer to Setting Up an Oracle Tuxedo Application.)

Use the following signature to call the tpsubscribe() function:

long handle
tpsubscribe (char *eventexpr, char *filter, TPEVCTL *ctl, long flags)

The following table describes the arguments to the tpsubscribe() function.

You can subscribe to both system- and application-defined events using the tpsubscribe() function.

For purposes of subscriptions (and for MIB updates), service routines executed in an Oracle Tuxedo system server process are considered to be trusted code.