IBM Support

PI38893: CSSMTP TERMINATES CONNECTION TO MAIL SERVER

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PI38893

  • Reported component name

    TCP/IP V3 MVS

  • Reported component ID

    5655HAL00

  • Reported release

    210

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2015-04-13

  • Closed date

    2015-04-22

  • Last modified date

    2017-01-25

  • 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
    

Publications Referenced
SC27365103SC27366102   

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCY4DZ","label":"DO NOT USE"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 January 2017