IBM Support

Mustgather traces Needed to Debug SMTP and MSF When E-Mail Fails

Troubleshooting


Problem

This document provides information needed for e-mail issues.

Resolving The Problem

This document provides information needed for e-mail issues.
 
Important Note: In order to debug e-mail issues, an SMTP trace is needed. When using SNDDST to send the mail, an MSF dump may also be needed.

For issues with sending email from the IBM i use the following trace commands.
Step 1.
End SMTP if started.

ENDTCPSVR *SMTP
CHGSMTPA JOURNAL(*YES)
Step 2.
To start the SMTP Flight Recorders for Outbound Mail, on the operating system command line type the following:

TRCTCPAPP APP(*SMTPCLT) 

Press the Enter key.

Start SMTP with the following commands:

STRTCPSVR *SMTP
Step 3.
Run the test scenario causing the issue.
Step 4. To stop the SMTP Flight Recorders for Outbound Mail, on the operating system command line type the following:

TRCTCPAPP APP(*SMTPCLT) SET(*OFF) TITLE('Outbound E-mail')

Press the Enter key.
 
Step 5. On the operating system command line, type the following:

WRKSPLF

Press the Enter key. One or more spooled files is generated that contain the needed traces.
For issues with receiving email from the IBM i use the following trace commands.
Step 1.
End SMTP if started.

ENDTCPSVR *SMTP
CHGSMTPA JOURNAL(*YES)
Step 2.
To start the SMTP Flight Recorders for Outbound Mail, on the operating system command line type the following:

TRCTCPAPP APP(*SMTPSVR) 

Press the Enter key.

Start SMTP with the following commands:

STRTCPSVR *SMTP
Step 3.
Run the test scenario causing the issue.
Step 4. To stop the SMTP Flight Recorders for Outbound Mail, on the operating system command line type the following:

TRCTCPAPP APP(*SMTPSVR) SET(*OFF) TITLE('Inbound E-mail')

Press the Enter key.
 
Step 5. On the operating system command line, type the following:

WRKSPLF

Press the Enter key. One or more spooled files is generated that contain the needed traces.
If you are having difficulties with the SNDDST command, an MSF dump is needed if MSF is not handing the mail off to SMTP. The following steps will get the MSF dump for debug.
Step 1. On the operating system command line, type the following:

CALL QCMD

Press the Enter key.

Note: This starts the Command Line Screen. To exit the Command Line Screen, Press the F12 function key. On the operating system command line, type the following:

ADDEXITPGM EXITPNT(QIBM_QZMFMSF_ACT)
FORMAT(MSFF0100) PGMNBR(200)
PGM(QSYS/QZMFDUMP) TEXT('MSF Snap-in')
PGMDTA(*JOB 12 SPCL01009999)

Press the Enter key.
Step 2. On the operating system command line, type the following:

ENDMSF

Press the Enter key.
Step 3. On the operating system command line, type the following:

STRMSF *RESET

Press the Enter key.
Step 4. Run the test scenario causing the issue.
Step 5. Remove the MSF Snap-in.
Step 5a. On the operating system command line, type the following:

WRKREGINF QIBM_QZMFMSF*

Press the Enter key.
Step 5b. Select:

8 QIBM_QZMFMSF_ACT

Press the Enter key.
Step 5c. Select:

4 200 QZMFDUMP QSYS

Press the Enter key.
Step 5d. On the operating system command line, type the following:

ENDMSF

Press the Enter key.
Step 5e. On the operating system command line, type the following:

STRMSF *RESET

Example: WRKSPLF SELECT(QMSF)

Press the Enter key. Look for spooled file QPSRVDMP.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CHfAAM","label":"Email and SMTP"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;7.5.0"},{"Product":{"code":"SSC5L9","label":"IBM i 7.2 Preventative Service Planning"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}},{"Product":{"code":"SSC52E","label":"IBM i 7.1 Preventative Service Planning"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}},{"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":""}}]

Historical Number

542565415

Document Information

Modified date:
10 January 2023

UID

nas8N1012636