tibas_SetInvocable()

Specifies the name of an application function to be invoked.

Declaration

tibas_status tibas_SetInvocable(
    const char*     name,
    tibas_invocable invocable);

Parameters

Parameter Description
name Specifies the name of an application function to be invoked.
invocable Specifies a tibas_invocable structure that sets the space, tuple, and context for the invocation, and also returns the result of the function call.

Remarks

Use the tibas_SetInvocable() function to specify a function that is called on a seeder. You must call tibas_SetInvocable() before you call the tibasSpace_Invoke() function.

The name parameter specifies the name of the invocable function that is called.

The invocable parameter specifies a tibas_invocable type that provides the name of a function that conforms to the function prototype for invocable functions.

The tibas_invocable typedef specifies the function prototype for an invocable function, and has the following syntax:

typedef void (TIBAS_CALL_API *tibas_invocable)(
    tibasSpace space,
    tibasTuple tuple,
    tibasTuple context,
    tibasTuple result);

where:

space
 Specifies the space on which the invocable function is to be invoked.
tuple
 Specifies a tuple that will be used to determine which entry to invoke the function on.
context
 Specifies a user-defined context string used to identify the function.
result
 Returns the result of the invocation.

For a sample program showing the use of tibas_SetInvocable() and tibas_SpaceInvoke(), see the InvokeClient sample program provided with the ActiveSpaces distribution. For documentation on InvokeClient, see Remote Space Invocation: InvokeClient in the TIBCO ActiveSpaces Developer’s Guide.

See Also

tibas_SetMemberInvocable(), tibasSpace_Invoke()