www.it-ebooks.info

Development of Tuxedo – Various APIs
• It performs the rollback process if the application designates that the
transaction is to be aborted
• It performs a recovery procedure when failures occur
Creating or initiating a transaction
There are mainly two ways to initiate a transaction in a Tuxedo system: initiated
explicitly by the application, or implicitly by an administrator.
• In your application code, you can use the tpbegin() function to initiate your
transaction. It creates the GTI and starts the transaction and communicates
it to the TM. This function has two parameters: a transaction time-out value
and a flag, which is currently undefined and must be set to 0. The application
module that called tpbegin() should also call a termination-of-transaction
function, tpcommit() to commit, or tpabort() to abort the transaction.
• The Tuxedo system provides a built-in administrative configuration option
called AUTOTRAN. The service that is marked with it in the UBBCONFIG file is part
of a global transaction of its caller. If it is not being called under a transaction,
the Tuxedo system initiates the transaction prior to invoking this service.
Tuxedo's transactional functions
The following is a list of Tuxedo's transactional functions along with their syntax:
• tpbegin – int tpbegin(unsigned long timeout, long flags)
• tpcommit – int tpcommit(long flags)
• tpabort – int tpabort(long flags)
• tpgetlev – int tpgetlev()
• tpsuspend – int tpsuspend(TPTRANID *t_id,long flags)
• tpresume – int tpresume(TPTRANID *t_id,long flags)
• tpopen – int tpopen(void)
• tpclose – int tpclose(void)
[ 92 ]
www.it-ebooks.info