EmailRelay <DeliveryMode> XML block

The EmailRelay <DeliveryMode> XML block contains attributes that tell the HCL Compass EmailRelay server either to run in PostOffice Relay mode or SMTP Relay mode. The block contains one of two tags, but not both.

If you are running PostOffice Relay mode, the <DeliveryMode> XML block contains this code:

<DeliveryMode>
    <postoffice batch="250" delay="60"/>"
</DeliveryMode>

If you are running SMTP Relay mode, the <DeliveryMode> XML block contains this code:

<DeliveryMode>
    <smtprelay port="36001" threads="120"/>"
</DeliveryMode>

Table 1. PostOffice Relay mode XML block attributes
Attribute name	Description
batch	Contains an integer larger than 0. This value specifies the number of EmailPlus email records to process in one batch. The default value is `250`. EmailRelay will process 250 emails before it sleeps. If there are more than 250 email records, the records will be processed on the next wake event, which is the value of the `delay` attribute.
delay	Contains an integer larger than -1. This value specifies how long to wait before processing the next batch of EmailPlus email records. By default, EmailRelay polls the HCL Compass Web server every 60 seconds for new EmailPlus email records. If you want email to be sent more frequently, decrease the delay value. However, the more frequently that EmailRelay polls the HCL Compass Web server, the higher the load on HCL Compass Web server and the EmailRelay service.

Table 2. SMTP Relay mode XML block attributes
Attribute name	Description
port	Contains an integer larger than 0. This value is the port that EmailPlus accepts connections from the EmailPlus package to send email. The default value is `36001`. Important: The value of this attribute must match the port value that is used in EmailPlusSiteConfig record type.
threads	Contains an integer larger than 0. This value tells EmailRelay how many threads to have in stand-by to accept connections. The larger the value, the more concurrent connections EmailRelay allows. The default value is `120`. A value -1 means that there is no limit to the number of threads that are created. The limit will be based on your operating system resources, such as memory and handles. And, all connection requests are processed immediately. If all 120 threads are being used, additional connection requests are queued until a thread is free.