Troubleshooting Email Problems in Enterprise

BRMS uses TCP/IP SMTP to send emails so it must be configured correctly by the user or Enterprise email functions will not work properly. For more information regarding SMTP configuration, see the following document:

• Simple Mail Transfer Protocol on IBM i topic from the IBM i documentation website

TCP/IP SMTP requires a system directory entry for a user to send an email. Since scheduled Report Definitions run in a BRMS job under user QBRMS, BRMS will automatically add a directory entry for QBRMS if one does not exist. If a Report Definition is run manually using the ‘Run report’ action, the user running the report must have a directory entry defined to work with SMTP. For more information, see the Work with Directory Entries (WRKDIRE) command.

Verify SMTP is functioning correctly

Since Enterprise email functions use SMTP it is important to verify SMTP is functioning properly on the Hub before diagnosing an email problem in Enterprise.  If SMTP is not configured correctly or is not active on the Hub then Enterprise email functions will not work properly.  To verify SMTP is working correctly, run the following command on the Hub and ensure the recipient receives the email:

SNDSMTPEMM RCP((userid@my.company.com)) SUBJECT('SMTP test') NOTE('SMTP test')

Problems with email content 

    emails contain unformatted data
    text is split into multiple emails
    report attachments sent in multiple emails   
    report attachments missing from emails

If emails are each getting split into multiple emails that contain random unformatted MIME data, increase the POP server 'Message split size' attribute to a larger size or to no maximum:

CHGPOPA MSGSPLIT(*NOMAX)

-OR-

CHGPOPA MSGSPLIT(2048)

The SMTP server can be started automatically when TCP/IP is started by setting the following SMTP attribute:

CHGSMTPA AUTOSTART(*YES)