Working with event handlers
MPX has an event transmitter that must be installed on the same computer as the Server. In addition, the Message Broker can be installed on the same or another computer, depending on your needs. If you install the Message Broker, Unicast On-site event displays in the Event Handlers tab of the Configure Server dialog box.
For more information about MPX, its XML files, properties, and values, see MPX installation and configuration. The following topic describes how to work with event handlers. The Event Handlers tab provides a simple interface for editing the EventTransmitter.XML files.
Note: You can perform these operations only on a running server configuration.
Creating event handlers
The Event Handlers tab provides a simple interface for editing the EventTransmitter.XML files.
Note: You can perform this operation only on a running server configuration.
-
Open the
Server Administration tool and select the server configuration.
- Click Tools > Administration > Configure Server. The Configure Server page opens.
-
Click the Event Handlers tab.
To create a new event handler from scratch: - Click Add to open an empty Event Handler Profile Properties dialog box.
- Type a name and description in the appropriate fields.
- Click Add to display an empty Event Handler Property dialog box.
- Type the property name and its value in the fields.
- Repeat until you have added all the properties you need.
To create a new event handler from an existing one: - Select an existing event handler that is very similar in its properties to the new handler that you need.
- Click Copy. The Event Handler Profile Properties dialog box opens displaying the properties for the selected event handler.
- Change the name and description in the appropriate text boxes.
- Select and modify other properties as appropriate.
-
Click
OK.
Reviewing or modifying existing event handlers
For more information about MPX, its XML files, properties, and values, see MPX installation and configuration. This topic describes how to review or modify existing event handlers. The Event Handlers tab provides a simple interface for editing the EventTransmitter.XML files.
Note: You can perform this operation only on a running server configuration.
-
Open the
Server Administration tool and select the server configuration.
-
Click
The Configure Server page opens.
.
-
Click the
Event Handlers tab.
- Select an existing event handler.
-
Click Modify. The Event Handler Profile Properties dialog box opens.
To change a setting - Select a setting from the Profile Properties list.
- Click Modify. The Event Handler Property dialog box opens.
- Change the value.
To add a property - Click Add. An empty Event Handler Property dialog box opens.
- Type a property name and value in the appropriate check boxes.
To remove a property - Select a setting from the Profile Properties list.
- Click Remove. Be aware that you cannot delete a profile that is currently used as the default profile.
-
Click
OK.
Assigning default event handlers
This section describes how to assign default event handlers for servers and clients.
To assign the event handlers:
-
Open the
Server Administration tool and select the server configuration.
-
Click
Tools
> Administration
> Configure Server.
The Configure Server page opens. - Select the Event Handlers tab.
- Select an existing event handler.
-
Click one or both of the following:
Server Default Makes the selected profile the profile for the server. A server icon displays in front of the default server profile. Client Default Makes the selected profile the default profile for clients. A green check mark displays in front of the default client profile. As users create server descriptions on their workstations, the profile selection defaults initially to this profile. Users can change from the default to another existing profile. If a profile is both the server and client default, you see only the server icon. -
Click
OK.
Note: A file transmitter does not use profiles. It interacts with the event transmitter which uses the Server Default profile.
Removing an event handler
To remove an event handler:
-
Click the
Event Handlers tab.
- Select an existing event handler.
- Click Remove.