Space

A space provides shared virtual storage for data.

  • A space is a shared entity in the sense that many applications can access it concurrently and each application has the same coherent view of the data contained in the space. The spaces in ActiveSpaces are called tuple spaces, and the items stored in them are called tuples.
  • A space is a virtual entity in the sense that it is distributed and implemented collaboratively by a group of processes located on multiple hosts and communicating over the network.

The space operations that perform data operations on the space generally are provided as pairs of functions—a base version of the operation and an “extended” version of the operation that provides more flexibility in performing the operation.

  • tibasSpace_Get()
    Returns the tuple (if one exists) in the specified space whose key fields match the key fields of a specified tuple.
  • tibasSpace_IsReady()
    Sets the value of is Ready to TIBAS_TRUE if the space is ready to be used.
  • tibasSpace_WaitForReady()
    Queries the state of the space. Returns a value indicating that the space is ready; or if it is not ready, returns a value indicating that the space is not ready.
  • tibasSpace_GetAll()
    Batch version of the tibasSpace_Get() function. Returns a list of tuples matching key values that you provide.
  • tibasSpace_Browse()
    Returns a browser for the space to iterate through all the tuples that match the filter.
  • tibasSpace_BrowseEvents()
    Returns a browser for the space to iterate through all the events that match the filter.
  • tibasSpace_CompareAndPut()
    Specifies a tuple to look for. If the old value is unmodified, replaces the existing tuple with the specified value.
  • tibasSpace_CompareAndPutEx()
    Compares the values in a specified tuple with existing data. If the old value is unmodified, replaces the existing tuple with the specified value. Allows you to set lock and lock wait attributes for the tuple.
  • tibasSpace_CompareAndPutAll()
    Compares the values in a list of old values with the existing values in the space. If the old values are unmodified, replaces the existing tuples with the specified new values.
  • tibasSpace_CompareAndPutAllEx()
    Compares the values in a list of old values with the existing values in the space. If the old values are unmodified, replaces the existing tuples with the specified new values. Allows you to set lock and lock wait attributes for the tuple.
  • tibasSpace_CompareAndTake()
    Looks for a tuple containing a specified value, and if it is found, takes the tuple value.
  • tibasSpace_CompareAndTakeAll()
    Compares values in a list of specified values with the values in the existing tuples. If value matches are found, takes the specified tuples.
  • tibasSpace_CompareAndTakeAllEx()
    Compares values in a list of specified values with the values in the existing tuples. If value matches are found, takes the specified tuples. Allows you to set lock and lock wait attributes for the tuples.
  • tibasSpace_Listen()
    Attaches a listener to a space for receiving space events.
  • tibasSpace_Put()
    Stores a tuple into the space and returns the corresponding tuple.
  • tibasSpace_PutEx()
    Stores a tuple into the space and returns the corresponding tuple, and allows you to specify a lock wait value, lock or unlock value, and a forget value.
  • tibasSpace_PutAll()
    The batch version of the put operation. Stores all of the tuples in the provided list and returns a list of results.
  • 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, a lock or unlock value, and a forget value.
  • tibasSpace_Take()
    Returns and atomically removes from the space the tuple (if one exists) whose tuple key fields match the key fields of the tuple provided.
  • tibasSpace_TakeEx()
    Returns and atomically removes from the space the tuple (if one exists) whose tuple key fields match the key fields of the tuple provided. Allows you to specify a lock wait value, a lock and unlock value, and a forget value.
  • tibasSpace_TakeAll()
    Batch version of the take operation,. Requires a list of key value tuples to take and returns a list of results.
  • tibasSpace_TakeAllEx()
    Batch version of the take operation. Requires a list of key value tuples to take and returns a list of results. Allows you to specify a lock wait value, a lock or unlock value, and a forget value.
  • tibasSpace_GetSpaceDef()
    Returns the spaceDef object that defines a specified space.
  • tibasSpace_GetName()
    Returns the space name.
  • tibasSpace_GetMetaspaceName()
    Returns the metaspace name for the metaspace to which a specified space belongs.
  • tibasSpace_GetMetaspace()
    Returns the metaspace to which a specified space belongs.
  • tibasSpace_Size()
    Returns the number of entries in the space.
  • tibasSpace_ExplainQuery()
    Returns a status that provides information on the cost of the query execution on each seeder.
  • tibasSpace_Lock()
    Locks the tuple associated with a specified key value.
  • tibasSpace_LockEx()
    Locks the tuple associated with a key tuple value, and allows you to specify a wait value and a forget value.
  • tibasSpace_LockAll()
    Batch version of the Lock operation. Requires a list of key value tuples to lock and returns a list of the tuples that are locked.
  • tibasSpace_LockAllEx()
    Batch version of the lock operation. Requires a list of key value tuples to take and returns a list of results.
  • tibasSpace_Unlock()
    Unlocks a tuple in a specified space that has a specified key.
  • tibasSpace_UnlockAll()
    Batch version of the unlock operation. Requires a list of tuples to unlock and returns a list of results.
  • tibasSpace_SetDistributionRole()
    Sets the distribution role of the member for the space.
  • tibasSpace_SetPersister()
    Register the persister object being specified as a persister on the space.
  • tibasSpace_Invoke()
    Invokes an appropriate function defined in the application code of a member that seeds a specified space.
  • tibasSpace_InvokeMember()
    Invokes a specified function on a specified space member.
  • tibasSpace_InvokeMembers()
    Invokes a specified application function on the members of a specified space.
  • tibasSpace_InvokeRemoteMembers()
    This is a deprecated function.
  • tibasSpace_InvokeSeeders()
    Invokes a specified application function on all seeders that have joined a specified space.
  • tibasSpace_Load()
    Loads a tuple into a specified space, but does not trigger a persister's onWrite function. Used in the Onload function provided to implement shared all persistence.
  • tibasSpace_LoadAll()
    Batch version of the tibasSpace_Load() function. Used if shared all persistence is implemented.
  • tibasSpace_Free()
    Leaves the space. Destroys allocated resources and frees memory.
  • tibasSpace_Clear()
    Deletes the tuples that match a specified filter from a specified space.
  • tibasRecoveryOptions_Initialize()
    Sets the values in a structure used to call the tibasMetaspace_RecoverSpaceEx() function.
  • tibasPutOptions_Initialize()
    Sets the values in a structure used to call the tibasSpace_PutAllEx() function or the tibasSpace_CompareAndPutAllEx() function.
  • tibasTakeOptions_Initialize()
    Sets the values in a structure used to call the tibasSpace_TakeAllEx() function or the tibasSpace_CompareAndTakeAllEx() function.
  • tibasLockOptions_Initialize()
    Sets the values in a structure used to call the tibasSpace_LockEx() function.
  • tibasUnlockOptions_Initialize()
    Sets the values in a tibasUnlockOptions structure.
  • tibasInvokeOptions_Initialize()
    Sets the values in a structure used to call the tibasSpace_Invoke() function or the tibasSpace_InvokeMember() function.