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
Open Computer Management.
In the console tree, click Triggers or Rules, whichever is applicable.
Where?
- Computer Management/Services and Applications/Message Queuing/Triggers/Triggers (or Rules)
In the details pane, right-click the applicable trigger or rule, and then click Properties.
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.