# Adding a Domain Processing Rule

You can use domain processing rules to direct incoming mail to particular mailboxes based on the contents of To, From, Sender, Subject, the entire message Header (everything but the body of the message), or the Body of the message.

1. From the Select Field list box, select the area of the message that you want to search.

2. Select contains to have the rule look for messages that contain the search string; select doesn't contain to look for messages that do not contain the string.

3. In the Phrase text box, enter a search string as described below.

4. SelectCase Sensitive Match to search for text that matches the case of the search string; to ignore case, clear Case Sensitive Match.

5. Select one of the following Filter Actions to take on messages that meet the rule criteria:

   - Send the message to a mailbox. Select Move the message to this mailbox. and in the Destination text box, enter the name of the mailbox to which messages meeting the rule criteria will be sent. You can enter the user ID to which messages meeting the rule criteria will be sent, followed by the mailbox. To do this, follow the user ID with a hyphen and the mailbox name, such as poreilly-news@company1.com. If you enter a mailbox that does not exist, one will be created for this user. A POP3 user will see this mailbox only if he logs on to this mailbox using the format User ID-newbox.
   - Deliver the message and copy it to an additional mailbox. Select Copy to deliver the message to its intended recipient, as well as copy it to an additional mailbox that you specify in the Destination text box.
   - Send the message to an address. Select Forward the message to, then in the Destination text box enter the e-mail address to which messages meeting the rule criteria will be sent. You must enter a full e-mail address, such as Fred@domain1.com.
   - Return the message to the sender. Select Bounce to send the message back to the sender without being processed.
   - Select Delete to discard the message.
6. Click Add Condition. The condition is added to the rule and is displayed in the Rules text box. If this is the only condition you want the rule to have, click Finish, and the rule will be activated. If you want to add multiple conditions, see Adding Multiple Conditions to Rules.

Entering a Search String

Enter a search string by doing one or more of the following:

- Enter the literal text (up to 255 characters) that you want to search for. For example, if you want to find the word jazz, type: jazz.

- Type search expressions and quantifiers (up to 255 characters) as shown in the Text Patterns tables below.

- Paste a portion of a mail message that meets your intended search criteria. For instance, you could copy and paste text such as XMSMailPriority(High) from the header of a message; this would search for High priority messages.

- Check "Search string from file" if you have placed the search text in a text file. The listbox shows a list of the existing rules files.

Text Pattern | Expression
Any character | .
Any of the values separated by vertical bars within the parentheses | (this|that|other)
Any word character (a-z, A-Z, 0-9) | \w
Any non-word character | \W
Any digit (0-9) | \d
Any non-digit | \D
Any white space (spaces and/or tabs and/or carriage returns) | \s
Any non-white space | \S
Any punctuation character (any character other than \w or \s) | \p
Any non-punctuation character | \P

Quantifier | Expression
Zero or more | *
One or more | +
Exactly 100 | {100}
At least n1, but not more than n2 (where n1 and n2 are numbers) | {n1,n2}

Note: The following characters have special meaning in a rule:

{}()|*+,.:

If you want to use one of these characters in a search string, precede it with a backslash. For example, to search for a plus sign, enter \+ in the search string.

Related Topics

Modifying Domain Rules