IT02600: DATABASE NAME WITH SPECIAL CHARACTERS PRODUCES A DEPLOY ERROR

APAR status

• Closed as program error.

Error description

• IBM Integration Bus can fail to deploy a broker archive (BAR)
  containing a graphical data map with database content in certain
  circumstances.
  If the graphical data map references a database schema name or
  table name that contains a non-alphanumeric character, such as
  "#", then the BAR deployment may fail in the runtime.
  
  One of these error messages is generated:
  
  BIP3946E: The map script generation for QName '' has failed,
  with the following details: ''java.lang.RuntimeException:
  IXJXE0609E: [ERR 0548][ERR XPST0017] The function '{
  http://www.ibm.com/xmlmap}db-name' with arity 1 is not in the
  in-scope function declarations.''.
  
  BIP3946E: The map script generation for QName '' has failed,
  with the following details:
  'java.lang.RuntimeException:IXJXE0800E: [ERR XQ102231][ERR
  XPST0003] An expression is not a valid instance of the grammar
  defined for XQuery. '.
  
  
  Additional Symptom(s) Search Keyword(s): Database, Special
  characters, BIP3946E, Deploy
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of WebSphere Message Broker V8.0 or IBM Integration
  Bus V9.0 deploying a broker archive (BAR)
  containing a graphical data map that references a database
  schema name or table name that contains a non-alphanumeric
  character.
  
  
  Platforms affected:
  z/OS, MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  IBM Integration Bus can fail to deploy a broker archive (BAR)
  containing a graphical data map that references a database
  schema name or table name that contains a non-alphanumeric
  character in certain circumstances.
  
  If the graphical data map references a database schema name or
  table name that contains a non-alphanumeric character, such as
  "#", then the BAR deployment may fail in the runtime. One of
  these error messages is generated:
  
  BIP3946E: The map script generation for QName '' has failed,
  with the following details: ''java.lang.RuntimeException:
  IXJXE0609E: [ERR 0548][ERR XPST0017] The function '{
  http://www.ibm.com/xmlmap}db-name' with arity 1 is not in the
  in-scope function declarations.''.
  
  BIP3946E: The map script generation for QName '' has failed,
  with the following details: 'java.lang.RuntimeException:
  IXJXE0800E: [ERR XQ102231][ERR XPST0003] An expression is not a
  valid instance of the grammar defined for XQuery. '.
  
  
  
  
  There are a number of resource name changes between WebSphere
  Message Broker and IBM Integration Bus Version 9.0. For details
  visit
  http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/topic/com.ibm.e
  tools.mft.doc/bb23814_.htm
  

Problem conclusion

• The product now correctly deploys a broker archive (BAR)
  containing a graphical data map that references a database
  schema name or table name that contains a non-alphanumeric
  character.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.0       9.0.0.3
  
  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:

  IT02580

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

Fix information

• Fixed component name

  INTEGRATION BUS

• Fixed component ID

  5724J0530

Applicable component levels

• R900 PSY

     UP