BEA Tuxedo API: ATMI

In addition to the COBOL code that expresses the logic of your application, you must use the Application-to-Transaction Monitor Interface (ATMI), the interface between your application and the BEA Tuxedo system.

The ATMI is a reasonably compact set of calls used to open and close resources, begin and end transactions, and support communication between clients and servers. The following table summarizes the ATMI calls. Each call is described in the BEA Tuxedo ATMI COBOL Function Reference.

Using the ATMI Calls

For a Task Related to . . .	Use This COBOL Function . . .	To . . .	For More Information, Refer to . . .
Client membership	TPINITIALIZE	Have a client join an application	Writing Clients
	TPTERM	Have a client leave an application
Multiple application context management	TPGETCTXT(3cbl)	Retrieve an identifier for the current threads context	Programming a Multithreaded and Multicontexted ATMI Application
	TPSETCTXT(3cbl)	Set the current thread's context in a multicontexted process
Service entry and return	TPSVCSTART	Get service information	Writing Servers
	TPSVRINIT	Initialize a server
	TPSVRDONE	Terminate a server
	TPRETURN	End a service routine
	TPFORWAR	Forward a request
Dynamic advertisement	TPADVERTISE	Advertise a service name	Writing Servers
	TPUNADVERTISE	Unadvertise a service name
Message priority	TPGPRIO	Get the priority of the last request	Writing Servers
	TPSPRIO	Set the priority of the next request
Request/Response communications	TPCALL	Initiate a synchronous request/response to a service	Writing Servers Writing Request/Response Clients and Servers
	TPACALL	Initiate an asynchronous request (fanout)
	TPGETRPLY	Receive an asynchronous response
	TPCANCEL	Cancel an asynchronous request
Conversational communications	TPCONNECT	Begin a conversation with a service	Writing Conversational Clients and Servers
	TPDISCON	Abnormally terminate a conversation
	TPSEND	Send a message in a conversation
	TPRECV	Receive a message in a conversation
Reliable queuing	TPENQUEUE(3cbl)	Enqueue a message to a message queue	Using the ATMI /Q Component
	TPDEQUEUE(3cbl)	Dequeue a message from a message queue
Event-based communications	TPNOTIFY	Send an unsolicited message to a client	Writing Event-based Clients and Servers
	TPBROADCAST	Send messages to several clients
	TPSETUNSOL	Set unsolicited message call-back
	TPCHKUNSOL	Check the arrival of unsolicited messages
	TPGETUNSOL	Get an unsolicited message
	TPPOST	Post an event message
	TPSUBSCRIBE	Subscribe to event messages
	TPUNSUBSCRIBE	Unsubscribe to event messages
Transaction management	TPBEGIN	Begin a transaction	Writing Global Transactions
	TPCOMMIT	Commit the current transaction
	TPABORT	Roll back the current transaction
	TPGETLEV	Check whether in transaction mode
Resource management	TPOPEN(3cbl)	Open a resource manager	Programming a Multithreaded and Multicontexted ATMI Application Setting Up a BEA Tuxedo Application
	TPCLOSE(3cbl)	Close a resource manager
Security	TPKEYOPEN(3cbl)	Open a key handle for digital signature generation, message encryption, or message decryption	Using Security in CORBA Applications
	TPKEYGETINFO(3cbl)	Get information associated with a key handle
	TPKEYSETINFO(3cbl)	Set optional attributes associated with a key handle
	TPKEYCLOSE(3cbl)	Close a key handle previously opened using TPKEYOPEN