Additional diagnostic aids

In addition to debugging switches, you can use the following z/OS UNIX sendmail diagnostic aids:
  • syslog.log provides more information. The following sample shows a z/OS UNIX sendmail syslog.log message:
    Dec 28 02:13:30 MVS186 sendmail[67108947]: EZZ7514I: sendmail starting
    .
    .
    Dec 28 02:13:30 MVS186 sendmail[67108947]: starting daemon (8.12.1): SMTP
    For descriptions of sendmail messages, see z/OS Communications Server: IP Messages Volume 4 (EZZ, SNM).
  • Use the -v (verbose) command-line switch to print a complete description of all the steps required to deliver a mail message. For details, see sendmail, 3rd Edition.
  • Use the -X (trace log) command-line switch to record all input, output, SMTP traffic, and other significant transactions into the specified trace file. For details, see sendmail, 3rd Edition.
  • Check the qf file for queueing concerns. z/OS UNIX sendmail stores undeliverable messages in the QueueDirectory that is specified in the configuration file. The QueueDirectory contains data files (df files) named dfxxxxxxxx and matching queue-control files (qf files) named qfxxxxxxxx. A df file contains the body of a queued message. A qf file holds all the information that is needed to deliver the message. Each queued message has a corresponding df and qf file.

    The qf file is line-oriented, containing one item of information per line. The single uppercase character (the code letter) specifies the contents of the line. The complete list of qf code letters is shown in Table 1.

Table 1. qf File code letters
Code Reference Meaning How Many
A Bat book 11.11.1 AUTH=parameter At most, one
B Bat book 11.11.2 Message body type At most, one
C Bat book 11.11.3 Set controlling user At most, one per R line
d Bat book 11.11.4 Data file directory Exactly one
D Bat book 11.11.5 Data file name Exactly one
E Bat book 11.11.6 Send errors to Many
F Bat book 11.11.7 Save flagged bits Exactly one
H Bat book 11.11.8 Header line Many
I Bat book 11.11.9 Mode and device information for the df file Exactly one
K Bat book 11.1.10 Time last processed Exactly one
M Bat book 11.11.11 Message (why Manyqueued) At most one
N Bat book 11.11.12 Number times tried At most, one
P Bat book 11.11.13 Priority (current) At most, one
Q Bat book 11.11.14 The DSN ORCPT address At most, one per R ine
r Bat book 11.11.15 Final recipient At most, one
R Bat book 11.11.16 Recipient address Many
S Bat book 11.11.17 Sender address Exactly one
T Bat book 11.11.18 Time created Exactly one
V Bat book 11.11.19 Version Exactly one
Z Bat book 11.11.20 DSN envelope ID At most, one
! Bat book 11.11.21 Delivery by specification At most, one
$ Bat book 11.11.22 Restore macro value At most, one
. Bat book 11.11.23 End of qf file Exactly one

Bat book refers to sendmail by O'Reilly & Associates, Inc. (1-56592-839-3). Op refers to Sendmail Installation and Operation Guide that is shipped in /usr/lpp/tcpip/samples/sendmail/sendmail.ps.