Message handler list

Use this page to configure message handlers that perform such tasks as finding users in the local community for whom to relay messages, checking the access control for local community members, and logging IBM® Sametime® Gateway Server events. Message handlers that are provided by Sametime Gateway Server, with the exception of the Event logger, do not need configuring.

Message handlers are WebSphere® Application Server applications that you install using the Integrated Solutions Console by clicking Applications > Enterprise Applications. You can add a custom message handler to the Sametime Gateway Server by first installing it, configuring its properties, and then enabling the application through the Message handler list.

You can enable and disable message handlers or move message handlers up or down in the list to change the order in which a message handler processes messages.

Note: The Default User Locator must be at the beginning of the list.

Table 1. Message handlers
Button	Resulting action
Enable	Enables the message handler after it has been installed and configured.
Disable	Disables the message handler.
Move Up	Moves the message handler earlier in the list so that it will process messages before other message handlers. The Default User Locator must remain at the beginning of the list to function properly. For best results, keep the Event Logger in the last position.
Move Down	Moves the message handler later in the list so that processes messages after other message handlers. The Default User Locator must remain at the beginning of the list to function properly. For best results, keep the Event Logger in the last position.

Table columns

Use the Select column to select individual or multiple message handlers. Click the select all icon () to select all message handlers listed, if, for example, you want to enable or disable all message handlers. Only those visible on the table are selected if the list of message handlers takes more than one page. If you have more than one page, you must select handlers from additional pages separately. You can then clear (deselect) only those message handlers that you do not want to select.

Click the deselect all icon () to clear all check boxes on the visible page of the table only.

The Name is the programmatic name of the message handler. Click the name to view or edit the message handler properties.

The Type is one of four types assigned to the message handler. The type provides a general description of the message handler's purpose but has no effect on how the message handler functions.

The Status shows whether the message handler is enabled or not.