TIBCO FTL®
|
Cooperating application programs can use locks to implement exclusive access to a map within a persistence store. More...
Macros | |
#define | TIBLOCK_PROPERTY_DOUBLE_LOCK_ACQUIRE_RETRY_DURATION "com.tibco.ftl.lock.acquire.retry.duration" |
Retry duration for lock requests. double. More... | |
Typedefs | |
typedef struct __tibLockId * | tibLock |
Functions | |
TIB_API void | tibLock_Destroy (tibEx e, tibLock lock) |
Destroy a local lock object and reclaim its resources. More... | |
TIB_API tibbool_t | tibLock_Request (tibEx e, tibLock lock) |
No operation. More... | |
TIB_API void | tibLock_Return (tibEx e, tibLock lock) |
Release a lock. More... | |
TIB_API void | tibLock_Steal (tibEx e, tibLock lock) |
Forcibly acquire a lock, even if another process holds it. More... | |
Cooperating application programs can use locks to implement exclusive access to a map within a persistence store.
To create a lock object, see tibRealm_CreateLock.
If a client process exits or disconnects from the persistence server, the library automatically releases all the locks that the process holds.
This file defines the calls that manipulate locks. In addition, map objects and map iterator objects have methods that operate while holding a lock.
#define TIBLOCK_PROPERTY_DOUBLE_LOCK_ACQUIRE_RETRY_DURATION "com.tibco.ftl.lock.acquire.retry.duration" |
Retry duration for lock requests. double.
typedef struct __tibLockId* tibLock |
Destroy a local lock object and reclaim its resources.
If the process holds the lock, this call returns the lock before destroying the object.
e | The exception object captures information about failures. |
lock | The call destroys the local lock object. |
No operation.
In releases earlier than 5.0, this call requested a lock from its persistence store.
In Release 5.0 and later, this call is no longer necessary; it returns tibTrue
without any other effect.
Calls that require a lock automatically request it; see:
Programs that correctly used earlier versions of lock calls continue to operate properly.
e | Unused. |
lock | Unused. |
tibTrue
. Release a lock.
If the process does not hold the lock, this call has no effect.
e | The exception object captures information about failures. |
lock | The call releases the lock represented by this lock object. |
Forcibly acquire a lock, even if another process holds it.
The library delays the effect of this call (stealing the lock) until the next time the process calls a map method that requires the lock.
e | The exception object captures information about failures. |
lock | The call steals the lock represented by this lock object. |