A fix is available
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
SC27365103 | SC27366102 |
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