JR49943: CAN'T UPDATE ENV VARIABLE IN DEPENDENT TOOLKIT IF PROCESS APPLICATION OR PARENT TOOLKIT HAS SAME NAME ENV VARIABLE.

Version 8.5 Refresh Pack 5 for the IBM Business Process Manager products
Version 8.5.0 Fix Pack 2 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• No API is available if you want to update an environment
  variable of a dependent toolkit if its process application or
  parent toolkit has an environment variable with the same name.
  
  Toolkit environment variables are inherited to the parent
  process app scope and any changes are stored at that level.
  If multiple objects have the same name then the first one found
  in the process app scope is used.
  An enhancement is needed to add APIs to set and get environment
  variables at the toolkit scope.
  
  
  PRODUCTS AFFECTED
  IBM Business Process Manager (BPM) Advanced
  IBM BPM Standard
  IBM BPM Express
  

Local fix

Problem summary

• If the environment variable of a dependent toolkit has the same
  name as the environment variable of its parent toolkit or
  process application, the environment variable of the dependent
  toolkit cannot be updated.
  

Problem conclusion

• A fix is available for IBM BPM V8.5.0.1 that introduces a new
  optional boolean parameter "withRespectToToolkit" in method
  tw.env.update(TWEnvironmentVariableScriptable envVarScr, String
  value, Object withRespectToToolkit). If the withRespectToToolkit
   parameter is set to True, then the environment variable
  "envVarScr" of the toolkit where this method is called is
  updated with the value "value". If the parameter is set to
  False or is not set, then the first environment variable
  "envVarScr" found in the root context is updated with "value".
  
  This fix also introduces a new api variableValue(Object
  variableName, Object toolkitName) which returns a string value
  of an environment variable that is defined in a specific
  toolkit. This API is part of the tw.env namespace. The inputs
  are strings that denote the name of the variable and the name of
  the toolkit where the variable is defined.  The output is a
  string value of the input variable or null if it is not found in
  the toolkit.
  
  On Fix Central (http://www.ibm.com/support/fixcentral), search
  for JR49943:
  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 JR49943, 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

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 ADV PATTERN

• Fixed component ID

  5725G7600

Applicable component levels

• R850 PSY

     UP