Table 4-1 shows the correspondence between the X/Open-compliant functions (XATMI-interfaced or TX-interfaced) and their facilities, and Table 4-2 shows the relationship between these functions and OpenTP1 UAPs.

Table 4-1 Relationship between X/Open-compliant functions and facilities

Category	X/Open-compliant function - name and facility
XATMI interface	tpacall()	Send a service request.
	tpadvertise()	Advertise a service name.
	tpalloc()	Allocate a typed buffer.
	tpcall()	Send a service request and synchronously awaits its reply.
	tpcancel()	Cancel a call descriptor for an outstanding reply.
	tpconnect()	Establish a conversational service connection.
	tpdiscon()	Terminate a conversational service connection abortively.
	tpfree()	Free a typed buffer.
	tpgetrply()	Get a reply from a previous service request.
	tprealloc()	Change the size of a typed buffer.
	tprecv()	Receive a message in a conversational connection.
	tpreturn()	Return from a service routine.
	tpsend()	Send a message in a conversational connection.
	tpservice()	Template for service routines.
	tptypes()	Determine information about a typed buffer.
	tpunadvertise()	Unadvertise a service name.
TX interface	tx_begin()	Begin a global transaction.
	tx_close()	Close a set of resource managers.
	tx_commit()	Commit a global transaction.
	tx_info()	Return global transaction information.
	tx_open()	Open a set of resource managers.
	tx_rollback()	Roll back a global transaction.
	tx_set_commit_return()	Set commit_return characteristic.
	tx_set_transaction_control()	Set transaction_control characteristic.
	tx_set_transaction_timeout()	Set transaction_timeout characteristic.

Table 4-2 Relationship between X/Open-compliant functions and OpenTP1 UAPs

X/Open-compliant function	SUP		SPP			MHP		Off- line
	Out	In	Out	Transaction range		Out	In
				Rt	N-Rt
tpacall	Y	Y	Y	Y	Y	N	N	N
tpadvertise	N	N	Y#1	Y#1	Y#1	N	N	N
tpalloc	Y	Y	Y	Y	Y	N	N	N
tpcall	Y	Y	Y	Y	Y	N	N	N
tpcancel	Y	Y	Y	Y	Y	N	N	N
tpconnect	Y	Y	Y	Y	Y	N	N	N
tpdiscon	Y	Y	Y	Y	Y	N	N	N
tpgetrply	Y	Y	Y	Y	Y	N	N	N
tpfree	Y	Y	Y	Y	Y	N	N	N
tprecv	Y	Y	Y	Y	Y	N	N	N
tprealloc	Y	Y	Y	Y	Y	N	N	N
tpreturn	N	N	Y#2	Y#2	Y#2	N	N	N
tpsend	Y	Y	Y	Y	Y	N	N	N
tpservice#3	N#3	N#3	N#3	N#3	N#3	N	N	N
tptypes	Y	Y	Y	Y	Y	N	N	N
tpunadvertise	N	N	Y#1	Y#1	Y#1	N	N	N
tx_begin#4	Y	N	Y	N	N	Y	N	N
tx_close	Y	N	Y	N	N	N	N	N
tx_commit with TX_CHAINED specified#4	N	Y	Y	N	N	N	N	N
tx_commit with TX_UNCHAINED specified4	N	Y	Y	N	N	N	N	N
tx_info	Y	Y	Y	Y	Y	N	N	N
tx_open	Y	N	Y	N	N	N	N	N
tx_rollback with TX_CHAINED specified#4	N	Y	N	Y	N	N	N	N
tx_rollback with TX_UNCHAINED specified#4	N	Y	N	Y	N	N	N	N
tx_set_commit_return#4	Y	Y	Y	Y	Y	N	N	N
tx_set_transaction_control#4	Y	Y	Y	Y	Y	N	N	N
tx_set_transaction_timeout#4	Y	Y	Y	Y	Y	N	N	N

Legend:

Out: Outside transaction range

In: Inside transaction range (root)

Rt: Root

N-Rt: Non-root

Off-line: UAP that handles offline work

Y:The function can be used with UAPs.

N:The function cannot be used with UAPs.

The Outside transaction range for MHP means the range of MHPs with the nontransaction attribute or the main function of MHPs.

#1: Functions marked ^#1 can be called only within service functions.

#2: Functions marked ^#2 are used only to make XATMI-interfaced service functions return.

#3: tpservice is the entity of the service function.

#4: For the UAP which issues a function marked ^#4, specify atomic_update=Y in the user service definition.