Persister Action Op OpList ActionResult LogLevel and Recovery Functions

The Persister object enables the user to specify a set of functions that collectively implement the Persister interface. Once a Persister object is created, it can then be registered on a space using the tibasSpace_SetPersister function.

The Action, Op, OpList, and ActionResult classes are closely related to the Persister class. Functions implementing persistence get passed a tibasAction and return a tibasActionResult. The tibasAction objects have a type, contain the space for which the action applies and its name. Actions of type TIBAS_ACTION_READ also contain a tuple (the values of the key fields for the record that needs to be read from the persistence layer) and Actions of type TIBAS_ACTION_WRITE contain an OpList. Op objects represent individual persistence operations and have a type.

Recovery options enable data recovery in the metaspace.

• tibasPersister_Create()
  Creates a Persister object that can be registered on a space. The arguments of this call are used to specify the names of functions that will be invoked at various points in the life cycle of a space.
• tibasPersister_Free()
  Destroys allocated resources and frees memory.
• tibasAction_GetType()
  Returns the action type for a specified action.
• tibasAction_GetTuple()
  For actions of the type TIBAS_ACTION_READ, returns a tuple containing the key fields for the tuple that needs to be retrieved from the persistence layer
• tibasAction_GetSpace()
  Returns a valid Space object for the space that triggered this invocation of the persister function. Applicable to Actions of all types.
• tibasAction_GetSpaceName()
  Returns the name of the space that triggered the invocation of the persister function. Applicable to Actions of all types.
• tibasAction_GetOps()
  For actions of the type TIBAS_ACTION_WRITE, returns a list of operations to apply to the persistence layer.
• tibasAction_Free()
  Frees a specified action object.
• tibasOp_GetType()
  Returns the type of a specified persistence operation.
• tibasOp_GetTuple()
  Returns the tuple associated with a specified Op. Applicable to all types of Op.
• tibasOp_GetOldTuple()
  For Ops of the type TIBAS_OP_PUT, returns the oldTuple that was overwritten (updated) by the put if there was one, or NULL (if the put was an insert).
• tibasOp_HasOldTuple()
  For applicable to Ops of the type TIBAS_OP_PUT, indicates whether the put operation overwrote and existing tuple.
• tibasOp_Free()
  Frees a specified Op object.
• tibasOpList_Size()
  Returns the number of ops in a specified OpList object.
• tibasOpList_Get()
  Returns the Op stored at a specified position index in an Op list.
• tibasOpList_Free()
  Frees a specified OpList.
• tibasActionResult_SetFailed()
  Sets the state of the ActionResult to failed.
• tibasActionResult_GetStatus()
  Reserved for future use.
• tibasActionResult_SetTuple()
  Stores a tuple retrieved from persisted storage into an action result object.
• tibasActionResult_GetTuple()
  Reserved for future use.
• tibas_SetInvocable()
  Specifies the name of an application function to be invoked.
• tibas_SetMemberInvocable()
  Specifies the name of an application function to be invoked on a specified space member.
• tibas_RemoveInvocable()
  Removes the name of a specified invocable.
• tibas_RemoveMemberInvocable()
  Remove a specified member invocable.
• tibas_SetLogLevel()
  Sets the log level used by ActiveSpaces.
• tibas_GetLogLevel()
  Returns the log level used by ActiveSpaces.
• tibas_EnableFileLogging()
  Enables logging of specified log level messages to a specified log file.
• tibas_DisableFileLogging()
  Disables file logging.