IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    JR51616

  • Reported component name

    BPM ADVANCED

  • Reported component ID

    5725C9400

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-10-24

  • Closed date

    2015-01-06

  • Last modified date

    2015-01-06

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.5","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
06 January 2015