Adding rules to message handlers

You can add rules to message handlers 'on the fly' from within the Director client.

About this task

Using this method, you can add rules to handlers that are local to the current job, to the project default handler, or to any previously-defined handler.

To add rules in this way, highlight the message that you want to add a rule about in the job log and choose Add rule to message handler... from the job log shortcut menu or from the Job menu on the menu bar. The Add rule to message handler dialog box appears.

Procedure

  1. Choose an option to specify which handler you want to add the new rule to. Choose between the local runtime handler for the currently selected job, the project-level message handler, or a specific message handler. If you want to edit a specific message handler, select the handler from the Message Handler drop-down list. Choose (New) to create a new message handler.
  2. Choose an Action from the drop down list. Choose from:
    • 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.

      The Message ID, Message type and Example of message text fields are all filled in from the log entry you have currently selected. You cannot edit these.

  3. Click Add Rule to add the new message rule to the chosen handler.
  4. Click Previous or Next to move through the messages in the job log and add further rules to the selected handler.

Results

If you click Edit Handler..., the Edit Message Handlers dialog box appears, enabling you to manage the message handlers.

Parent topic: Message handlers