Resolving problems from the JES spool data set

Table 1. JES spool data set problems
Symptoms	Problem/Cause	Action
EZD1807I with JES NOT AVAILABLE	The CSSMTP application ends with the error during initialization because JES is not available. This is a permanent JES subsystem error during spool file initialization (for example, authentication errors, The CSSMTP application is not allowed to read it, IEFSSREQ failed).	For details and other messages, see the appropriate EZD1807I message in z/OS Communications Server: IP Messages Volume 2 (EZB, EZD).
EZD1813I or EZD1816I A report may be generated to the MailAdministrator, if configured, or to the sysout file (see Figure 1 for an example).	No mail messages in the spool file have been processed, because the entire JES spool file is permanently inaccessible. Possible causes for the error are: There is a spool file allocation error There is a spool file open error This user ID is not permitted to send output to the external writer that is configured to the CSSMTP application. The spool file size is larger than the JesJobSize.	For details and other messages, see the appropriate EZD1813I or EZD1816I message in z/OS Communications Server: IP Messages Volume 2 (EZB, EZD). For details on MailAdministrator and JesJobSize configuration options, see z/OS Communications Server: IP Configuration Reference. For details on JES issues relating to CSSMTP see z/OS Communications Server: IP Configuration Guide.
EZD1813I or EZD1816I A report may be generated to the MailAdministrator, if configured, or to the sysout file (see Figure 1 for an example).	Some of the mail messages in the JES spool file have been processed and sent, but the rest of the JES spool file is permanently inaccessible. Possible causes for the error are: IO error during read Permanent SAPI errors during read Syntax errors from JES spool processing, for example: No valid HELO or EHLO SMTP command There is an incorrect beginning SMTP command for HELO, EHLO, MAIL FROM There is an incorrect ending SMTP command ".", RSET or next HELO or EHLO There are more than JESSyntaxErrLimit invalid SMTP commands, or sequence errors The CSSMTP application security user exit fails with the return code to stop processing the JES file	For details and other messages, see the appropriate EZD1813I or EZD1816I message in z/OS Communications Server: IP Messages Volume 2 (EZB, EZD). For details on MailAdministrator options and user exits see z/OS Communications Server: IP Configuration Reference. For details on JES issues relating to CSSMTP see z/OS Communications Server: IP Configuration Guide. For details on syntax of mail see z/OS Communications Server: IP User's Guide and Commands.
EZD1813I or EZD1816I A report may be generated to the MailAdministrator, if configured, or to the sysout file (see Figure 1 for an example).	Some of the individual mail message in a JES spool file are permanently non-deliverable. Possible causes for errors are: There are non-mail boundary errors, for example: Missing RCPT TO JesMsgSize error The CSSMTP application security exit fails with the return code that causes only individual mail message to fail.	For details and other messages, see the appropriate EZD1813I or EZD1816I message in z/OS Communications Server: IP Messages Volume 2 (EZB, EZD). For details on MailAdministrator options and user exits see z/OS Communications Server: IP Configuration Reference. For details on JES issues relating to CSSMTP see z/OS Communications Server: IP Configuration Guide. For details on syntax of mail see z/OS Communications Server: IP User's Guide and Commands.

Figure 1. Error report example

The following is an error report example to MailAdministrator or to the sysout file.

 [1]                      Error Report for USER1U (JOB00085) 
   
 [2]  Job USER1U  /        /DEST     (JOB00085) created by VIC000.USER1 at Thu, 21 Aug 2008 12:41:24 -0400
 [2]  For DDname: SYSUT2    Dataset name: USER1.USER1U.JOB00085.D0000102.?
 [3]  CSSMTP_XYZ generated the following messages:

 [4]  --- Line    14 Mail     2 : Undeliverable mail for testid@test.com
        Message-Id:  USER1U.JOB00085.VIC000@tcp.com.Aug212008.124124.808675.2>
        Error  : No target server capable of receiving mail:
    mail extensions not supported.

        Mail was not delivered to the following recipients:  
        user41@vic000.tcp.com
 [5]  --- Line    54 Mail     5 : RCPT TO:   <user@vic000.tcp.com>
    501 5.1.1 JES Syntax error in mailbox '<user'
 [6]  --- Line    40 Mail     4 : Undeliverable mail for userx@vic000.tcp.com
        Message-Id:<USER1U.JOB00085.VIC000@tcp.com.Aug212008.124124.808675.4>

        Mail was not delivered to the following recipients:
        usery@vic000.tcp.com   
        Reply  : 550 User 'usery' Unknown
 [7]  --- Line    26 Mail     3 : Undeliverable mail for testid@test.com
        Message-Id:<USER1U.JOB00085.VIC000@tcp.com.Aug212008.124124.808675.3>

        Mail was not delivered to the following recipients:
        userx@vic000.tcp.com
        Reply  : 550 User 'userx' Unknown
                                                                                          
 [8]  --- Line    48 Mail     6 : Undeliverable mail for testid@example.com
        Message-Id:<USER1U.JOB00085.VIC000@example.com.Aug212008.124124.808675.6>
        Error  : No target server capable of receiving mail:
     unable to establish a TLS connection.
        Mail was added to extended retry

        Mail was not delivered to the following recipients:
        user2@vic000.example.com
 [9]  Completed at Thu, 21 Aug 2008 12:41:33 -0400
                                                                                          
 [10]  9 = mail messages found                     
 [11]  1 = mail messages with errors    
                                                                                          
 [12]  3 = recipients to whom mail was sent successfully   
 [13]  4 = recipients to whom mail messages could not be delivered


 [14]  Disposition of the JES file was HOLD

Notes:

This identifies the report with the jobname and jobid that contained the JES spool file
These further identify the source of the JES spool file with the jobname, the procedure step name, the job step name, the JES jobid, the originator node user ID, and the local time zone.
The CSSMTP application jobname and external writer name
The line and mail found in the JES spool file cannot be delivered to listed recipients below. The Message-ID is from the header line which identifies this mail to the other SMTP servers. The Error: lines describe the reason the CSSMTP application could not send the mail.
The line and mail found in the JES spool file where a JES syntax error was found. The next line identifies the cause of the error. In this case a blank in the mailbox.
The line and mail found in the JES spool file cannot be delivered to listed recipients below. In this case the target server rejected the mail because a mailbox could not be accepted.
Notice that the mail is listed in the order that they were completed and not in the order that they appear in the spool file.
The line and mail found in the JES spool file cannot be delivered. The mail message was saved for extended retry.
The processing of the spool file was completed at this date and time.
The number of mail messages found in the spool file.
The number of mail messages that contained parsing errors.
The number of recipients to whom mail sent successfully.
The number of recipients to whom mail could not be delivered.
The disposition of the JES spool file that was processed. If the value is HOLD or DELETE it reflects the setting of the BadSpoolDisp configuration statement. If the value is KEEP, it indicates that the CSSMTP application was interrupted during processing of this file. The file will continue to be processed when the application is restarted.