Lotus Domino Administrator 8.5 Help - Customizing the text of mail failure messages

MAIL

Customizing the text of mail failure messages
You can customize the text of messages that IBM® Lotus® Domino® sends when various mail failures occur. The text you specify is added to the default text for the message. Customize messages to provide text in multiple languages or supply users with additional information about how to respond to a failure. For example, add text that provides the phone number to call in case a mail message does not reach your server.

You can enter customized text directly on the Configuration Settings document or create text files for each customized message and then use the Configuration Settings document to specify the location of each file.

1. Make sure you already have a Configuration Settings document for the server(s) to be configured.

2. From the Domino Administrator, click the Configuration tab and expand the Messaging section.

3. Click Configurations.

4. Select the Configuration Settings document for the mail server or servers you want to administer, and click Edit Configuration.

5. Click the Router/SMTP - Advanced - Controls tab.

6. In the Failure Messages section, choose a method for specifying the customized text for failure messages:

Method Description

Text file The Router adds customized text to failure messages from external files. For each condition listed, enter the complete path to a text file that contains customized text you want to add to the default failure message.

Text The Router adds customized text to failure messages from text entered in the Configuration Settings document. For each condition listed, enter the customized text you want to add to the default failure message.

7. Complete these fields, and then click Save & Close:

Field Enter

Transfer failure Transfer failures occur when there is a transient connection failure between the servers -- for example, a network problem.
If you specified Text in Step 6, enter text to add to the default transfer failure message; otherwise specify the path to a file containing the text -- for example, C:\DOMINO\DATA\TRANSFER.TXT.

Delivery failure Delivery failures occur when the server is unable to deliver the message to the recipient's mail file -- for example, if the recipient's mail file has moved and the Domino Directory has not been properly updated.
If you specified Text in Step 6, enter text to add to the default delivery failure message; otherwise specify the path to a file containing the text -- for example, C:\DOMINO\DATA\DELIVER.TXT.

Message expiration Message expiration failures occur when Domino cannot transfer the message to its destination in a given period of time.
If you specified Text in Step 6, enter text to add to the default message expiration notification; otherwise specify the path to a file containing the text -- for example, C:\DOMINO\DATA\EXPIRE.TXT.

Domain failure Domain failures occur when Domino cannot identify the destination domain for a recipient of a message. For example, if you send a message to jdoe@lotus.com and Domino cannot locate lotus.com in either the Domino Directory or the DNS, the server generates a domain failure message.
If you specified Text in Step 6, enter text to add to the default message for domain failures, or specify the path to a file containing the text -- for example, C:\DOMINO\DATA\DOMAIN.TXT.

Server failure Server failures occur when Domino cannot connect to the destination server. For example, if you send a message to jdoe@lotus.com, and DNS instructs you to send mail for the lotus.com domain to mail1.lotus.com but Domino cannot connect to mail1.lotus.com, the sending Domino server generates a server failure message.
If you specified Text in Step 6, enter text to add to the default message for server failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\SERVER.TXT.

Username failure User name failures occur when Domino cannot match the local part of an address to a recipient. For example, if you send a message to jdoe@lotus.com, but Domino cannot find jdoe in the Domino Directory, the server generates a user name failure message.
If you specified Text in Step 6, enter text to add to the default message for user name failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\USER.TXT.

Size failure Size failures occur when Domino rejects a message because its size is greater than the maximum message size (which you can specify in the "Maximum message size" field on the Restrictions and Controls - Restrictions tab of the Server Configuration document) and generates a size failure message.
If you specified Text in Step 6, enter text to add to the default message for size failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\SIZE.TXT.

Restriction failure Restriction failures occur when Domino rejects a message based on outbound Router restrictions. For example, if you send a message to jdoe@lotus.com, but lotus.com is listed in the "Deny messages from the following Internet addresses to be sent to the Internet" field on the Router/SMTP - Restrictions and Controls - SMTP Outbound Controls tab of the Server Configuration document, Domino rejects the message and generates a restriction failure message.
If you specified Text in Step 6, enter text to add to the default message for restriction failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\RESTRICT.TXT.

Delay notification Low-priority routing delays occur when MAIL.BOX receives a message that is marked low priority and the Router waits to process the message until the specified low-priority routing time (12:00 AM to 6:00 AM by default). If low-priority delay notifications are enabled for the message, the Router sends a delay notification to the originator's address.
If you specified Text in Step 6, enter text to add to the default low-priority delay notification; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\DELAY.TXT
Note Domino Release 5.0.x specified this file using the MailTextFileForTransferDelays setting in the server's NOTES.INI file. If this setting is present, it takes precedence over the setting specified here.

Quota warning notification The Router sends Quota warning notifications to users whose mail files exceed their configured quota warning threshold.
If you specified Text in Step 6, enter text to add to the default quota warning notification; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\WARNING.TXT.

