X/Open-compliant function

Table 4-1 gives the relationship between X/Open-compatible APIs (XATMI and TX interfaces) and functions. Table 4-2 gives the relationship between X/Open-compatible API functions and OpenTP1 UAPs.

Table 4-1 Relationship between X/Open-compatible APIs and functions

APIName and role of X/Open-compatible function
XATMI interfaceTPACALLSend a service request.
TPADVERTISEAdvertise a service name.
TPCALLSend a service request and synchronously await its reply.
TPCANCELCancel a communication handle for an outstanding reply.
TPCONNECTEstablish a conversational service connection.
TPDISCONTerminate a conversational service connection abortively.
TPGETRPLYGet a reply from a previous service request.
TPRECVReceive a message in a conversational connection.
TPRETURNReturn from a service routine.
TPSENDSend a message in a conversational connection.
TPSVCSTARTStart a service routine.
TPUNADVERTISEUnadvertise a service name.
TX interfaceTXBEGINBegin a global transaction.
TXCLOSEClose a set of resource managers.
TXCOMMITCommit a global transaction.
TXINFORMReturn global transaction information.
TXOPENOpen a set of resource managers.
TXROLLBACKRoll back a global transaction.
TXSETCOMMITRETSet commit_return characteristic.
TXSETTIMEOUTSet transaction_timeout characteristic.
TXSETTRANCTLSet transaction_control characteristic.

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

X/Open-compatible APISUPSPPMHPUAP
that handles offlinework
Outside transaction rangeInside transaction range (root)Outside transaction rangeTransaction rangeOutside transaction rangeInside transaction range (root)
RootNonroot
TPACALLYYYYY------
TPADVERTISE----Y#1Y#1Y#1------
TPCALLYYYYY------
TPCANCELYYYYY------
TPCONNECTYYYYY------
TPDISCONYYYYY------
TPGETRPLYYYYYY------
TPRECVYYYYY------
TPRETURN----Y#2Y#2Y#2------
TPSENDYYYYY------
TPSVCSTART#3----------------
TPUNADVERTISE----Y#1Y#1Y#1------
TXBEGIN#4Y--Y----Y----
TXCLOSEY--Y----------
TXCOMMIT with TX_CHAINED specified#4--YY----------
TXCOMMIT with TX_UNCHAINED specified#4--YY----------
TXINFORMYYYYY------
TXOPENY--Y----------
TXROLLBACK with TX_CHAINED specified#4--Y--Y--------
TXROLLBACK with TX_UNCHAINED specified#4--Y--Y--------
TXSETCOMMIITRET#4YYYYY------
TXSETTIMEOUT#4YYYYY------
TXSETTRANCTL#4YYYYY------
Legend:
Y: The function can be called from the UAP.
--: The function cannot be called from the UAP.
Note:
Outside transaction range for MHP means the range of MHPs with the nontransaction attribute or the MHP main program.
#1: Functions marked#3 can be invoked only from within service programs.
#2: Functions marked#4 are used only to make XATMI-interfaced service programs return.
#3: TPSVCSTART is an API function that service programs always invoke.
#4: For the UAP which issues a function marked#2, specify atomic_update=Y in the user service definition.