JR51616: RUNNING BPMCONFIG -EXPORT GENERATES INCORRECT DATABASE PROPERTIES WHEN YOU USE DB2 FOR Z/OS OR A MODIFIED ORACLE

8.5.5.0-WS-BPM-IFJR51616
Version 8.5 Refresh Pack 6 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• When you run BPMConfig -export for a deployment environment
  that uses IBM DB2 for z/OS databases, the generated
  configuration file contains @TO_BE_REPLACED@ placeholders for
  the bpm.de.db.#.databaseName properties.
  Or, when you use Oracle databases and manually modify the
  Oracle service name or the system ID (SID) in the URL resource
  property for the IBM Business Process Manager (BPM) data
  sources, the configuration file that running BPMConfig -export
  generates is missing the database properties for the Messaging
  capability and the databases for the CellScopedDB and
  EmbeddedECM capabilities are duplicated.
  

Local fix

• Change the  database information in the
  <Dmgr>/config/cells/<CellName>/cell-bpm.xml file to match the
  runtime  datasource configuration
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  IBM BPM Advanced                            *
  *                  IBM BPM Standard                            *
  *                  IBM BPM Express                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: When you run BPMConfig -export for a    *
  *                      deployment environment that uses IBM    *
  *                      DB2 for z/OS databases, the generated   *
  *                      configuration file contains             *
  *                      @TO_BE_REPLACED@ placeholders for the   *
  *                      bpm.de.db.#.databaseName properties.    *
  *                      Or, when you use Oracle databases and   *
  *                      manually modify the Oracle service      *
  *                      name or the system ID (SID) in the      *
  *                      URL resource property for the IBM       *
  *                      Business Process Manager (BPM) data     *
  *                      sources, the configuration file that    *
  *                      running BPMConfig -export generates     *
  *                      is missing the database properties      *
  *                      for the Messaging capability and the    *
  *                      databases for the CellScopedDB and      *
  *                      EmbeddedECM capabilities are            *
  *                      duplicated.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When you use a DB2 for z/OS database, the database name was
  not correctly read from the WebSphere configuration.
  When you use an Oracle database with manually modified URL
  resource properties, the BPMConfig command can no longer match
  the IBM BPM data sources with the database information that is
  stored in IBM BPM's WebSphere configuration (WCCM) extensions.
  

Problem conclusion

• A fix is available for IBM BPM V.8.5.5 that updates the
  BPMConfig command to generate configuration files that have
  correct database properties.
  
  On Fix Central (http://www.ibm.com/support/fixcentral), search
  for JR51616:
  
  1. Select IBM Business Process Manager with your edition from
  the product selector, the installed version to the fix pack
  level, and your platform, and then click Continue.
  2. Select APAR or SPR, enter JR51616, and click Continue.
  
  When you download fix packages, ensure that you also download
  the readme file for each fix. Review each readme file for
  additional installation instructions and information about the
  fix.
  

Temporary fix

• Manually edit the configuration file that running BPMConfig
  -export generated and fix the problems with the
  database-related properties.
  

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

  BPM ADVANCED

• Fixed component ID

  5725C9400

Applicable component levels

• R800 PSY

     UP