PH61204: JAVAX.MANAGEMENT.BUILDER.INITIAL= DOES NOT OVER-RIDE WAS DEFAULT WHEN SET AS A WEBSPHERE VARIABLE

APAR status

• Closed as program error.

Error description

• For WebSphere Application Sever for z/OS, there is config to
  native code that processes generic JVM argument and WebSphere
  variables and writes information to the jvm.options files for
  the control region, servant region and adjunct region.  The
  config to native code was not designed to handle checking if
  -Djavax.management.builder.initial= is set as a WebSphere
  variable and remove the one that WAS sets (it's a different set
  of code that is used when -Djavax.management.builder.initial= is
  set as a generic JVM argument).
  
  When the following is set:
  WebSphere variable:
  Name=MV_JMX_BUILDER
  Value=-Djavax.management.builder.initial
  
  generic JVM argument in the servant region:
  ${MV_JMX_BUILDER}
  
  The servant.jvm.options file contains:
  -Djavax.management.builder.initial=
  -Djavax.management.builder.initial=com.ibm.ws.management.Platfo
  rmMBeanServerBuilder
  
  The config to native code will be enhanced to allow this to
  work.  But it will only work if only 1 WebSphere variable
  contains -Djavax.management.builder.initial= for that server,
  set at any scope that affects that server.
  

Local fix

• set -Djavax.management.builder.initial= as a generic JVM
  argument for the servant region
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server                                      *
  *                  V8.5 or later                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Djavax.management.builder.initial on    *
  *                      z/os does not over-ride the default     *
  *                      value when set as a WebSphere           *
  *                      variable.                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  For WebSphere Application Sever for z/OS, there is config to
  native code that processes generic JVM argument and WebSphere
  variables and writes information to the jvm.options files for
  the control region, servant region and adjunct region.  The
  config to native code was not designed to handle checking if
  -Djavax.management.builder.initial= is set as a WebSphere
  variable and remove the one that WAS sets (it's a different set
  of code that is used when -Djavax.management.builder.initial=
  is
  set as a generic JVM argument).
  When the following is set:
  WebSphere variable:
  Name=MV_JMX_BUILDER
  Value=-Djavax.management.builder.initial
  generic JVM argument in the servant region:
  ${MV_JMX_BUILDER}
  The servant.jvm.options file contains:
  -Djavax.management.builder.initial=
  -Djavax.management.builder.initial=com.ibm.ws.management.Platfo
  rmMBeanServerBuilder
  The config to native code will be enhanced to allow this to
  work.  But it will only work if only 1 WebSphere variable
  contains -Djavax.management.builder.initial= for that server,
  set at any scope that affects that server.
  

Problem conclusion

• Code is fixed to honor the value being set by client as a
  websphere variable.
  
  The fix for this APAR is targeted for inclusion in fix pack
  8.5.5.26 and 9.0.5.21. For more information, see 'Recommended
  Updates for WebSphere Application Server':
  https://www.ibm.com/support/pages/node/715553
  

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

  WEBSPHERE FOR Z

• Fixed component ID

  5655I3500

Applicable component levels