tibasSpace_PutAllEx()

The enhanced batch version of the put operation. Stores all of the tuples in the provided list and returns a list of results. Allows you to specify a lock wait value, lock or unlock value, a forget value, and a filter.

Declaration

tibas_status tibasSpace_PutAllEx(
    tibasSpace space,
    tibasSpaceResultList* resultList,
    tibasTupleList valueList,
    tibasPutOptions options)

Parameters

Parameter Description
space The TIBCO ActiveSpaces entity on which the function is invoked.
resultList The list of results for the operations included in the batch.
valueList A list of tuples to put in the space.
options Provide a tibasPutOptions structure that specifies the options for the put.

Remarks

Use the tibasSpace_PutAllEx() function to put the tuples in a provided list in a specified space and return a list of results. In addition, you can specify lock, wait, forget options, and a filter for the operation.

The put options are specified in a tibasPutOptions structure that specifies the options for the put. The tibasPutOptions structure is defined as follows: 

struct _tibasPutOptions {
    tibas_long    entryTTL;
    tibas_long    lockWait;
    tibas_boolean lock;
    tibas_boolean unlock;
    tibas_boolean forget;
    const char* filter;
};

The put options are defined as follows:

entryTTL
Allows you to define the entry TTL for the tuple that is being put.
lockWait
Specifies a lock wait time, in milliseconds.
lock
Put the data and lock the tuple.
unlock
Unlock the tuple. Only the thread or process that locked the tuple can unlock it.

Lock and unlock are mutually exclusive. If you use one of these, code NULL for the other.

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_Put(), tibasSpace_PutEx(),tibasSpace_PutAll(), tibasSpace_CompareAndPut(), tibasSpace_CompareAndPutEx()tibasSpace_CompareAndPutAll(), tibasSpace_CompareAndPutAllEx()