X/Open-compliant function

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

CategoryX/Open-compliant function - name and facility
XATMI interfacetpacall()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 interfacetx_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 functionSUPSPPMHPOff- line
OutInOutTransaction rangeOutIn
RtN-Rt
tpacallYYYYYNNN
tpadvertiseNNY#1Y#1Y#1NNN
tpallocYYYYYNNN
tpcallYYYYYNNN
tpcancelYYYYYNNN
tpconnectYYYYYNNN
tpdisconYYYYYNNN
tpgetrplyYYYYYNNN
tpfreeYYYYYNNN
tprecvYYYYYNNN
tpreallocYYYYYNNN
tpreturnNNY#2Y#2Y#2NNN
tpsendYYYYYNNN
tpservice#3N#3N#3N#3N#3N#3NNN
tptypesYYYYYNNN
tpunadvertiseNNY#1Y#1Y#1NNN
tx_begin#4YNYNNYNN
tx_closeYNYNNNNN
tx_commit with TX_CHAINED specified#4NYYNNNNN
tx_commit with TX_UNCHAINED specified4NYYNNNNN
tx_infoYYYYYNNN
tx_openYNYNNNNN
tx_rollback with TX_CHAINED specified#4NYNYNNNN
tx_rollback with TX_UNCHAINED specified#4NYNYNNNN
tx_set_commit_return#4YYYYYNNN
tx_set_transaction_control#4YYYYYNNN
tx_set_transaction_timeout#4YYYYYNNN
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.