APAR Information
SMTP SourceRoute Configuration Support - V2R4
APAR Identifier ...... PQ21487 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 ......... 240 Fixed Release ............ 320
Component Name TCP/IP V2 FOR V Special Notice
Current Target Date .. Flags
SCP ...................
Platform ............
Status Detail: SHIPMENT - Packaged solution is available for
shipment.
PE PTF List:
PTF List:
Release 240 : UQ27422 available 99/03/08 (1000 )
Parent APAR:
Child APAR list: PQ24183
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 was originally added
by APAR PQ04382. For details about the support provided by
APAR PQ04382 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.
MODULES/MACROS: MSSMTP SMTP SMTPCMDS SMTPRES
SRLS: SC31608203