Use the RetryLimit statement to set the limits that Communications Server SMTP (CSSMTP) uses when attempting to resend mail messages that are not immediately deliverable. See the information about common terms in z/OS Communications Server: IP Configuration Guide for description.
- CSSMTP uses the setting on the Interval parameter of the ExtendedRetry statement to determine whether the mail message is eligible for extended retry. If the mail message is eligible, CSSMTP sends it for extended retry processing. If the mail message is not eligible for extended retry, the message goes immediately to the undeliverable process as specified by the UNDELIVERABLE statement.
- CSSMTP uses the setting in the ReturnToMailFrom parameter in the UNDELIVERABLE statement to determine its next action when there is information regarding the mail sender's address.
- CSSMTP attempts to send the undeliverable mail notifications to the originator of the mail message, through the configured target servers. If the notification cannot be sent on the first try, it becomes a dead letter (see UNDELIVERABLE statement). No retries are made.
See ExtendedRetry statement for a description of the actions that you need to take when a mail message is eligible for extended retry processing.
Syntax
>>-RetryLimit--| Put Braces and Parameters on Separate Lines |->< Put Braces and Parameters on Separate Lines |--+-{-------------------------+--------------------------------| +-| RetryLimit Parameters |-+ '-}-------------------------' RetryLimit Parameters .-Count 5------. .-Interval 1-------. |--+--------------+--+------------------+-----------------------| '-Count number-' '-Interval minutes-'
Parameters
- Count number
- Indicates the number of times CSSMTP attempts to resend mail. Valid values are in the range 0 - 120. The default is 5.
- Interval minutes
- Indicates the amount of time, in minutes, that CSSMTP waits before
attempting to resend mail. Valid values are in the range 0 - 120.
The default value is 1.
If the Count or Interval value is zero, then no long retry is performed, and mail becomes undeliverable if it cannot be delivered to the target servers on the first try.
Restriction: The total configured time cannot exceed 5 days (7200 minutes in total). For example, 120 retries with 60 minutes per retry results in a maximum time of 5 days.
Tip: During this time, the spool file remains in use. A high configured time total can result in excess spool and storage usage. You can use the MODIFY FLUSHRETRY,TKID= command to force mail messages off the retry queue earlier than the configured time allowed in the RetryLimit statement. If you do, the values in the RetryLimit statement are no longer used for these mail messages. If the mail messages cannot be sent, then the mail messages become undeliverable messages.