Share via


View or change properties of triggers and rules for triggers

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

To view or change properties of triggers and rules for triggers

  1. Open Computer Management.

  2. In the console tree, click Triggers or Rules, whichever is applicable.

    Where?

    • Computer Management/Services and Applications/Message Queuing/Triggers/Triggers (or Rules)
  3. In the details pane, right-click the applicable trigger or rule, and then click Properties.

  4. View or change trigger properties as needed. Note that trigger names cannot be changed.

    Trigger Property Tab

    Trigger name (view only)

    General

    Monitored queue (path name for a user queue)

    General

    Message processing type

    General

    Enabled or disabled

    General

    Serialized or nonserialized

    General

    Rules attached to the trigger

    Attached Rules

    Rules available for the trigger

    Attached Rules

    Or, view or change rule properties as needed. Note that rule names cannot be changed.

    Rule property Tab

    Rule name (view only)

    General

    Rule description

    General

    Conditions applied to the rule

    Rule Condition

    Whether the rule launches a stand-alone executable or a COM component

    Rule Action

    Path of a stand-alone executable

    Rule Action

    COM component ProgID

    Rule Action

    Method chosen for a COM component

    Rule Action

    Parameters used and their order. For types of parameters, see Trigger rules.

    Invocation Parameters

Notes

  • To open Computer Management, right-click My Computer, and then click Manage.

  • Triggers are not installed by default during Message Queuing installation. For information on installing triggers, see Installing Message Queuing triggers.

  • The Properties dialog box for a specific trigger has General and Attached Rules tabs. The Properties dialog box for a specific rule has General, Rule Condition, and Rule Action tabs, and there is an Invocation Parameters dialog box, which can be accessed from the Rule Action page.

  • The monitored queue of an existing trigger cannot be changed.

  • When you delete a queue, the triggers associated with that queue are not deleted. If you later re-create a queue of the same name, any existing triggers will be used by this queue. However, this re-created queue will not be monitored by the Message Queuing Triggers service until the computer is restarted, or the associated triggers disabled, and then enabled again.

  • A rule consists of one or more conditions and an action that is executed when the conditions are true. Each condition is applied to a message when it arrives at the monitored queue, and the result is either true or false. The conditions applied to a particular rule are listed in Condition list on the Rule Condition page of the Properties dialog box for that rule. A condition can be eliminated from this list by selecting it and clicking Remove. New conditions are composed by selecting a supported initial string in the New condition list box and typing a concluding string in the text box below it. Multiple conditions must all be true for an action to be executed. If no condition is specified, a true value will always be returned. This is useful when you want a trigger to fire unconditionally every time a message arrives at the monitored queue.

  • The actions performed when the conditions are true are expressed either in the form of an executable file and parameters (arguments) or in the form of a COM component, method, and parameters. You can specify one or more arguments to be passed per action. The supported parameters are listed in the list box on the Invocation Parameters dialog box, which can be accessed by clicking Parameters on the Rule Action page of the Properties dialog box for the particular rule.

  • The rules displayed on the Attached Rules tab are disabled by default, and you must attach them to the trigger to enable them. You can attach multiple rules to a trigger. In this case, the rules are executed in the order in which they are displayed in the Attached Rules list. You can change the priority (order of execution) of the rules in the list. To do so, use the Up and Down buttons on this page to give the rule a higher or lower priority, respectively. You can also detach rules on this page by selecting each rule that you want to detach and clicking Detach. For more information, see See Also.

  • All triggers and rules for triggers created on the local computer are displayed in the details pane of the Computer Management snap-in when the applicable folder is selected in the console tree.

Information about functional differences

  • Your server might function differently based on the version and edition of the operating system that is installed, your account permissions, and your menu settings. For more information, see Viewing Help on the Web.

See Also

Concepts

Administering Triggers
Triggers overview
Trigger rules