Hit enter to search

A screen a story – time to update the settings of your IBM i SMTP server

Author Avatar
Rudi van Helvoirt

If you have not yet abandoned using QDLS, now is a good time to do so. Please read the full article for a hands-on approach on how to update your settings.Let us face it QDLS is something of the past, back from the days when the Integrated File System (IFS) had not seen the light of day. If you have not yet abandoned using QDLS now is a good time to do so. I will not go into details, but knowing that OfficeVision and QDLS are deeply connected, you will understand that it is time to move on. By moving on I mean using the IFS, QDLS seems just another directory, right? All QDLS data is stored in libraries named QDOC*, for more details please have a look at this link.

Hang on, but what has this to do with the SMTP server settings? The *SDD value for the SMTP server in the screen below refers to the “System Distribution Directory”. In an entry you can specify if Document Library Objects are owned the user of the group profile. The command ADDDIRE has to be used to add a user, in order to enable a user to send mail. The only problem I have with this is the limited logging when mail is not being delivered.

 Pic 1

So please be aware of the fact that to enable logging of what is going on with the *SDD setting is to “Enable journal entries”. When using the command DSPJRN QZMF the journal entries of the SMTP server can be viewed. Over the years I have seen to many mail problems, so I have learned to watch for entries like the one below:

 Pic 2

This above entry is proof that the mail is delivered at the mentioned IP address.

As an alternative you can use IBM i Access Client Solutions => Schemas => QUSRSYS => Journals => QZMF => View Entries... to get something similar to this:


When investigating SMTP I prefer to use the value “*SMTP” the e-mail directory type, instead of *SDD. I use this value in combination with parameter KEEPUNTIL:

Keep until (KEEPUNTIL)

Specifies the length of time to retain e-mail tracking information. For backwards compatibility this will only be valid when the DIRTYPE parameter is set to *SMTP or *SMTPMSF.


The KEEPUNTIL previously set does not change; otherwise, *DFT is used.


The SMTP server will not retain any e-mail tracking information after the e-mail has been put into a final state.


Specify the maximum number of seconds to retain e-mail tracking information after the e-mail has been put into a final state.

Setting it to the maximum value will allow you to keep a little over 14 days of mail logging details. When you want to view what happened you need to run the command WRKSMTPEMM, which will show something like this:


Using option 8 will result in:


For obvious reasons I have blurred some text, but I think you see my point why the SMTP server also needs an upgrade and needs to move away from the old *SDD setting. If the work of moving from the WRKDIRE entry causes you a headache, please be aware of the command STRIMPSMTP. This command will help you with the migration to *SMTP.

If you are not convinced yet, maybe the comment below from IBM support will:

“*SDD is quite old SMTP mode. It has its own limitations and has been replaced by *SMTP mode. The Mail router usage has actually been deprecated in RFC 2821 though it is still working in *SDD mode. However, in *SMTP mode, you can use "Forwarding mail-hub server" to do the similar functions. “

The last thing I would like to mention is that IBM has recommended PTFs for the SMTP server, which can be found here: https://www.ibm.com/support/pages/ibm-i-support-recommended-fixes

Below an image example of how this looks when selecting a recommended PTF for the SMTP server:


As you can see, the PTF SI73026 has been replaced by SI74858 which is dated 21 November 2021. So if you do have issues with your SMTP first bring it up-to-date with PTFs.

Just to give you some background, SNDDST and SNDSMTPEMM can be used next to each other and they both can send mail. Also here SNDDST is something of the past, it does the job. The mail you get as a result from it, looks old if you ask me. It is more an AS/400 look and feel. While the SNDSMTPEMM command allows you to use HTML which is more an IBM i look and feel. Adding an attachement is the big difference here, SNDDST allows you to add a document from QDLS, while SNDSMTPEMM allows you to add a file from the IFS.

I do hope that after reading this article you agree that application modernization does not stop there, after all the SMTP itself is also an application and now you know there is room for modernization there too.

New call-to-action

Current job openings

We are constantly looking for new colleagues!

If you share our values and you're looking for a challenging job in Belgium's Best Workplace, visit our website.

Apply now

Get our top stories in your inbox every month

Follow us


Share this article