JR39312: CMVC 208529 - ALLOW THE USE OF CUSTOM CACHES WITH THE DYNACACHEINVALIDATIONCMD SCHEDULER JOB

7.0.0-WS-WCServer-FP009
WebSphere Commerce Version 7.0.0.6 Fix Pack
WebSphere Commerce Version 7.0.0.7 Fix Pack
WebSphere Commerce Version 7.0.0.8 Fix Pack
WebSphere Commerce Version 7.0.0.9 Fix Pack

APAR status

• Closed as program error.

Error description

• The IBM WebSphere Commerce the DynaCacheInvalidation scheduler
  job can be used to send invalidation ID strings to the default
  baseCache servlet cache.  However, it was not originally
  designed to send invalidation id strings to customer defined
  DistributedMap object cache instances.
  

Local fix

Problem summary

• USERS AFFECTED:
  Customers of WebSphere Commerce version 7 who define their own
  DistributedMap object cache instances and wish to use the
  DynaCacheinvalidation scheduler job to send invalidation id
  strings to their object cache instance.
  
  PROBLEM ABSTRACT:
  Adding capability to use the WebSphere Commerce
  DynaCacheInvalidation scheduler job to send invalidation ID
  strings to customer defined DistributedMap object cache
  instances
  
  BUSINESS IMPACT:
  Without this new capability, customers would have to write
  custom code to issue invalidation id strings to their object
  cache instances.
  
  RECOMMENDATION:The IBM WebSphere Commerce DynaCacheInvalidation
  scheduler job looks in the CACHEIVL table for recently added
  rows.  When it finds a value in the TEMPLATE column that starts
  with "dmap:" it uses the rest of the value following the "dmap:"
  prefix as a JNDI name that specifies a DistributedMap object
  cache instance. If the specified object cache does not exist, no
  action is taken.  However, if the specified object cache does
  exist then the value of the DATAID column is sent to the
  specified object cache as an invalidation id string.
  
  Note that if you have defined the distributed map in a
  cacheinstances.properties file, the first forward slash should
  be omitted. For example, if the distributed map is defined as
  
  cache.instance.0=/services/cache/MyCustomMapCache
  
  then the string in the TEMPLATE column of the CACHEIVL table
  should be
  
  dmap:services/cache/MyCustomMapCache
  -------------------------------------------------------------
  The latest available maintenance information can be obtained
  from the Recommended Fixes for WebSphere Commerce technote:
  http://www.ibm.com/support/docview.wss?rs=3046&uid=swg21261296
  

Problem conclusion

• The IBM WebSphere Commerce DynaCacheInvalidation scheduler job
  looks in the CACHEIVL table for recently added rows.  When it
  finds a value in the TEMPLATE column that starts with "dmap:" it
  uses the rest of the value following the "dmap:" prefix as a
  JNDI name that specifies a DistributedMap object cache instance.
  If the specified object cache does not exist, no action is
  taken.  However, if the specified object cache does exist then
  the value of the DATAID column is sent to the specified object
  cache as an invalidation id string.
  
  Note that if you have defined the distributed map in a
  cacheinstances.properties file, the first forward slash should
  be omitted. For example, if the distributed map is defined as
  
  cache.instance.0=/services/cache/MyCustomMapCache
  
  then the string in the TEMPLATE column of the CACHEIVL table
  should be
  
  dmap:services/cache/MyCustomMapCache
  -------------------------------------------------------------
  The latest available maintenance information can be obtained
  from the Recommended Fixes for WebSphere Commerce technote:
  http://www.ibm.com/support/docview.wss?rs=3046&uid=swg21261296
  

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

  WC BUS EDITION

• Fixed component ID

  5724I3800

Applicable component levels

• R700 PSY

     UP