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.

Back to top

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.

  1. Open the Server Administration tool and select the server configuration.
  2. Click Tools > Administration > Configure Server. The Configure Server page opens.
  3. Click the Event Handlers tab.

    To create a new event handler from scratch:
    1. Click Add to open an empty Event Handler Profile Properties dialog box.
    2. Type a name and description in the appropriate fields.
    3. Click Add to display an empty Event Handler Property dialog box.
    4. Type the property name and its value in the fields.
    5. Repeat until you have added all the properties you need.
    To create a new event handler from an existing one:
    1. Select an existing event handler that is very similar in its properties to the new handler that you need.
    2. Click Copy. The Event Handler Profile Properties dialog box opens displaying the properties for the selected event handler.
    3. Change the name and description in the appropriate text boxes.
    4. Select and modify other properties as appropriate.
  4. Click OK.

Back to top

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.

  1. Open the Server Administration tool and select the server configuration.
  2. Click Tools > Administration > Configure Server.

    The Configure Server page opens.

  3. Click the Event Handlers tab.
  4. Select an existing event handler.
  5. Click Modify. The Event Handler Profile Properties dialog box opens.

    To change a setting
    1. Select a setting from the Profile Properties list.
    2. Click Modify. The Event Handler Property dialog box opens.
    3. Change the value.
    To add a property
    1. Click Add. An empty Event Handler Property dialog box opens.
    2. Type a property name and value in the appropriate check boxes.
    To remove a property
    1. Select a setting from the Profile Properties list.
    2. Click Remove. Be aware that you cannot delete a profile that is currently used as the default profile.
  6. Click OK.

Back to top

Assigning default event handlers

This section describes how to assign default event handlers for servers and clients.

To assign the event handlers:

  1. Open the Server Administration tool and select the server configuration.
  2. Click Tools > Administration > Configure Server.
    The Configure Server page opens.
  3. Select the Event Handlers tab.
  4. Select an existing event handler.
  5. 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.
  6. Click OK.

Note: A file transmitter does not use profiles. It interacts with the event transmitter which uses the Server Default profile.

Back to top

Removing an event handler

To remove an event handler:

  1. Click the Event Handlers tab.
  2. Select an existing event handler.
  3. Click Remove.

Back to top