Quota error notification The Router sends Quota error notifications to users whose mail files exceed their configured quota.
If you specified Text in Step 6, enter text to add to the default quota error notification; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\QUOTA.TXT.

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

Recalculating the server's routing table

Setting advanced transfer and delivery controls

Customizing message transfer

Setting transfer limits

Restricting mail routing based on message size

Restricting who can send Internet mail to your users

Customizing Notes routing

Setting the message time-out value

Generating delay notifications for deferred low-priority mail

Notifying users who exceed their mail file's quota or warning threshold

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary

Method	Description
Text file	The Router adds customized text to failure messages from external files. For each condition listed, enter the complete path to a text file that contains customized text you want to add to the default failure message.
Text	The Router adds customized text to failure messages from text entered in the Configuration Settings document. For each condition listed, enter the customized text you want to add to the default failure message.

Field	Enter
Transfer failure	Transfer failures occur when there is a transient connection failure between the servers -- for example, a network problem. If you specified Text in Step 6, enter text to add to the default transfer failure message; otherwise specify the path to a file containing the text -- for example, C:\DOMINO\DATA\TRANSFER.TXT.
Delivery failure	Delivery failures occur when the server is unable to deliver the message to the recipient's mail file -- for example, if the recipient's mail file has moved and the Domino Directory has not been properly updated. If you specified Text in Step 6, enter text to add to the default delivery failure message; otherwise specify the path to a file containing the text -- for example, C:\DOMINO\DATA\DELIVER.TXT.
Message expiration	Message expiration failures occur when Domino cannot transfer the message to its destination in a given period of time. If you specified Text in Step 6, enter text to add to the default message expiration notification; otherwise specify the path to a file containing the text -- for example, C:\DOMINO\DATA\EXPIRE.TXT.
Domain failure	Domain failures occur when Domino cannot identify the destination domain for a recipient of a message. For example, if you send a message to jdoe@lotus.com and Domino cannot locate lotus.com in either the Domino Directory or the DNS, the server generates a domain failure message. If you specified Text in Step 6, enter text to add to the default message for domain failures, or specify the path to a file containing the text -- for example, C:\DOMINO\DATA\DOMAIN.TXT.
Server failure	Server failures occur when Domino cannot connect to the destination server. For example, if you send a message to jdoe@lotus.com, and DNS instructs you to send mail for the lotus.com domain to mail1.lotus.com but Domino cannot connect to mail1.lotus.com, the sending Domino server generates a server failure message. If you specified Text in Step 6, enter text to add to the default message for server failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\SERVER.TXT.
Username failure	User name failures occur when Domino cannot match the local part of an address to a recipient. For example, if you send a message to jdoe@lotus.com, but Domino cannot find jdoe in the Domino Directory, the server generates a user name failure message. If you specified Text in Step 6, enter text to add to the default message for user name failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\USER.TXT.
Size failure	Size failures occur when Domino rejects a message because its size is greater than the maximum message size (which you can specify in the "Maximum message size" field on the Restrictions and Controls - Restrictions tab of the Server Configuration document) and generates a size failure message. If you specified Text in Step 6, enter text to add to the default message for size failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\SIZE.TXT.
Restriction failure	Restriction failures occur when Domino rejects a message based on outbound Router restrictions. For example, if you send a message to jdoe@lotus.com, but lotus.com is listed in the "Deny messages from the following Internet addresses to be sent to the Internet" field on the Router/SMTP - Restrictions and Controls - SMTP Outbound Controls tab of the Server Configuration document, Domino rejects the message and generates a restriction failure message. If you specified Text in Step 6, enter text to add to the default message for restriction failures; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\RESTRICT.TXT.
Delay notification	Low-priority routing delays occur when MAIL.BOX receives a message that is marked low priority and the Router waits to process the message until the specified low-priority routing time (12:00 AM to 6:00 AM by default). If low-priority delay notifications are enabled for the message, the Router sends a delay notification to the originator's address. If you specified Text in Step 6, enter text to add to the default low-priority delay notification; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\DELAY.TXT Note Domino Release 5.0.x specified this file using the MailTextFileForTransferDelays setting in the server's NOTES.INI file. If this setting is present, it takes precedence over the setting specified here.
Quota warning notification	The Router sends Quota warning notifications to users whose mail files exceed their configured quota warning threshold. If you specified Text in Step 6, enter text to add to the default quota warning notification; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\WARNING.TXT.
Quota error notification	The Router sends Quota error notifications to users whose mail files exceed their configured quota. If you specified Text in Step 6, enter text to add to the default quota error notification; otherwise, specify the path to a file containing the text -- for example, C:\DOMINO\DATA\QUOTA.TXT.