tibasSpace_Listen()

Attaches a listener to a space for receiving space events.

Declaration

tibas_status tibasSpace_Listen
(tibasSpace      space,
tibasListener    listener,
tibasListenerDef listenerDef,
const char*      filter)

Parameters

Parameter Description
space The TIBCO ActiveSpaces entity on which the function is invoked.
listener The listener object returned by the function.
listenerDef The listener definition.
filter A filter string to apply to the listener or NULL.

Remarks

Use the tibasSpace_Listen() function to activate a tibasListener object for a specified space and initialize a listener for the space.

Before you can activate the listener, you must be connected to the space on which you want to listen for events; and you must get the parameters for the call to tibasSpaceListen() from calls to several additional ActiveSpaces functions:

space
The Space object that is returned by calling tibasMetaspace_GetSpace() or tibasMetaspace_GetSpaceEx().
listener
A tibasListener object that is returned by calling the tibasListener_Create() function.
listenerDef
Specifies a listenerDef object that is returned by calling tibasListenerDef_Create() or tibasListenerDef_CreateEx().

The optional last parameter, the filter parameter, can be used to provide a filter string that limits the events processed by the listener.

See Also

tibasMetaspace_Listen(), tibasListenerDef_Create(), tibasListenerDef_CreateEx()