Copyright © Cloud Software Group, Inc. All Rights Reserved

tibasSpace_LockEx()

Function

Declaration

tibas_status tibasSpace_LockEx(

tibasSpace space,

tibasTuple* value,

tibasTuple key,

tibasLockOptions options)

Purpose

Locks the tuple associated with a key tuple value, and allows you to specify a wait value and a forget value.

Parameters

 

Parameter	Description
space	The TIBCO ActiveSpaces entity on which the function is invoked.
value	Returns either the tuple containing the locked tuple or NULL if no matching tuple can be found in the space.
key	A tuple containing key fields.
options	Provide a tibasLockpOtions structure that specifies the options for the lock.

Remarks

Use the tibasSpace_LockEx() function to lock the tuple associated with a key tuple value, and also to specify a wait value and a forget value.

The options parameter specifies 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;

}

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.

See Also

tibasSpace_Lock(), tibasSpace_LockAll(), tibasSpace_LockAllEx(), tibasSpace_Unlock(), tibasSpace_UnlockAll()

Copyright © Cloud Software Group, Inc. All Rights Reserved