IT41954: USERTRACE ABENDS IF PASSED CHARACTER ARRAYS FROM A C USER DEFINED EXTENSION

APAR status

• Closed as program error.

Error description

• If a C user defined extension such as a custom node or parser
  logs user trace, either directly or indirectly, and the data
  contains a single hex character below 0x14 then an abend with
  the following stack may be observed:
  
  ImbThreadSafeCount::increment
  ImbStringBase<unsigned char, std::char_traits<unsigned char>,
  unsigned short, 128u>::linkToBuffer
  
  ImbStringBase<unsigned char, std::char_traits<unsigned char>,
  unsigned short, 128u>::assign
  
  ImbBufferedStringBase<unsigned char, std::char_traits<unsigned
  char>, unsigned short, 24u, 128u>::ImbBufferedStringBase
  
  ImbValue::ImbValue
  
  ImbLogFile::convertInsertsToList (this=0x7ffff2673240
  
  ImbLogFile::writePlaintext
  
  ImbLogFile::write
  
  ImbLog::FastItem::writeToFile
  
  ImbLog::FastItem::operator<<
  
  
  Passing a character array as an insert containing other data
  may result in corrupted entries being written for that insert in
  the user trace.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All customers of App Connect Enterprise v11 or v12.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  <span style="background-color:rgb(255, 255, 255)">If a C user
  defined extension such as a custom node or parser </span><span
  style="background-color:rgb(255, 255, 255)">logs user trace,
  either directly or indirectly, and the data </span><span
  style="background-color:rgb(255, 255, 255)">contains a single
  hex character below 0x14 then an abend with </span><span
  style="background-color:rgb(255, 255, 255)">the following stack
  may be observed:                           </span>
  <span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbThreadSafeCount::increment
       </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbStringBase<unsigned char, std::char_traits<unsigned
  char>,  </span><span style="background-color:rgb(255, 255,
  255)">unsigned short, 28u>::linkToBuffer
                             </span><span
  style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbStringBase<unsigned char, std::char_traits<unsigned
  char>,  </span><span style="background-color:rgb(255, 255,
  255)">unsigned short, 128u>::assign
                                   </span><span
  style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbBufferedStringBase<unsigned char,
  std::char_traits<unsigned</span>
  <span style="background-color:rgb(255, 255, 255)">char>,
  unsigned short, 24u, 128u>::ImbBufferedStringBase
  </span><span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbValue::ImbValue
       </span><span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbLogFile::convertInsertsToList </span><span
  style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbLogFile::writePlaintext
       </span><span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbLogFile::write
       </span><span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbLog::FastItem::writeToFile
       </span><span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255,
  255)">ImbLog::FastItem::operator<<
       </span>
  <span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255, 255)">Passing a
  character array as an insert containing other data </span><span
  style="background-color:rgb(255, 255, 255)">may result in
  corrupted entries being written for that insert in </span><span
  style="background-color:rgb(255, 255, 255)">the user trace.
         </span>
  

Problem conclusion

• App Connect no longer crashes when a char* is passed to the user
  trace functions.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v12.0      12.0.6.0
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

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:

Fix information

• Fixed component name

  APP CONNECT ENT

• Fixed component ID

  5724J0560

Applicable component levels