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: