Description
Sets the timeout value for subsequent EAServer transactions. The transaction is rolled back if it does not complete before the timeout expires.
Obsolete function
SetTimeout is obsolete, because EAServer is no longer supported since PowerBuilder 2017.
Applies to
CORBACurrent objects
Syntax
CORBACurrent.SetTimeout ( seconds )
Argument |
Description |
---|---|
CORBACurrent |
Reference to the CORBACurrent service instance |
seconds |
An unsignedlong that specifies the number of seconds that elapse before a transaction is rolled back |
Return value
Boolean.
Returns true if it succeeds and false if an error occurs.
Usage
The SetTimeout function specifies the number of seconds that can elapse before a transaction is rolled back. The timeout period applies to transactions created by subsequent invocations of BeginTransaction. If seconds is 0, no timeout period is in effect.
SetTimeout can be called by a client or a component that is marked as OTS style. EAServer must be using the two-phase commit transaction coordinator (OTS/XA).
Examples
This example shows how to set the timeout period to five minutes:
// Instance variables: // CORBACurrent corbcurr boolean lb_timeout integer li_rc li_rc = this.GetContextService("CORBACurrent", & corbcurr) IF li_rc <> 1 THEN // handle the error END IF li_rc = corbcurr.Init( "iiop://server1:9003") IF li_rc <> 1 THEN // handle the error ELSE lb_timeout = corbcurr.SetTimeout(300) li_rc = corbcurr.BeginTransaction() END IF
See also