8.3.2 Broadcasting Messages by Identifier

The tpnotify(3c) function is used to broadcast a message using an identifier received with a previously processed message. It can be called only from a service.

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

int
tpnotify(CLIENTID *clientid, char *data, long len, long flags)

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

Table 8-4 tpnotify( ) Function Arguments

Argument	Description
clientid	Pointer to a CLIENTID structure that is saved from the TPSVCINFO structure that accompanied the request to this service.
data	Pointer to the content of the message.
len	Size of the message buffer. If data points to a self-defining buffer type, for example, FML, then len can be set to 0.
flags	Flag options. Refer to tpnotify(3c) in the Oracle Tuxedo ATMI C Function Reference for information on available flags.