Syntax
>>-UNDELIVERABLE--| Put Braces and Parameters on Separate Lines |-><
Put Braces and Parameters on Separate Lines
|--+-{----------------------------+-----------------------------|
+-| UNDELIVERABLE Parameters |-+
'-}----------------------------'
UNDELIVERABLE Parameters
.-DeadLetterAction Store--------.
|--+-------------------------------+---------------------------->
'-DeadLetterAction --+-Store--+-'
'-Delete-'
.-ReturnToMailFrom Yes-------.
>--+----------------------------+------------------------------->
'-ReturnToMailFrom --+-Yes-+-'
'-No--'
.-DeadLetterDirectory /var/cssmtp/extwrtName/deadletter/-.
>--+--------------------------------------------------------+---|
'-DeadLetterDirectory zOS_UNIX _directory_name-----------'
Parameters
- DeadLetterAction
- Indicates to CSSMTP the action to take when a dead letter is detected.
A dead letter is an undeliverable mail notification that cannot be
returned to the original sender or that an error report, if requested,
could not be delivered to the mail administrators. This can occur
if the MAIL FROM: value is null in the original spool file and it
cannot be sent. See the information about common
terms in z/OS Communications Server: IP Configuration
Guide for a description of dead letter.
- Delete
- Indicates that CSSMTP should not save the dead letter to a z/OS® UNIX file
system. If this option is chosen then it is recommended that you use
the report statement. See the Sysout parameter in REPORT statement for information
about recording original spool problems.
- Store
- Indicates that CSSMTP should store the mail message to the directory
defined in the DeadLetterDirectory parameter. Each dead letter is
stored as a separate file within the dead letter directory.
- DeadLetterDirectory
- The z/OS UNIX file system fully qualified directory name
where CSSMTP creates the dead letter mail message that is stored when
the DeadLetterAction parameter is set to Store. Valid values are
1 - 512 characters in length and must begin with a slash (/) to define
the fully qualified directory. The default dead letter directory
is /var/cssmtp/extWrtName/deadletter, where
the extWrtName is the name used for ExtWrtName.
See the information about common terms in z/OS Communications Server: IP Configuration
Guide for a description of a dead letter.
Result: An
ending slash (/) is added to the directory name if not configured.
- ReturnToMailFrom
- Indicates whether CSSMTP should create an undeliverable mail notification
to be returned to the originator. The undeliverable mail notification
contains the original mail message as well as additional information
indicating the reason for the failure. This parameter does not apply
to original mail messages that do not have the originator specified
on the MAIL FROM SMTP command (for example, MAIL FROM:<>). In
this case, if the original mail message cannot be sent, it immediately
becomes a dead letter.
- YES
- CSSMTP creates the undeliverable mail notification to be returned
to the originator with additional information regarding the reason
for the failure.
Result: If the original spool file contains
no errors other than undeliverable errors, the spool file is deleted.
- NO
- CSSMTP does not create the undeliverable mail notification to
be returned to the originator. If you specify this parameter, you
should use the REPORT statement with a value of sysout or admin..
See REPORT statement for
information about how to create a report that the original mail message
is undeliverable.
The action taken on the original spool file that
contained undeliverable errors is based on the value configured on
the BadSpoolDisp statement. See BadSpoolDisp statement for details.
For a description of the undeliverable status,
see the information about mail problems in z/OS Communications Server: IP Configuration
Guide.
Results: - If DeadLetterAction is set to Store: