tibasSpace_LockAllEx()

Batch version of the lock operation. Requires a list of key value tuples to take and returns a list of results.

Declaration

tibas_status tibasSpace_LockAllEx(
    tibasSpace            space,
    tibasSpaceResultList* resultList,
    tibasTupleList        keyList,
    tibasLockOptions      options)

Parameters

Parameter Description
space The TIBCO ActiveSpaces entity on which the function is invoked.
resultList The list of tuples after it is taken from the space and returned.
keyList The list of tuples to lock.
options Provide a tibasLockpOtions structure that specifies the options for the lock.

Remarks

Use the tibasSpace_LockAllEx() function to lock a tuples whose key values are specified in a specified keyList. You can also specify lock wait and forget options for the lock operation. You can also specify a filter for the lock operation.

You can use the options parameter to provide a tibasLockpOtions structure that specifies the options for the lock. The tibasLockOptions structure is defined as follows: 

struct _tibasLockOptions {
    tibas_long lockWait;
    tibas_boolean forget;
    const char* filter;
};

The lock options are defined as follows:

lockWait
Specifies a lock wait time, in milliseconds.
forget
Specify this option if you want the system to forget the return. This is useful if you do not need the tuple.
filter
Specify a filter string so that the operations are performed only on the data set that matches with the specified filter.

See Also

tibasSpace_Lock(), tibasSpace_LockEx(), tibasSpace_LockAllEx(), tibasSpace_Unlock(), tibasSpace_UnlockAll()