PM87623: ALLOW CSSMTP TO TREAT TRAILING NULL CHARACTERS AS TRAILING BLANK CHARACTERS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The length limitation of 512 on the SMTP command lines are
  enforced after the trailing blanks (x'40') are removed from the
  command.  If the trailing characters are null characters (x'00')
  then CSSMTP does not strip them away and counts these characters
  towards the length of the command line.  An option setting for
  CSSMTP is needed to allow trailing null characters to be
  treated as trailing blank characters.
  
  
  
  
  
  
  Additional Symptom(s) Search Keyword(s): KIXREVxxx 5.2.5 JES
  too long RFC821 RFC 2821
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release(s) 13 IP: CSSMTP  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Certain mail message files contained    *
  *                      trailing nulls at the end of command    *
  *                      records.  When the length of the        *
  *                      records was longer than 510             *
  *                      characters, the mail messages were      *
  *                      rejected with a "500 5.2.5 JES          *
  *                      Command line too long" reply.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A new configuration statement and parameter have been added to
  control the removal of trailing null characters in the
  command records. The new parameter is NullTrnc in the Options
  configuration statement.
  
  Options
  {
   NullTrnc No # leave trailing nulls(default)
  #NullTrnc YES # Strip trailing nulls
  }
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• CSSMTP is amended to add a new configuration statement (OPTIONS)
  and a new parameter (NULLTRNC) to remove trailing null
  characters from the end of each command statement.
  
  z/OS Communications Server
  IP Configuration Reference
  Document Number SC31-8776-19
  Chapter: Communications Server SMTP application
  Heading: CSSMTP configuration statements
  
  
  Update section 31.3.1 CSSMTP configuration statements to add
  the NullTrnc parameter to the Options statement in table 108.
  
                                      Update
  Configuration                       allowed by
  file                   Required or  modified
  statement     Default  Optional     refresh     Purpose
  _____________ _______  ____________ ___________ _______________
  Options       NullTrnc Optional     Yes         CSSMTP options
                No
  
  31.y Options statement
  
  Use the Options statement to change the processing behavior
  of CSSMTP.
  
  Syntax
  
  >>__Options_| Put Braces and Parameters on Separate Lines |_><
  
  Put Braces and Parameters on Separate Lines:
  |__ _{______________________ _______________________________|
     |_| Options Parameters |_|
     |_}______________________|
  
  Options Parameters:
      _NullTrnc NO_______
  |__|___________________|____________________________________|
     |_NullTrnc__ _YES_ _|
                 |_NO__|
  
                 |_NO__|
  
  
  NullTrnc
       Specifies if the trailing null characters are to be
       stripped from command records (EHLO, HELO, MAIL, RCPT and
       DATA).
  
       NO
           The trailing null characters are not stripped from
           the mail command records by CSSMTP. This is the
           default.
  
       YES
           The trailing null characters are stripped from the mail
           command records by CSSMTP.
  
  
  * Cross Reference between External and Internal Names
  HHHMLCFG (EZAMLCFG)  HHHMLCFP (EZAMLCFP)
  

Temporary fix

Comments

APAR Information

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

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

  UK94439 PM94506

Modules/Macros

• EZAMLCFP EZAMLJSP HHHMLCFG HHHMLCFP
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1D0 PSY UK94439

     UP13/06/19 P F306

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.