tibasListenerDef_SetTimeScope()

Sets the time scope associated with the listener.

Declaration

tibas_status tibasListenerDef_SetTimeScope
(tibasListenerDef listenerDef,
tibas_timeScope    timeScope)

Parameters

Parameter Description
listenerDef The TIBCO ActiveSpaces entity on which the function is invoked.
timeScope The time scope values for the listener. The time scope can be one of the following:
  • TIBAS_TIME_SCOPE_SNAPSHOT
  • TIBAS_TIME_SCOPE_NEW (the default)
  • TIBAS_TIME_SCOPE_NEW_EVENTS
  • TIBAS_TIME_SCOPE_ALL

Remarks

Use the tibasListenerDef_SetTimeScope() function to set the time scope for events that a lister will listen for. You can specify the following values:

TIBAS_TIME_SCOPE_ALL
The listener starts with all the tuples currently in the space at creation time (which will be presented as an initial set of PUT events) and then is continuously updated according to changes in the space.
TIBAS_TIME_SCOPE_SNAPSHOT
The listener contains only PUT events corresponding to the tuples stored in the space at creation time.
TIBAS_TIME_SCOPE_NEW
The listener starts empty and is updated only with events related to new or updated tuples in the space.
TIBAS_TIME_SCOPE_NEW_EVENTS
The listener starts empty and is updated with all events that occur in the space after creation time.

After you set the attributes for the ListenerDef object, you can pass it to either the tibasSpace_Listen() function or the tibasMetaspace_Listen() function to attach the listener to a space.

See Also

tibasListenerDef_Create(), tibasListenerDef_CreateEx(), tibasListenerDef_SetDistributionScope(), tibasSpace_Listen(), tibasMetaspace_Listen()