Creating a Destination and Event Using the Wizard for AS

TIBCO Channel Wizards provide an option to create a destination and event for a specific ActiveSpaces channel.

Note: The wizard requires the metaspace and spaces in TIBCO ActiveSpaces to be created and initialized. Otherwise, no spaces are listed on the Select space dialog. You must create and initialize the metaspace and then click Refresh to refresh the list of spaces that the channel can connect to.

Procedure

  1. In BusinessEvents Studio Explorer, select the ActiveSpaces channel for which you need to create a destination and event. From the menu, select File > New > Other > TIBCO Channel Wizards > ActiveSpaces Destination and Event and click Next.
  2. The Select Space dialog lists the available spaces for every ActiveSpaces channel in the project.
    Note: If no spaces are listed on the Select space dialog, check if the metaspace is created and initialized. Create and initialize the metaspace, and then click Refresh to refresh the list of spaces that the channel can connect to.

    Select a space and click Next.

  3. On the New SimpleEvent and Destination dialog, enter the values to configure the simple event and destination for the selected channel and space.
    Configuring an ActiveSpaces Destination and Event
    Field Name Description
    Simple Event
    Name Name of the simple event to be created. The default name is of the format <spaceName>Event.
    Destination
    Name Name of the destination to be created. The default name on the screen is of the format <spaceName>Dest.
    Default Event The default event for the destination. This is set to the SimpleEvent specified to be created by the wizard.
    Serializer/Deserializer The serializer used to map tuples in ActiveSpaces to simple events in TIBCO BusinessEvents.

    The default value is com.tibco.cep.driver.as.serializers.ActiveSpacesSerializer.

    See ActiveSpacesSerializer for more information.

    Space Name Name of the space which the destination connects to. This space is selected in the Select space dialog.

    See Space for more information about spaces in TIBCO ActiveSpaces.

    Distribution Role The level of participation of the space member: seeder or leech.

    See Distribution role for more information.

    Filter String specified to evaluate tuples and refine the set of tuples to work. A filter string can be seen as what would follow the where clause in a select * from Space where… statement.

    See Filters for more information.

    Consumption Mode Specifies the consumption mode for the ActiveSpaces event as one of:
    • Event Listener - listens for specific events to occur, and invokes a callback function from TIBCO ActiveSpaces.
    • Entry Browser - can listen and retrive tuples from the space using the Get or Take methods.
    • Router - feeds the events to only the specified listener. This way, the application benefits from having multiple listener processes running.

    See Consumption mode for more information.

    Browser Type Available only when the consumption mode is Entry Browser.

    Specifies the browser type used to retrieve tuples from a space. You can choose either Get or Take.

    The difference between the Get and Take browsers is that Get retrieves a copy of the tuple from the space and Take retrieves the tuple from the space, and there is no trace of the tuple in the space after the Take event.

    Put Event Available only when the consumption mode is Event Listener.

    When selected, the Event Listener listens for any Put events on the space and invokes a callback function when such an event occurs.

    Take Event Available only when the consumption mode is Event Listener.

    When selected, the Event Listener listens for any Take events on the space and invokes a callback function when such an event occurs.

    Expire Event Available only when the consumption mode is Event Listener.

    When selected, the Event Listener listens for any Expire events on the space and invokes a callback function when such an event occurs.

    Prefetch Available only when the consumption mode is Entry Browser.

    Set the value in field to attain optimum performance. The default value is -1 (prefetch all).

    Note: You can control the query limit for an ActiveSpaces channel using the property be.engine.channel.as.querylimit. You can set this property in CDD so that the channel can receive entries beyond 10000 (default in TIBCO ActiveSpaces). The default value in TIBCO BusinessEvents is -1, which indicates no limit on queries.
  4. Click Finish to create the destination and the simple event.

Result

Note: The wizard adds the following properties to the simple event:
  • id of type long
  • consumption_mode of type string
  • browser_type of type string
  • event_type of type string