OpenTP1 Version 7 Programming Reference C Language
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 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.