JR58738: DOC - THE MANAGED ASSET CLASSLOADER CACHE DOCUMENTATION DOESN'T CONTAIN ENOUGH INFORMATION ABOUT TUNING

bpm.8600.cf2017.12.delta.repository

APAR status

• Closed as documentation error.

Error description

• The managed asset classloader cache documentation doesn't
  provide sufficient information to help you properly determine
  tuning settings.
  
  
  When the settings aren't tuned properly, you might see hung
  threads that contain this snippet in the thread stack:
  
  com/lombardisoftware/server/core/ManagedAssetClassLoader.
  getOwningAssetsByResourceName
  (ManagedAssetClassLoader.java:244(Compiled Code))
  5XESTACKTRACE                   (entered lock:
  com/lombardisoftware/server/core/ManagedAssetClassLoader@0x00000
  007000653D8, entry count: 2)
  4XESTACKTRACE                at
  com/lombardisoftware/server/core/ManagedAssetClassLoader.
  getResourceData (ManagedAssetClassLoader.java:440(Compiled
  Code))
  4XESTACKTRACE                at
  com/lombardisoftware/server/core/ManagedAssetClassLoader.
  findClassInAssets(ManagedAssetClassLoader.java:542(Compiled
  Code))
  4XESTACKTRACE                at
  com/lombardisoftware/server/core/ManagedAssetClassLoader.
  loadClass(ManagedAssetClassLoader.java:186(Compiled Code))
  

Local fix

Problem summary

• The documentation must also mention that when you calculate the
  value for the <classloader-resource-map-size> property, consider
   the following factors:
  
  -When multiple snapshots include the same set of managed asset
  JAR files, you must count the file contents multiple times.
  -When a toolkit snapshot contains managed assets, you must count
  the file contents only once regardless of how many process
  application or toolkits refer to it.
  
  PRODUCTS AFFECTED
  IBM Business Process Manager (BPM)
  IBM BPM Express
  

Problem conclusion

• The content will be updated the next time the documentation is
  refreshed.
  

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

• Fixed component ID

  5737A5700

Applicable component levels