Implementation Guide for Oracle Self-Service E-Billing > Using and Customizing Email Notifications >
Configuring an Email Host and Other Messaging Properties
You must configure the properties that control email message delivery for your organization to specify the name of your email host and an SMTP host as part of the installation process. For details about setting these properties, see Installation Guide for Oracle Self-Service E-Billing. You can also configure the following optional email-specific properties as well:
- Global notification settings. Settings for each notification type, which indicate whether to send or suppress the notification type globally (to all applicable users) or to allow individual users to choose whether to receive the email notification.
- Maximum email queue threads. The maximum number of email threads to create when sending email. The default is 10 threads.
- Maximum queue elements per thread. Email messages are sent in batches, by thread. The maximum number of messages that each thread must send in each batch. The default is 30 messages.
- Queue dispatcher sleep period. The time period, in seconds, that the dispatcher must sleep between sending email, to allow other threads to complete sends before removing queued messages. The default is 5 seconds.
- Queue hanging timeout period. The time period, in seconds, that the dispatcher must wait before deciding the email host is not responding and queue messages. The default is 15 seconds.
- Queue storage directory. The directory, located under the
EDX_HOME \config\ directory (or the EDX_HOME\config\ directory on Windows), used to temporarily store undeliverable email. The default value is mailqueue.
To configure an email host and other messaging properties
- Modify the properties in the notification.xma.xml file, which can be found in the
EDX_HOME /xma/config/com/edocs/common/notification directory (or the EDX_HOME \config\notification directory on Windows). In the path, EDX_HOME is the directory where you installed Oracle Self-Service E-Billling.
- To specify global settings for each notification type valid in your edition of Oracle Self-Service E-Billling (Business or Consumer), specify one of the following values under the globalNotificationConfigMap property:
- <property name="globalNotificationConfigMap">
- <map merge="default">
- <!-- Key/value for Bill Ready Notification
Only those settings for notification types valid in your edition are recognized. For information about valid email notification types in the Business Edition, see Email Notification Template Content (Business Edition). For information about valid email notification types in the Consumer Edition, see Email Notification Template Content (Consumer Edition).
- To update any of the following email notification properties, specify the value under the corresponding property in the notification.xma.xml file:
Email Notification Property Function |
Property Name in the notification.xma.xml File |
Maximum email queue threads |
mailQueueThreadMax |
Maximum queue elements per thread |
mailQueueElementsPerThread |
Queue dispatcher sleep period |
mailQueueDispatcherSleepPeriod |
Queue hanging timeout period |
mailQueueHangingTimeout |
Queue storage directory |
mailQueueStorageDirectory |
|