Managing TIBCO EMS topics

Topics are subjects containing a set of related messages. Individual subscribers decide which topics are of value and then subscribe to them.

Topics are collected asynchronously. When a message listener hears that one or more topic messages have arrived for the recipient, it passes them on.

Select the Topics objects from the Navigation Panel. The workspace fills with its Summary View:

 

Available operations:

• Copy As New Topic: Copies the topic - see also Creating a topic below.
• Purge: Empty topic of messages.
• Delete: Delete the topic.
• View Messages: View and create new messages for the topic. See the section on Editing messages.
• Permissions: View, edit, create or delete object permissions on a per principal basis for the selected topic. See the sections below for more on assigning permissions per topic.
• Tag Topic: Add the topic to a tag consisting of related topics and objects.
• Audit: Lets you view the last related (10) audit log entries and access audit events related to the Topic, such as a record of changes made previously to the selected Topic.

To access the selected Topic's Properties Editor, click on the Topic Name.

Working with topic permissions

You can perform several different actions with topic permissions (note that these actions apply to the permissions operations for additional objects). Again, these are user or group permissions in relation to specific topics.

To view permissions:

1. For the required server, select the Topics object.
2. From the Topics list, select Permissions from the Operations drop-down menu next to the required topic.
3. View the Object Permissions view for that topic.
4. You can also drill down into the editor for each group or user, and change current permissions.

To associate a new principal with a topic:

1. From the Object Permissions for topic view, select the New  icon.
2. View the New Principal for... pane (where principal is another user to which to assign permissions for the topic).
3. Set the Principal name.
4. Set Principal Type, which can be either User or Group.
5. Assign specific TIBCO EMS permissions for the new user or group.
6. Select Save to add this principal to the Object Permissions list for the topic.

Creating a new topic message

To create a new message for a topic:

1. Open the Topics view.
2. Select View Messages from the Operations drop-down menu for the topic to which you want to add a message.
3. View the Messages for Topic... pane.
4. Select the New (message)  icon from the Options bar. Note that there also is an 'Upload/Import' button next to the New  icon, enabling you to create one or multiple messages from a file.
5. In the new message parameters pane, configure any of the parameters options.
6. Enter message content in the text edit box.
7. Select Save to save the new message and add it to the topic.

To publish one or more messages to a topic:

1. Once a TIBCO EMS Server is selected, click Topics from the Navigation Panel to display the list of Topics.
2. Identify a topic whose messages you want to view or which you want to publish messages to, and then select View Messages from the Operations drop-down menu.
3. The Messages for Topic... pane is displayed, and TrueSight Middleware Administrator waits for messages published in a brief interval to then display messages received during that time. Note that TrueSight Middleware Administrator does not act as a durable subscriber and so will only receive messages published during this short period. Depending on the messaging activities for that topic there may only be a few messages being displayed in the Messages for Topic … view.
4. Create a new message and publish it to the topic by clicking on the + (New) button on the Generic Options toolbar. The New Message dialog is displayed. Create the new message as described in the Working with the Create New Message dialog section for a queue.
5. To publish messages from a file click on the Upload/Import icon in the Generic Options toolbar. Select the message file and message parameters as described in Working with the Edit Message dialog section for uploading/importing messages from a file to a queue.

Creating a topic

To create a topic:

1. From the Topics Summary view, select the New  icon.
2. In the displayed Properties for New Topic editor, set all needed properties (refer to TIBCO EMS documentation as required to confirm what is required).
3. Save the new topic; it is added to the Topics view.