Setting default values for notification e-mail properties
You can set properties in acserverconfig.xml, the shared configuration file, to:
Limit notification e-mail size and number of recipients
Specify text to use in the To: line of a notification e-mail if the To: line is empty
Configuring limits on notification e-mail size and number of recipients
Set values for the following properties to limit notification size and number of e-mail recipients:
MaxMailMessageSize
Specifies the maximum size a notification e-mail can be, in kilobytes. The permissible range is 100 through 1048576. The default value is 5120. If the combined size of the e-mail message text and attachment exceeds the specified value, BIRT iHub does not send the e-mail. The diagnostic log in AC_SERVER_HOME\data\server\log contains a record for a failed e-mail notification attempt.
MaxMailRecipients
Specifies the maximum number of e-mail addresses to which iHub can address a single e-mail message. If the number of e-mail recipients exceeds the value of this property, BIRT iHub divides the list into smaller lists and sends the same e-mail message to each of the smaller lists. The permissible range is 100 through 100000. The default value is 10000.
Creating a dummy To: line for a notification e-mail
Set values for the following properties to specify whether BIRT iHub uses text you specify in an empty notification e-mail To: line, and to specify the text itself:
UseDummyToLine
Indicates whether to use the value of the DummyToLine property in the To: line of a notification e-mail. Possible values are True or False.
DummyToLine
Specifies the text to use in the To: line of a notification e-mail if the To: line is empty.
How to set e-mail notification properties in acserverconfig.xml
1 Stop iHub processes. For information on stopping and starting iHub processes for a cluster or for a standalone iHub installation, see Stopping and starting iHub processes. Wait until all services have stopped before going to the next step.
2 Open AC_CONFIG_HOME\acserverconfig.xml, using a text editor.
3 Add the e-mail notification properties you want to use to the <System> element, as shown in Listing 4‑3.
4 Start iHub processes. For information on stopping and starting iHub processes for a cluster or for a standalone iHub installation, see Stopping and starting iHub processes.