Defining the Unsolicited Message Handler


	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Doc Home \| Programming \| Topic List \| Previous \| Next \| Contents

Programming a BEA Tuxedo Application Using C

To define the unsolicited message handler function, use the tpsetunsol(3c) function with the following signature.

int
tpsetunsol(*myfunc)

The following table describes the single argument that can be passed to the tpsetunsol() function.

tpsetunsol( ) Function Argument

Argument
Description

myfunc

Pointer to a function that conforms to the prototype of a call-back function. In order to conform, the function must accept the following three parameters:

data - points to the typed buffer that contains the unsolicited message
len - length of the buffer
flags - currently not used

Argument	Description
myfunc	Pointer to a function that conforms to the prototype of a call-back function. In order to conform, the function must accept the following three parameters: data - points to the typed buffer that contains the unsolicited message len - length of the buffer flags - currently not used

When a client receives an unsolicited notification, the system dispatches the call-back function with the message. To minimize task disruption, you should code the unsolicited message handler function to perform only minimal processing tasks, so it can return quickly to the waiting process.