APAR Information
SMTP SourceRoute Configuration Support - FL310
APAR Identifier ...... PQ24183 Last Changed ........ 99/08/03
ADD SMTP CONFIGURATION SUPPORT TO PREVENT GENERATION OF SOURCE
ROUTE RECORDS IN RETURN PATH INFORMATION
Symptom ...... IN INCORROUT Status ........... CLOSED UR1
Severity ................... 4 Date Closed ......... 99/03/04
Component .......... 5735FAL00 Duplicate of ........
Reported Release ......... 310 Fixed Release ............ 320
Component Name TCP/IP V2 FOR V Special Notice
Current Target Date .. Flags
SCP ................... VM
Platform ............ VM
Status Detail: SHIPMENT - Packaged solution is available for
shipment.
PE PTF List:
PTF List:
Release 310 : UQ27423 available 99/03/08 (9902 )
Parent APAR: PQ21487
Child APAR list:
ERROR DESCRIPTION:
Mail destined for some remote mailers cannot be delivered
because the remote mailer will not accept the note if it
included source-route format return path information. Some
mailers can be configured to disallow the source-route format
return path.
Destination source routes can be controlled with the changes
in APARs PQ14324 for R310 and PQ04382 for R240. This APAR
will add the capability to configure SMTP's use of the
source-route format in return path information (on the MAIL
FROM command of the SMTP protocol). The removal of these source
routes may make the return path unusable. That is potentially a
problem when the originating host is not directly accessible to
any mail transfer agent that must generate error mail to the
originating host.
LOCAL FIX:
PROBLEM SUMMARY:
****************************************************************
* USERS AFFECTED: All VM TCP/IP SMTP Users *
****************************************************************
* PROBLEM DESCRIPTION: Some mail cannot be delivered because *
* it contains source routes in the *
* return path information. *
****************************************************************
* RECOMMENDATION: APPLY PTF *
****************************************************************
Source routes may be present on the MAIL FROM: or RCPT TO:
commands processed by SMTP. The SOURCEROUTES configuration
statement allows customers to specify if SMTP should honor
the source routes received on the RCPT TO: command. Customers
also need the ability to specify if SMTP should honor source
routes received on the MAIL FROM: command.
PROBLEM CONCLUSION:
TEMPORARY FIX:
COMMENTS:
The SOURCEROUTES configuration statement and the SMSG
SOURCEROUTES command were originally added by APAR PQ14324.
For details about the support provided by APAR PQ14324 see the
TCP/IP On-Line Document at :
http://www.ibm.com/s390/vm/related/tcpip/tcp-pubs.html
This APAR modifies the SOURCEROUTES configuration statement
to allow customers to specify which type of source routes will
be honored. The definition of the SOURCEROUTES statement
in the TCP/IP On-Line Document titled "SMTP User Exits Support
(APAR PQ04382)" will no longer be accurate after the
installation of this extended support. The new definition
is as follows:
SOURCEROUTES STATEMENT
----------------------
Purpose
The SOURCEROUTES statement specifies whether the SMTP server
will honor source routes. Source routes may be present on
the MAIL FROM: or RCPT TO: commands processed by SMTP. With
this statement, you may specify which source routes are honored.
A source route is a path that contains a routing list of hosts
and a destination mailbox. The list of hosts is the
route -- information about how the mail is to arrive at its
final destination; the mail is passed from one host in this
list to the next until it is delivered to the intended
recipient.
The specification that follows is an example of a SOURCE ROUTE:
<@HOST1,@HOST2,@HOST3:USER@HOST4>
The list of hosts is HOST1, HOST2 and HOST3, and the
destination is USER@HOST4.
If this sample source route is included with a RCPT TO: command,
and is honored by SMTP, the mail will be sent to HOST1, then to
HOST2, then to HOST3 and finally to USER@HOST4. When source
routes are not honored, mail is sent directly to USER@HOST4;
the list of hosts is ignored.
If this sample source route is included with a MAIL FROM:
command and source routes are honored, SMTP will include its
host name (for example, "VMHOST1") in the path information,
and will supply the following path for its MAIL FROM: command:
<@HOST1,@HOST2,@HOST3,@VMHOST1:USER@HOST4>
If such source routes are not honored, the list of hosts is
removed from the mail routing path. In addition, SMTP will not
add its host name to the path information.
+------------------------------------------------------------+
| |
| .-SOURCEROUTES YES---------------. |
| >>--+--------------------------------+----------------->< |
| | .-RCPTTO---. | |
| '-SOURCEROUTES--+----------+--NO-' |
| |-MAILFROM-| |
| '-BOTH-----' |
| |
+------------------------------------------------------------+
PARAMETER DESCRIPTION
YES Indicates that source routes on the MAIL FROM:
and RCPT TO: commands received from clients will
be honored when mail is forwarded by SMTP. For the
previous sample source route, SMTP will send the
mail to HOST1 for further processing by HOST1.
This is the default.
NO Indicates that source routing is not to be honored
By default, only source routes for the RCPT TO:
command will be ignored. The RCPTTO, MAILFROM or
BOTH parameter can be specified with this parameter
to select specific source routes to be ignored by
SMTP.
NOTE: The NO parameter does not cause mail
containing source routes to be rejected.
RCPTTO Indicates that source routing is not to be honored
for the RCPT TO: command. This is the default
when NO is in effect. For the RCPT TO: command,
any host list will be ignored and only the
destination host will be used. The mail
recipient(s) will not see the host list that was
ignored.
For the previous sample source route, SMTP will
send the mail directly to USER@HOST4; the HOST1,
HOST2 and HOST3 hosts will be ignored.
MAILFROM Indicates that source routing is not to be honored
for the MAIL FROM: command. When this parameter
is used, the list of hosts will be removed from the
mail routing path. In addition, SMTP will not add
its host name to the path information. The mail
recipient(s) will not see the host list that was
ignored.
For the previous sample source route, SMTP will
supply the following MAIL FROM: command when mail
is forwarded:
MAIL FROM: <USER@HOST4>
BOTH Indicates that source routing is not to be honored
for either the RCPT TO: or the MAIL FROM: commands.
Source routing information for these commands will
be ignored as previously described.
SMSG SMTP SOURCEROUTES
----------------------
Purpose
The SOURCEROUTES command is used to specify whether the SMTP
server will honor source routes, and to query the current
SOURCEROUTES setting. For more information about source
routes, see the description of the "SOURCEROUTES statement".
+--------------------------------------------------------------+
| |
|>>-SMSG-server_id--SOURCEroutes--.-.-RCPTTO---.--.-YES-.-.->< |
| | |-MAILFROM-| '-NO--' | |
| | '-BOTH-----' | |
| '-QUERY-----------------' |
| |
+--------------------------------------------------------------+
OPERANDS
server_id
Specifies the user ID of an SMTP server virtual machine.
YES
Indicates that client-supplied source routes on the MAIL
FROM: command, the RCPT TO: command, or both will be
honored when mail is forwarded by SMTP. The RCPTTO,
MAILFROM or BOTH parameter determines the specific source
routes honored by SMTP.
NO
Indicates that client-supplied source routes on the MAIL
FROM: command, the RCPT TO: command, or both are not to be
honored when mail is forwarded by SMTP. The RCPTTO,
MAILFROM or BOTH parameter determines the specific source
routes ignored by SMTP.
NOTE: The NO parameter does not cause mail containing
source routes to be rejected.
RCPTTO
Indicates the processing of source routes supplied with the
RCPT TO: command is to be affected. When this parameter
is used and NO is specified, any host list will be ignored
and only the destination host will be used. The mail
recipient(s) will not see the host list that was ignored.
For the previous sample source route, SMTP will send the
mail directly to USER@HOST4; the HOST1, HOST2 and HOST3
hosts will be ignored.
When used with the YES parameter, source routes will be
honored.
MAILFROM
Indicates the processing of source routes supplied with the
MAIL FROM: command is to be affected. When this parameter
is used and NO is specified, the list of hosts will be
removed from the mail routing path. In addition, SMTP will
not add its host name to the path information. The mail
recipient(s) will not see the host list that was ignored.
For the previous sample source route, SMTP will supply the
following MAIL FROM: command when mail is forwarded:
MAILFROM: <USER@HOST4>
When used with the YES parameter, source routes will be
honored, with the SMTP host name included as part of the
path information.
BOTH
Indicates the handling of source routes supplied for both
the RCPT TO: and the MAIL FROM: commands is to be affected.
Source routing information for these commands will be
processed as previously described.
QUERY
Displays the current SOURCEROUTES setting. The returned
response indicates whether or not source routes will be
honored.
EXAMPLES
o The command that follows will disable source routes for the
RCPT TO: command. Source routes will not be honored and
will be ignored.
SMSG SMTP SOURCEROUTES RCPTTO NO
The following response is displayed:
* From SMTP: RCPTTO SOURCEROUTES is set to NO
MODULES/MACROS: MSSMTP SMTP SMTPCMDS SMTPRES SMTPSMSG
SRLS: SC24584700