IT32963: MSET XSDZIP DEPLOY FAILS WITH BIP2135 IF MSET CONTAINS CHARACTERS NOT IN LOCAL CODEPAGE

APAR status

• Closed as program error.

Error description

• The deploy of a message set packaged in a BAR file as an
  .xsdzip can fail with a BIP2135 exception if the
  messageSet.mset file cannot be read in the local codepage. The
  messageSet.mset file is saved in the UTF-8 character set and
  fields such as the description can contain arbitrary UTF-8
  characters. During a deploy, this file is read in the local
  codepage rather than in UTF-8 leading to the BIP2135
  exception.
  
  A service trace will show the following:
  
  {
  ImbXSDResourceManager::notifyAdapterDirectorOfCreate
   {
  ImbXSDResourceManager::isDataObjectDomainSupported ,
  'SampleMSET.xsdzip', 0
   { ImbFile::fileExists ,
  'messageSet.mset'
   } ImbFile::fileExists , true
   {
  ImbFile::ImbFile , true, true, false
   } ImbFile::ImbFile
   {
  ImbFile::openForRead , 'messageSet.mset', false
   {
  ImbFile::openFileInternal , 'messageSet.mset', -2147483648, 3,
  0, false, false, false
   } ImbFile::openFileInternal ,
  (*ptr)30f4, 0, 0, true
   } ImbFile::openForRead
   {
  ImbFile::readFirstLine
   { ImbFile::getSize , (*ptr)30f4
  
  ImbFile::getSize 'Actual size:' , 405
   } ImbFile::getSize , 1,
  405
   { ImbFile::read , (*ptr)593f67a4c0, 405
   } ImbFile::read ,
  405, 0
   ImbConverterCPP::internalToUnicode , 'Throwing
  exception', 'CommonServices/ImbConverter.cpp', 637, 'BIP2135',
  'Unconvertable character', ...
  

Local fix

• Use CCSID 1208 as the local codepage.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM Integration Bus v10 deploying message sets that
  are applicable to the XMLNSC, SOAP, or DataObject domains that
  contain non-ASCII characters in their description fields.
  
  
  Platforms affected:
  z/OS, MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The deploy of a message set packaged in a BAR file as an .xsdzip
  can fail with a BIP2135 exception if the messageSet.mset file
  cannot be read in the local codepage. The messageSet.mset file
  is saved in the UTF-8 character set and fields such as the
  description can contain arbitrary UTF-8 characters. During a
  deploy, this file is read in the local codepage rather than in
  UTF-8 leading to the BIP2135 exception.
  
  A service trace will show the following:
  
  { ImbXSDResourceManager::notifyAdapterDirectorOfCreate
    { ImbXSDResourceManager::isDataObjectDomainSupported ,
  'SampleMSET.xsdzip', 0
      { ImbFile::fileExists , 'messageSet.mset'
      } ImbFile::fileExists , true
    { ImbFile::ImbFile , true, true, false
    } ImbFile::ImbFile
    { ImbFile::openForRead , 'messageSet.mset', false
      { ImbFile::openFileInternal , 'messageSet.mset',
  -2147483648, 3, 0, false, false, false
      } ImbFile::openFileInternal , (*ptr)30f4, 0, 0, true
    } ImbFile::openForRead
    { ImbFile::readFirstLine
      { ImbFile::getSize , (*ptr)30f4
        ImbFile::getSize 'Actual size:' , 405
      } ImbFile::getSize , 1, 405
      { ImbFile::read , (*ptr)593f67a4c0, 405
      } ImbFile::read , 405, 0
      ImbConverterCPP::internalToUnicode , 'Throwing exception',
  'CommonServices/ImbConverter.cpp', 637, 'BIP2135',
  'Unconvertable character', ...
  

Problem conclusion

• The product will now attempt to read the messageSet.mset file as
  UTF-8 if it cannot be read as UTF-8. If it also cannot be read
  as UTF-8 then the error is rethrown.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v10.0      10.0.0.22
  
  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

  INTEGRATION BUS

• Fixed component ID

  5724J0540

Applicable component levels