Understanding Conversational Communication Events

The following table lists the events, the routines for which they are returned, and a detailed description of each.

Conversational Communication Events

Event	Received By	Description
TPEV_SENDONLY	TPRECV	Control of the connection has been passed; this process can now call TPSEND.
TPEV_DISCONIMM	TPSEND, TPRECV, TPRETURN	The connection has been torn down and no further communication is possible. The TPDISCON routine posts this event in the originator of the connection, and sends it to all open connections when TPRETURN is called, as long as connections to subordinate services remain open. Connections are closed in a disorderly fashion. If a transaction exists, it is aborted.
TPEV_SVCERR	TPSEND	Received by the originator of the connection, usually indicating that the subordinate program issued a TPRETURN without having control of the connection.
	TPRECV	Received by the originator of the connection, indicating that the subordinate program issued a TPRETURN with TPSUCCESS or TPFAIL and a valid data record, but an error occurred that prevented the call from completing.
TPEV_SVCFAIL	TPSEND	Received by the originator of the connection, indicating that the subordinate program issued a TPRETURN without having control of the connection, and TPRETURN was called with TPFAIL or TPEXIT and no data.
	TPRECV	Received by the originator of the connection, indicating that the subordinate service finished unsuccessfully (TPRETURN was called with TPFAIL or TPEXIT).
TPEV_SVCSUCC	TPRECV	Received by the originator of the connection, indicating that the subordinate service finished successfully; that is, it called TPRETURN with TPSUCCESS.