To create a new mail rule

1. Click New Rule.

2. In the Specify Conditions section of the New Rule dialog box, set the criteria the server uses to determine whether to apply a rule to a given message. A rule condition can include the following components:

Condition component	Description
Message item	Specifies the IBM® Lotus® Notes® message item that the Router examines when evaluating whether to apply a rule. Choose one of the following: Sender, Subject, Body, Importance, Delivery priority, To, CC, BCC, To or CC, Body or subject, Internet domain, Size (in bytes), All documents, Attachment name, Number of attachments, Form, Recipient count, or Any recipient Note To create a rule that acts on all messages deposited in MAIL.BOX, choose All Documents.
Logical operator or qualifier	Specifies how the Router evaluates the content of the target field. Choose one of the following: contains (for text field values) does not contain (for text field values) is is not is less than (for numeric field values) is greater than (for numeric field values) For example, if you selected the message item Attachment Name, selecting the qualifier "is" defines a rule that acts on all messages having an attached file with a name that exactly matches the name you specify.
Field value to check	Specifies the content to search for in the target message item. For example, if the target message item is Attachment Name and the qualifier is "contains," enter .VBS to create a rule that acts on all messages having an attached file with a name containing the string .VBS, including, LOVE-LETTER.VBS, CLICK-THIS.VBS.TXT, and MY.VBS.CARD.EXE. Note When defining a match against a user's name, specify the canonical format, for example, UserName/Sales/East Text fields do not support wildcard values, such as the asterisk character (*). To specify a search string for a target field, use the "contains" operator and enter the search string in the accompanying text field. For example, as in the preceding example, to search for an attached file with a name that contains the string .VBS, create the condition "Attachment Name contains .VBS", not "Attachment Name is *.VBS." Search string text is not case-sensitive. When indicating numeric values, always enter a numeral, rather than its text equivalent, (that is, enter 2, not two).

3. Click Add.

4. (Optional) Modify the condition by doing the following:

• Add more conditions, by selecting Condition, selecting "AND" or "OR," and repeat Steps 7 and 8 for each new condition.
• Add an exception by selecting Exception and repeating Steps 7 through 9 for each exception. You can add only one exception to a condition statement.

The following actions are available:

Action name	Description
Journal this message	The Router sends a copy of the message to the configured Mail Journaling database and continues routing the message to its destination. Journaling must be enabled on the Router/SMTP - Advanced - Journaling tab. See "Mail Journaling" for more information.
Move to database	The Router removes the message from MAIL.BOX and quarantines it in the database specified in the accompanying text field, for example, GRAVEYARD.NSF. The specified database must already exist. The message is not routed to its destination. Placing messages in a quarantine database lets you examine them more closely for viruses or other suspicious content.
Don't accept message	IBM® Lotus® Domino™ rejects the message, but the Router does not generate a delivery failure report. Depending on the message source, the sender may or may not receive an NDR or other indication that the message was not sent. When Domino does not accept an incoming SMTP message it returns an SMTP "permanent error" code to the sending server, indicating that the message was rejected for policy reasons. SMTP permanent errors (500-series errors) indicate error types that will recur if the sender attempts to send to the same address again. Depending on the configuration of the sending client and server, the message originator may then receive a Delivery Failure report. For messages received over Notes routing, Domino returns a Delivery Failure Report indicating that the message violated a mail rule. For messages deposited by a Notes client, the sending client displays an error indicating that the message violated a mail rule.
Don't deliver message	Domino accepts the message, but rather than sending it to its destination, it processes the message according to one of the following specified options: Silently delete - Domino deletes the message from MAIL.BOX with no indication to the sender or recipient. Send NDR - Domino returns the message to the sender. The MIME and Notes rich text versions of messages sent from a Notes client result in separate delivery failure reports.
Change routing state	Domino accepts the message, but does not deliver the message. Instead, the routing state of the message is changed as specified by one of the following secondary actions: Mark as held - Domino retains the message in MAIL.BOX and changes the value of the RoutingState item on the message to HOLD. Domino holds the message indefinitely, pending administrative action. Note When you mark a message as held, other rules are not executed until the "held" message is released. Mark as dead - Domino retains the message in MAIL.BOX and changes the value of the RoutingState item on the message to DEAD.

To save the rule, but wait before putting it into effect, click the Off radio button at the top of the dialog box, and then click OK.

8. Click Save & Close.

9. The change takes affect after the next Router configuration update. To put the new setting into effect immediately, reload the routing configuration.

Glossary