PI38893: CSSMTP TERMINATES CONNECTION TO MAIL SERVER

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The connection with a mail server is terminated after the last
  mail message in a JES spool file has been processed.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of the IBM Communications Server for z/OS Version  *
  * 2 Release 1: CSSMTP                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The connection with a mail server is terminated after the    *
  * last mail message in a JES spool file has been processed.    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply PTF                                                    *
  ****************************************************************
  The connection with a mail server is terminated after the last
  mail message in a JES spool file has been processed. In some
  circumstances this is undesirable.
  

Problem conclusion

• A new configuration parameter has been added to control how long
  to keep a connection with a mail server after the last mail
  message in a JES spool file has been processed.  The new
  parameter is ConnectIdle in the Timeout configuration statement.
  Timeout
  {
     ConnectIdle 0             # default
    #ConnectIdle seconds # seconds
  }
  The following are the documentation updates:
  ---------------------------------------------------------------
  IP Configuration Reference, SC27-3651-03
  
  Update CSSMTP configuration statements to add
  the new parameter ConnectIdle to the Timeout statement in table
  103.
  CSSMTP configuration statements.
  
  Table 103 lists CSSMTP configuration file statements.
  
  Configuration                       Required    allowed
  file                                        or               by
  modify
  statement        Default          optional    refresh
  
  ----------------------------------------------------------------
  -
  ....
  Timeout       ConnectIdle 0   Optional    Yes        .........
  ....
  
  
  Update section that describes the TIMEOUT statement.
  TIMEOUT statement
  ....
  
       _ConnectIdle 0____________
  |__|____________________________|_____|
      |_ConnectIdle seconds___|
  
  ....
  
  ConnectIdle
  
  The length of time, in seconds, to keep a connection with a
  target server after processing the last mail message in a JES
  spool file if another spool file is not immediately available
  for processing.
  Valid values are in the range 0 - 65535. The default value is 0
  that indicates that the connection with the target server is
  dropped when the last mail message in a spool file is processed.
  
  
  Result: If the target mail server implements an idle timeout
  that expires before CSSMTP's idle timeout, the target server
  closes the connection. This is not an error. If CSSMTP attempts
  to send a mail message when the target server closes the
  connection, the mail message might be treated as undeliverable,
  which causes the normal CSSMTP retry logic to be used.
  
  Guideline: If the target mail server implements an idle timeout,
  set this value to be shorter than the value of the target server
  to avoid retries.
  
  ---------------------------------------------------------------
  IP System Administrator's Commands, SC27-3661-02
  Chapter 1, section: MODIFY command: Communications Server SMTP
  application (CSSMTP), Example 2:
  
  Example 2: The MODIFY DISPLAY,CONFIG command displays the
  current configuration that is being used by CSSMTP.
  
  F CSSMTP,DISPLAY,CONFIG
  EZD1829I CSSMTP CONFIGURATION:
  CONFIGFILENAME    : /U/USER1/CSSMTP/CSSMTP.CONF
  LOGFILENAME          : /U/USER1/CSSMTP/CSSMTP.LOG0707S1
  ....
  TIMEOUT:
   ANYCMD                :  300                    CONNECTRETRY
  :  120
   DATABLOCK           :  180                     DATAINIT
  :  120
   DATATERM             :  600                    INITIALMSG
  :  300
   MAILCMD               :  300                    RPCTCMD
  :  300
   CONNECTIDLE        :  0
  ....
  

Temporary fix

Comments

• A new configuration parameter has been added to control how long
  to keep a connection with a mail server after the last mail
  message in a JES spool file has been processed.  The new
  parameter is ConnectIdle in the Timeout configuration statement.
  Timeout
  {
     ConnectIdle 0             # default
    #ConnectIdle seconds # seconds
  }
  The following are the documentation updates:
  ---------------------------------------------------------------
  IP Configuration Reference, SC27-3651-03
  
  Update CSSMTP configuration statements to add
  the new parameter ConnectIdle to the Timeout statement in table
  103.
  CSSMTP configuration statements.
  
  Table 103 lists CSSMTP configuration file statements.
  
  Configuration                       Required    allowed
  file                                        or               by
  modify
  statement        Default          optional    refresh
  
  ----------------------------------------------------------------
  -
  ....
  Timeout       ConnectIdle 0   Optional    Yes        .........
  ....
  
  
  Update section that describes the TIMEOUT statement.
  TIMEOUT statement
  ....
  
       _ConnectIdle 0____________
  |__|____________________________|_____|
      |_ConnectIdle seconds___|
  
  ....
  
  ConnectIdle
  
  The length of time, in seconds, to keep a connection with a
  target server after processing the last mail message in a JES
  spool file if another spool file is not immediately available
  for processing.
  Valid values are in the range 0 - 65535. The default value is 0
  that indicates that the connection with the target server is
  dropped when the last mail message in a spool file is processed.
  
  
  Result: If the target mail server implements an idle timeout
  that expires before CSSMTP's idle timeout, the target server
  closes the connection. This is not an error. If CSSMTP attempts
  to send a mail message when the target server closes the
  connection, the mail message might be treated as undeliverable,
  which causes the normal CSSMTP retry logic to be used.
  
  Guideline: If the target mail server implements an idle timeout,
  set this value to be shorter than the value of the target server
  to avoid retries.
  
  ---------------------------------------------------------------
  IP System Administrator's Commands, SC27-3661-02
  Chapter 1, section: MODIFY command: Communications Server SMTP
  application (CSSMTP), Example 2:
  
  Example 2: The MODIFY DISPLAY,CONFIG command displays the
  current configuration that is being used by CSSMTP.
  
  F CSSMTP,DISPLAY,CONFIG
  EZD1829I CSSMTP CONFIGURATION:
  CONFIGFILENAME    : /U/USER1/CSSMTP/CSSMTP.CONF
  LOGFILENAME          : /U/USER1/CSSMTP/CSSMTP.LOG0707S1
  ....
  TIMEOUT:
   ANYCMD                :  300                    CONNECTRETRY
  :  120
   DATABLOCK           :  180                     DATAINIT
  :  120
   DATATERM             :  600                    INITIALMSG
  :  300
   MAILCMD               :  300                    RPCTCMD
  :  300
   CONNECTIDLE        :  0
  ....
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI26955

Modules/Macros

• EZAMLCFP EZAMLCON EZAMLCFG EZAMLCAT EZAMLMN  EZAMLCFM
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R210 PSY UI26955

     UP15/06/23 P F506

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.