SMTP MISSING IPMAILERADDRESS ALL SUPPORT
SMTP MISSING IPMAILERADDRESS ALL SUPPORT
APAR Identifier ...... PK07003 Last Changed ........ 06/10/25
SMTP MISSING IPMAILERADDRESS ALL SUPPORT
Symptom ...... IN INCORROUT Status ........... CLOSED PER
Severity ................... 3 Date Closed ......... 06/03/23
Component .......... 5735FAL00 Duplicate of ........
Reported Release ......... 510 Fixed Release ............ 999
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 510 : UK13027 available 06/03/27 (0601 )
Release 520 : UK13028 available 06/03/27 (0602 )
Parent APAR:
Child APAR list:
ERROR DESCRIPTION:
SMTP needs to provide a method for having all non-local mail
(mail that is destined for a recipient that is not on the same
host as the SMTP server) directly forwarded to another mailer.
The IPMAILERADDRESS statement should support an ALL parameter to
allow for this, as it does in z/OS.
LOCAL FIX:
PROBLEM SUMMARY:
****************************************************************
* USERS AFFECTED: ALL USERS THAT CONFIGURE THE Z/VM TCP/IP *
* SMTP SERVER USING THE IPMAILERADDRESS *
* CONFIGURATION STATEMENT *
****************************************************************
* PROBLEM DESCRIPTION: *
****************************************************************
* RECOMMENDATION: APPLY PTF *
****************************************************************
SMTP needs to provide a method for having all non-local mail
(mail that is destined for a recipient that is not on the same
host as the SMTP server) directly forwarded to another mailer.
The IPMAILERADDRESS statement should support an ALL parameter
to allow for this, as it does in z/OS.
PROBLEM CONCLUSION:
Updated the IPMAILERADDRESS statement to support an ALL option.
The configuration file parsing code in SMTP PASCAL that parses
the IPMAILERADDRESS statement was updated to support the ALL
option as well as to now allow a hostname to be specified
instead of having to specify the dotted decimal IP address of
the IP mailer. This hostname is resolved to an IP address by
calling GetIPAddr. When the ALL option is specified on the
IPMAILERADDRESS statement, a new global flag (that was added in
SMTPGLOB COPY) is set to indicate such. SMTP resolver code in
SMTPRES PASCAL was updated to check for this new flag and to
cause mail destined for domains that are not the local host to
be sent directly to the IP mailer instead of attempting to
resolve the hostname.
Below is the updated documentation for the IPMAILERADDRESS
statement that is in Chapter 20 (Configuring the SMTP Server)
of the TCP/IP Planning and Customization manual (SC24-6125-01)
under the SMTP Server Configuration File Statements section,
as well as the documentation for the two new messages that will
be added to Chapter 16 (SMTP Messages) of the TCP/IP Messages
and Codes manual (GC24-6124-01).
===============================================================
>-IPMAILERADDRESS-+-----+-+-+-ip_address-+-------------------+>
| | | | | |
'-ALL-' | '-hostname---' |
| |
'---------' |
| .----------------. |
| | | |
| v | |
'-LIST---+-ip_address-+-+-ENDIPMAILERADDRESS-'
| |
'-hostname---'
Operands:
---------
ALL - this operand indicates that SMTP should direct all
non-local mail to the specified IP address or hostname.
When this option is configured, the SMTP server will
not attempt to resolve recipient host names on any mail
that is being processed by the server. If the recipient
host name is anything other than the local host, the
mail will be sent to the host specified on the
IPMAILERADDRESS statement (whether the mail was generated
on the local host and is going out, or the mail came into
the server from the outside and is being forwarded).
ip_address - the dotted-decimal internet address of the host
to which SMTP is to direct mail when it cannot
resolve a mail recipient address. If the ALL
operand is specified, all non-local mail will be
directed to this host.
hostname - the hostname to which SMTP is to direct mail when
it cannot resolve a mail recipient address. If the
ALL operand is specified, all non-local mail will be
directed to this host.
LIST - indicates that a list of IP addresses or hostnames will
be given to which SMTP will direct a piece of mail when
it cannot resolve a mail recipient address. SMTP will
attempt to direct the mail to the first IP address or
hostname in the list. If unable to connect to that
host, SMTP will proceed through the list sequentially
until the mail is redirected or the list is exhausted.
================================================================
DTCSMT1271E Unable to resolve hostname <hostname> that was
specified on the IPMAILERADDRESS statement.
Severity: Error
Explanation: The IPMAILERADDRESS statement specified a hostname
that cannot be resolved.
System Action: The SMTP server is halted until the problem
is corrected.
System Programmer Response: Verify the hostname that was
specified on the IPMAILERADDRESS
statement and correct the statement
as necessary.
Source File: SMTPRES PASCAL
================================================================
DTCSMT1272E The IPMAILERADDRESS statement in the SMTP
configuration file did not contain any valid
IP mailer addresses or hostnames.
Severity: Error
Explanation: An IPMAILERADDRESS statement was specified, but
it did not contain any valid IP addresses or
hostnames.
System Action: The SMTP server is halted until the problem
is corrected.
System Programmer Response: Verify the IP mailer addresses
or hostnames that are specified
on the IPMAILERADDRESS statement
and correct the statement as
necessary.
Source File: SMTPRES PASCAL
================================================================
TEMPORARY FIX:
COMMENTS:
MODULES/MACROS: ALLMACRO MSSMTP SMTP SMTPARSE SMTPBTCH
SMTPCMDS SMTPEVNT SMTPGLOB SMTPINTR SMTPNAME SMTPQUEU SMTPRES
SMTPROFS SMTPRPLY SMTPRULE SMTPSEC SMTPSMSG SMTPUTIL SMTPVUID
SMTP822
SRLS: SC24612501 GC24612401
RTN CODES:
CIRCUMVENTION:
MESSAGE TO SUBMITTER: