Using the Message Handler Manager

Open the Message Handler Manager to view, edit, or delete message handlers.

About this task

To open the Message Handler Manager, choose Tools ► Message Handler Manager. The Edit Message Handlers dialog box appears.

To edit an existing handler:

Procedure

  1. Choose an option to specify whether you want to edit the project-level message handler, edit the handler for the currently selected job, or edit a specific message handler. If you want to edit a specific message handler, select the handler from the drop-down list. The settings for whichever handler you have chosen to edit appear in the grid. (Note that the option to edit the project level handler is only available if such a handler has been set up in the Administrator client.)
  2. Edit the grid as required, you can:
    • Choose a new Action for a particular message. Select a new Action from the drop-down list. Possible Actions are:

      Suppress from log. The message is not written to the job's log as it runs.

      Promote to Warning. Promote an informational message to a warning message.

      Demote to Informational. Demote a warning message to become an informational one.

    • Delete a message. Select the message in the grid, right-click and choose Delete Row from the shortcut menu.
    • Add a new message. Right-click in the grid and choose Insert Row from the shortcut menu. You can then type in details of the message you want to add to the handler.

      When you are done with your edits, click Save and choose Save Message Handler to save the handler with its current name or Save Message Handler As to save it as a new handler.

To delete a handler:

Procedure

  1. Choose an option to specify whether you want to delete the local runtime handler for the currently selected job, delete the project-level message handler, or delete a specific message handler. If you want to delete a specific message handler, select the handler from the drop-down list. The settings for whichever handler you have chosen to edit appear in the grid.
  2. Click the Delete button.

To define a new handler:

Procedure

  1. Choose Edit chosen message handler and select (New) from the drop-down list. The grid clears, allowing new message rules to be added.
  2. Type in the message ID for the first message you want to add to the handler.
  3. Choose an Action from the drop-down list. Possible Actions are:
    • Suppress from log. The message is not written to the job's log as it runs.
    • Promote to Warning. Promote an informational message to a warning message.
    • Demote to Informational. Demote a warning message to become an informational one.
  4. Repeat this process until you have added all the required messages.
  5. When you have defined all the required messages for the handler, click Save and choose Save Message Handler As from the menu. A dialog box opens and prompts you for the name of the new handler.
  6. Type in the name for your new message handler.