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.