cacheinstances.properties file

Use the information in this document as a reference of the names, values, and explanations that you can use in the cacheinstances.properties file.

The following list provides the property names, associated values, and explanations for the cacheinstance.properties file.

Property name - x is instance number, which starts with 0 Possible value Property explanation
Cache Core Properties    
cache.instance.x any string (no default set) Specifies cache instance name or JNDI name.
cache.instance.x.cacheSize > 0 (default=2000) Specifies the maximum number of entries that are held in memory cache.
cache.instance.x.disableDependencyId True or false (default=false) Specifies that the dynamic cache service supports cache entry dependency IDs. Disable this option if you do not need to use dependency IDs. Dependency IDs specify additional cache group identifiers that associate multiple cache entries to the same group identifier in your cache policy.
cache.instance.x.disableTemplatesSupport True or false (default=false) Specifies whether template support feature is enabled.
cache.instance.x.useListenerContext True or false (default=false) Set this value to true to have invalidation events sent to registered invalidation listeners, using the Java 2 Platform, Enterprise Edition (J2EE) context of the listener. If you want to use listener J2EE context for callback, set this value to true. If you want to use the caller thread context for callback, set this value to false.
cache.instance.x.enableNioSupport True or false (default=false) Specifies whether DistributedMap or DistributedNioMap is used.
     
Cache Servlet/JSP caching Properties    
cache.instance.x.cascadeCachespecProperties True or false (default=false) A configurable change in the behavior of the cache so that the child pages and fragments inherit the cache specification properties of their parent pages and fragments. If the request for a fragment does not match a defined cache policy, the fragment will inherit the save-attributes and the store-cookies properties from its parent fragment. Enable this cascade of save-attributes and store-cookies properties by setting the value to true.
cache.instance.x.disableStoreCookies "none", "ALL","All", cache instance name, comma delineated list of cookie names, (default="none") Specifies whether disable store cookies is NONE or ALL. Stores cookies as part of the response by default unless configured otherwise on a per request basis in cachespec.xml file. There is a risk of sharing cookies between users, which violates security.
cache.instance.x.enableServletSupport True or false (default=false) Specifies whether the cache instance is servlet cache or object cache.
     
Cache disk offload properties    
cache.instance.x.enableDiskOffload True or false (default=false) Specifies whether disk offload is enabled.
cache.instance.x.diskOffloadLocation String – For example:
. $(app_server_root)/diskOffload
Specifies the location on the disk to save cache entries when disk offload is enabled.
cache.instance.x.diskCacheSize >= 0 (0=limit does not exist) Specifies a value for the maximum disk cache size in number of entries.
cache.instance.x.diskCacheSizeInGB 0 or > 2 in GB (0=limit does not exist) Specifies a value for the maximum disk cache size in gigabytes (GB).
cache.instance.x.flushToDiskOnStop True or false (default = false) Specifies if in-memory cached objects are saved to disk when the server stops.
cache.instance.x.diskCachePerformanceLevel 0=low 1=balance 2=custom 3=high (default=1) Specifies the performance level to tune the performance of the disk cache.
cache.instance.x.htodCleanupFrequency 0 <= x <= 1440 in minutes (0=cleanup at midnight) Specifies a value for the disk cache cleanup frequency, in minutes. If this value is set to 0, the cleanup runs only at midnight. This setting applies only when the Disk Offload Performance Level is low, balanced, or custom. The high performance level does not require disk cleanup, and this value is ignored.
cache.instance.x.htodDelayOffloadDepIdBuckets > 0 (default=1000) Specifies a value for the maximum number of dependency identifier buckets in the disk cache metadata in memory. If this limit is exceeded, the information is offloaded to the disk. This setting applies only when the disk cache performance level is custom.
cache.instance.x.htodDelayOffloadTemplateBuckets > 0 (default=100) Specifies a value for the maximum number of template buckets that are in the disk cache metadata in memory. If this limit is exceeded, the information is offloaded to the disk. This setting applies only when the disk cache performance level is custom.
cache.instance.x htodDelayOffloadEntriesLimit > 0 (default=1000) Specifies a value for the maximum number of cache identifiers that are stored for an individual dependency ID or template in the disk cache metadata in memory. If this limit is exceeded, the information is offloaded to the disk. This setting applies only when the disk offload performance level is custom.
cache.instance.x.diskCacheEvictionPolicy 0=disable 1=random 2:size (default=0) Specifies the eviction algorithm that the disk cache will use to evict entries once the high threshold is reached.
cache.instance.x.diskCacheHighThreshold > 0 % (default=80) Specifies when the eviction policy runs. The threshold is expressed in terms of the percentage of the disk cache size in GB or entries. The high value is used when limit disk cache size in GB and limit disk cache size in entries are specified.
cache.instance.x.diskCacheLowThreshold > 0 % (default=70) Specifies when the eviction policy runs. The threshold is expressed in terms of the percentage of the disk cache size in GB or entries. The lower value is used when limit disk cache size in GB and limit disk cache size in entries are specified.
     
Cache Replication Properties    
cache.instance.x.enableCacheReplication True or false (default=false) Specifies whether cache replication is enabled. Use cache replication to have cache entries copied to multiple application servers configured in the same replication domain.
cache.instance.x.replicationType 1 (Not shared, 2 (Push), 4 (Push and pull) Specifies the global sharing policy for this application server.
cache.instance.x.replicationDomain String – For example: DynamicCacheDomain Specifies a replication domain from which your data is replicated.
cache.instance.x.useServerClassLoader True or false (default=false) Specifies whether using server class loader is enabled. Setting this value to true, deserializes the InvalidationEvent using system classloader first and then using application classloader, if that fails. This improves performance.
cache.instance.x.cacheEntryWindow > 0 (default=50) Specifies a limit on the total number of cache entires that are sent by the data replication service (DRS) in terms of number of entries.
cache.instance.x.cachePercentageWindow > 0 % (default=2) Specifies a limit on the number of cache entries that are sent by DRS in terms of the percentage of total cache in memory.
cache.instance.x.cacheInvalidateEntryWindow > 0 (default=50) Specifies a limit on the total number of invalidation events that are sent by DRS in terms of number of entries.
cache.instance.x.cacheInvalidatePercentWindow > 0 % (default=2) Specifies a limit on the number of invalidation events that are sent by DRS in terms of the percentage of total cache in memory.
cache.instance.x.filterTimeOutInvalidation True or false (default=false) Specifies whether sending invalidations that are based on timeout eviction is enabled.
cache.instance.x.filterLRUInvalidation True or false (default=false) Specifies whether sending invalidations that are based on LRU eviction is enabled.
cache.instance.x.ignoreValueInInvalidationEvent True or false (default=false) Specifies whether the cache value of Invalidation event is ignored. If it is true, the cache value of Invalidation event is set to NULL when the code is returned to the caller.



Related tasks
Using the DistributedMap and DistributedObjectCache interfaces for the dynamic cache
Reference topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=rdyn_instances
File name: rdyn_cacheinstances.html