8.5.2 Notification via Service Call or Reliable Queue

Event notification via service call enables you to program actions that can be taken in response to specific conditions in your application without human intervention. Event notification via reliable queue ensures that event data is not lost. It also provides the subscriber the flexibility of retrieving the event data at any time.

If the subscriber (either a client or a server process) wants event notifications sent to service routines or to stable-storage queues, then the ctl parameter of tpsubscribe() must point to a valid TPEVCTL structure.

The TPEVCTL structure contains the following elements:

long flags;
char name1[127];
char name2[127];
TPQCTL qctl;

The following table summarizes the TPEVCTL typed buffer data structure.

Table 8-5 TPEVCTL Typed Buffer Format

Field	Description
flags	Flag options. For more information on flags, refer to tpsubscribe(3c) in the Oracle Tuxedo ATMI C Function Reference.
name1	Character string of 127 characters or fewer.
name2	Character string of 127 characters or fewer.
qct1	TPQCTL structure. For more information, refer to tpsubscribe(3c) in the Oracle Tuxedo ATMI C Function Reference.