max_retry_interval
Name
max_retry_interval — maximum retry interval
Synopsis
Max_Retry_Interval = "43200"
Description
The maximum interval between successive retries for a message. This provides a cap on the effective retry calculated from Retry_Interval
. The default value for this option is 43200
seconds (12 hours).
Warning
Note that the Max_Retries
setting has a bearing on this option. The default value for Max_Retries
is "auto" so be sure to change it to a positive integer or "none" if you plan to use Max_Retry_Interval
. When Max_Retries
is set to a positive integer, messages expire within Messsage_Expiration
seconds or after the specified number of retries, whichever occurs first. When Max_Retries
is "none" there is no limit on the number of retries of a message; the message will expire by Message_Expiration
only.
Consider the following configuration snippet:
Retry_Interval = 1200
Max_Retry_Interval = 1200
Max_Retries = 5
Given this configuration, a bounced message will be retried every 1200 seconds and will expire in 6000 seconds unless Message_Expiration
is set to a value lower than 6000. In which case, the message will expire in Messsage_Expiration
seconds. "Max_Retry_Interval" caps "Retry_Interval" at 1200. Without it a bounced message would expire in 37200 seconds (unless Messsage_Expiration is less than this number) because the retry interval is doubled each time as follows:
1200 2400 4800 9600 19200 ----- 37200
Scope
max_retry_interval is valid in the binding, binding_group, domain and global scopes.