Delivery service advanced settings

This section describes advanced settings for the delivery service.

dls.connection.pool.force.clean

Forces the cleanup of SMTP transport connections. This avoids the need to call the close() method, causing sockets to wait. Instead, variables are just set to null.

Data type:
Boolean
Default:
false

Set to true to force a cleanup.

Tip: After you apply changes, set to true to test the setting.

dls.connection.pool.used

Specifies whether the DLS Transport connection pool is used.

Data type:
Boolean
Default:
true

Set to true to use the connection pool.

Tip: Set to false so that the connection pool is not used. The result is that each email causes DLS to open a new SMTP transport connection with the email server. This can be helpful if mail server sockets are dropped after each use.

dls.max.output.size.bytes

Specifies the maximum size of a report output, in bytes, that the delivery service will allow.

Data type:
Integer
Default:
Unlimited
Tip: HTML outputs are compressed while in transit. HTML outputs sent to disk via archiving, for example, can be significantly larger than the size limit specified.

emf.archive.filetimestamp.enabled

Forces timestamp on archived files.

Data type:
Boolean
Default:
true

enable.tide.metrics.smtpqueue

Enables the collection and display of the metrics for the delivery service in the IBM Cognos Administration Console.

The following metrics are tracked:

  • Time in queue high water mark
  • Time in queue low water mark
  • Time in queue
  • Number of queue requests
  • Queue length high water mark
  • Queue length low water mark
Data type:
Boolean
Default:
false

max.smtp.connections

Specifies the maximum number of SMTP connections.

This setting limits the number of threads that the delivery service can spawn to send messages.

Valid settings are integers greater than or equal to 1.

Data type:
Integer
Default:
10
Tip: You must restart the service for this setting to take effect.

primary.wait.dls

Specifies the primary wait threshold, in seconds, for the delivery service.

This setting is used if a value is not set in a request.

If the setting is less than 0, it is ignored. If the setting is 0, the client will wait indefinitely.

Data type:
Integer
Default:
120

smtp.reconnection.delay

Specifies the time interval, in seconds, before an attempt to reconnect with an SMTP server is made.

Data type:
Default:
10
Tip: You must restart the service for this setting to take effect.