IBM Support

SMTP New Configuration Checklist, Short Version

Troubleshooting


Problem

This document is intended to identify the basic configuration elements for native SMTP server on the System i.

Resolving The Problem

This document is intended to identify the basic configuration elements for native SMTP server on the System i.

A.Check the domain information:

Issue the CFGTCP command, press Enter, and select Option 12. There must be a host name and a domain name defined. In most cases, Host Name Search Priority should be *Local. Verify that the DNS addresses are correct. In the additional parameters, Port should be 53, Protocol should be *UDP. Retries and Time Interval are typically 2.
B.Check the TCP interfaces:

Issue the CFGTCP command, press Enter, and select Option 1. Make note of each interface and verify that it is active. The 127.0.0.1 interface should be here, and should be active.
C.Check the Host table:

Issue the CFGTCP command, press Enter, and select Option 10. Check for 127.0.0.1 with the names LOOPBACK and LOCALHOST. Check for the IP addresses from the TCP interfaces list. One of them should be listed here with the 'host.domain' name. If a mail router is being used, it must resolve with either the local host table or DNS resolution.
D.Per II13869, verify that Restricted Rename and Unlink is *No for '/tmp':

Issue the WRKLNK '/tmp' command, and press Enter. Select Option 8 on /tmp, and press Enter. Page down two times. "Restricted Rename and Unlink" should be No. If not, change it to *No using the following command:

CHGATR OBJ('/tmp') ATR(*RSTDRNMUNL) VALUE(*NO)

In 61, this is corrected by a PTF SI36382. The informational APAR is just a work-around until the PTF is applied. 71 needs no PTF.
E.Verify the SMTP subdirectories exist and check for old e-mail fragments:

Issue the WRKLNK '/QTCPTMM' command, and press Enter. Select Option 5 on /qtcptmm. There should be the following subdirectories: /ATTABOX, /DSN. /ENCODE, /FTRFILES, /LOCKBOX, /MAIL, /SMTPBOX, /TMP.

Select 2 on /ATTABOX. Check to see if there are old e-mail fragments. If so, remove them. Do the same for /SMTPBOX.
F.Check the POP attributes:

Issue the CHGPOPA command, and press F4 to prompt. The Split Size should be *Nomax. The CCSID should typically be 00819.
G.Check the distribution attributes if you are using the SNDDST command to send mail to an Internet address:

Issue the CHGDSTA command, and press F4 to prompt. Use MSF for Local should be *No. There should be a directory entry listed as the route to SMTP gateway. The most common is INTERNET SMTPRTE.
H. Check the directory entries if you are using SNDDST to send mail to an Internet address:

Issue the WRKDIRE command, and press Enter. There should not be a *ANY/*ANY directory entry. There should not be a *ANY entry with the address of this partition/system.

Select 5 on the directory entry from the distribution attributes (INTERNET SMTPRTE).

Check the first five lines; they should look like the following:

User ID/Address . . . . : INTERNET SMTPRTE
Description . . . . . . : SMTP routing entry
System name/Group . . . : INTERNET
User profile . . . . . :
Network user ID . . . . : INTERNET GATEWAY
On the second to last page, it should look like this:
Locally-defined . . . . : Yes
Indirect user . . . . . : No
Mail service level . . : User index
Preferred address . . . : NETUSRID *IBM
Address type . . . . : ATCONTXT

If you have to create this directory entry, use the command below:
ADDDIRE USRID(INTERNET SMTPRTE) USRD('UserID to send to Internet') USER(*NONE) SYSNAME(INTERNET) PREFADR(NETUSRID *IBM ATCONTXT)
I.Check the SMTP attributes:

Issue the CHGSMTPA command, and press F4 to prompt. On the first page, "Automatic Registration" should be *No. On the second page, if you want to use a Mail Router, it should be the name of the IP address for the mail router, "Firewall" should be *Yes if there is a mail router defined, and "Process all mail through MSF" should be *No. On the fourth page, check for Real Time Black Hole List (this can cause delays in outbound and inbound e-mail), and check the Filter Mail for Virus (this can cause 'lost' e-mail). The Allow Relayed Mail parameter should not be *All. *All is an 'Open Relay' and is a major SPAM exposure. The Allow Relayed Mail parameter should be *None if you will only be using the iSeries to originate the e-mail (no clients sending mail), or *POPWDW if hosting POP3 mail clients, or *List if you want to include specific IP addresses for your clients. On the last page, last parameter, "Forwarding Mailhub Server" should be the same as the mail router from page 2.
J.Verify that the exit point programs are registered for SMTP and QMSF:

Issue the WRKREGINF command, and press Enter. Go down to QIBM_QZMFMSF_*. Compare the registered exit programs for each exit point with a working system if possible. If any are missing, refer to Rochester Support Center knowledgebase document New, How to Register Missing Exit Point Programs Needed by QMSF and SMTP: Database 'DCF Technotes (IBM i)', View 'Products', Document 'How to Register Missing Exit Point Programs Needed by QMSF and SMTP'.
K.Check for bindings:

You can check the bindings by looking at the SMTP properties with iSeries navigator or by using the STRPDM command and pressing Enter, then selecting Option 2 Work with Objects. Use the following information:

Library: QUSRSYS
Object Name: QATMI*
Type: *ALL
Attribute: *ALL

and press Enter.

Select 12 on QATMIFCLST, and press Enter. To check the client binding, select 5 on CLNTBNDIP. To check the server binding, select 5 on SVRBNDIP. To make changes to the bindings, issue the RMVSMTPLE and ADDSMTPLE commands.

Related information
o For information on Authentication and SSL configuration for SMTP, refer to Rochester Support Center knowledgebase document New, Configuring SMTP Authentication: Database 'DCF Technotes (IBM i)', View 'Products', Document 'Configuring SMTP Authentication'.
oFor information on Dual Stack configuration, refer to Rochester Support Center knowledgebase document New, Setting up Dual Stack for SMTP to Run Native and Domino SMTP: Database 'DCF Technotes (IBM i)', View 'Products', Document 'Setting Up Dual Stack for SMTP to Run Native and Domino SMTP'.
oFor information on SMTP and QMSF tracing, refer to Rochester Support Center knowledgebase document New, Traces Needed to Debug SMTP and MSF When E-Mail Fails: Database 'DCF Technotes (IBM i)', View 'Products', Document 'Traces Needed to Debug SMTP and MSF When E-Mail Fails'.
oFor information on Forwarding e-mail, refer to Rochester Support Center knowledgebase document New, Forwarding Internet Mail to Another E-Mail Address: Database 'DCF Technotes (IBM i)', View 'Products', Document 'Forwarding Internet Mail to Another E-Mail Address'.
oFor information on creating a non-delivery mailbox, refer to Rochester Support Center knowledgebase document New, Creating a Nondelivery Mail Box: Database 'DCF Technotes (IBM i)', View 'Products', Document 'Creating a Nondelivery Mail Box'.

Related Information

[{"Product":{"code":"SWG60","label":"IBM i"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"Communications-TCP","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"6.1;6.1.1;7.1;6.1.0;6.1.1;7.1.0","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}},{"Product":{"code":"SSC3X7","label":"IBM i 6.1"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSC52E","label":"IBM i 7.1"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}}]

Historical Number

562865621

Document Information

Modified date:
18 December 2019

UID

nas8N1012245