![[Contents]](FIGURE/CONTENT.GIF)
OpenTP1 Version 7 Programming Reference COBOL Language
![[Index]](FIGURE/INDEX.GIF)
![[Back]](FIGURE/FRONT.GIF)
![[Next]](FIGURE/AFTER.GIF)
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
| API | Name and role of X/Open-compatible function | |
|---|---|---|
| XATMI interface | TPACALL | Send a service request. |
| TPADVERTISE | Advertise a service name. | |
| TPCALL | Send a service request and synchronously await its reply. | |
| TPCANCEL | Cancel a communication handle for an outstanding reply. | |
| TPCONNECT | Establish a conversational service connection. | |
| TPDISCON | Terminate a conversational service connection abortively. | |
| TPGETRPLY | Get a reply from a previous service request. | |
| TPRECV | Receive a message in a conversational connection. | |
| TPRETURN | Return from a service routine. | |
| TPSEND | Send a message in a conversational connection. | |
| TPSVCSTART | Start a service routine. | |
| TPUNADVERTISE | Unadvertise a service name. | |
| TX interface | TXBEGIN | Begin a global transaction. |
| TXCLOSE | Close a set of resource managers. | |
| TXCOMMIT | Commit a global transaction. | |
| TXINFORM | Return global transaction information. | |
| TXOPEN | Open a set of resource managers. | |
| TXROLLBACK | Roll back a global transaction. | |
| TXSETCOMMITRET | Set commit_return characteristic. | |
| TXSETTIMEOUT | Set transaction_timeout characteristic. | |
| TXSETTRANCTL | Set transaction_control characteristic. | |
Table 4-2 Relationship between X/Open-compatible API functions and OpenTP1 UAPs
| X/Open-compatible API | SUP | SPP | MHP | UAP that handles offlinework |
||||
|---|---|---|---|---|---|---|---|---|
| Outside transaction range | Inside transaction range (root) | Outside transaction range | Transaction range | Outside transaction range | Inside transaction range (root) | |||
| Root | Nonroot | |||||||
| TPACALL | Y | Y | Y | Y | Y | -- | -- | -- |
| TPADVERTISE | -- | -- | Y#1 | Y#1 | Y#1 | -- | -- | -- |
| TPCALL | Y | Y | Y | Y | Y | -- | -- | -- |
| TPCANCEL | Y | Y | Y | Y | Y | -- | -- | -- |
| TPCONNECT | Y | Y | Y | Y | Y | -- | -- | -- |
| TPDISCON | Y | Y | Y | Y | Y | -- | -- | -- |
| TPGETRPLY | Y | Y | Y | Y | Y | -- | -- | -- |
| TPRECV | Y | Y | Y | Y | Y | -- | -- | -- |
| TPRETURN | -- | -- | Y#2 | Y#2 | Y#2 | -- | -- | -- |
| TPSEND | Y | Y | Y | Y | Y | -- | -- | -- |
| TPSVCSTART#3 | -- | -- | -- | -- | -- | -- | -- | -- |
| TPUNADVERTISE | -- | -- | Y#1 | Y#1 | Y#1 | -- | -- | -- |
| TXBEGIN#4 | Y | -- | Y | -- | -- | Y | -- | -- |
| TXCLOSE | Y | -- | Y | -- | -- | -- | -- | -- |
| TXCOMMIT with TX_CHAINED specified#4 | -- | Y | Y | -- | -- | -- | -- | -- |
| TXCOMMIT with TX_UNCHAINED specified#4 | -- | Y | Y | -- | -- | -- | -- | -- |
| TXINFORM | Y | Y | Y | Y | Y | -- | -- | -- |
| TXOPEN | Y | -- | Y | -- | -- | -- | -- | -- |
| TXROLLBACK with TX_CHAINED specified#4 | -- | Y | -- | Y | -- | -- | -- | -- |
| TXROLLBACK with TX_UNCHAINED specified#4 | -- | Y | -- | Y | -- | -- | -- | -- |
| TXSETCOMMIITRET#4 | Y | Y | Y | Y | Y | -- | -- | -- |
| TXSETTIMEOUT#4 | Y | Y | Y | Y | Y | -- | -- | -- |
| TXSETTRANCTL#4 | Y | Y | Y | Y | Y | -- | -- | -- |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.