Distributed Map (distributedMap)

Distributed map configuration for a local cache.

NameTypeDefaultDescription

cacheProviderName

string

default

Specifies the name of an alternate cache provider.

highThreshold

int
Min: -1
Max: 100

-1

Specifies when the memory cache eviction policy starts. The threshold is expressed in terms of the percentage of the memory cache size in megabytes (MB).

id

string
Required

Display name of the distributed map.

jndiName

string

${id}

JNDI name for a cache instance.

libraryRef

A reference to top level library element (string).

Specifies a reference to a shared library.

lowThreshold

int
Min: -1
Max: 100

-1

Specifies when the memory cache eviction policy ends. The threshold is expressed in terms of the percentage of the memory cache size in megabytes (MB).

memorySizeInEntries

int
Min: 0

2000

Specifies a positive integer that defines the maximum number of entries that the cache can hold. Values are usually in the thousands. The minimum value is 100, with no set maximum value. The default value is 2000.

memorySizeInMB

int
Min: -1

-1

Specifies a value for the maximum memory cache size in megabytes (MB).

distributedMap > cacheGroup

Specifies sets of external caches that are controlled by WebSphere(R) Application Server on servers such as IBM(R) WebSphere(R) Edge Server and IBM(R) HTTP Server.

NameTypeDefaultDescription

name

string

Specifies a unique name for the external cache group. The external cache group name must match the ExternalCache property that is defined in the servlet or Java(TM) Server Pages (JSP) cachespec.xml file.

Expand
distributedMap > cacheGroup > member

Members of an external cache group that are controlled by WebSphere Application Server.

distributedMap > diskCache

Enable disk offload to specify that when the cache is full, cache entries are removed from the cache and saved to disk. The location is a fully-qualified directory location that is used by the disk offload function. The Flush to Disk on Stop option specifies that when the server stops, the contents of the memory cache are moved to disk.

NameTypeDefaultDescription

evictionPolicy

  • RANDOM

  • SIZE

RANDOM

Specifies the eviction algorithm and thresholds that the disk cache uses to evict entries. When the disk size reaches a high threshold limit, the disk cache garbage collector wakes up and evicts randomly-selected (Random) or the largest (Size) entries on the disk until the disk size reaches a low threshold limit.

flushToDiskOnStopEnabled

boolean

false

Set this value to true to have objects that are cached in memory saved to disk when the server stops. This value is ignored if Enable disk offload is set to false.

highThreshold

int
Min: 0
Max: 100

80

Specifies when the eviction policy starts.

location

Path to a directory

Specifies a directory to use for disk offload.

lowThreshold

int
Min: 0
Max: 100

70

Specifies when the eviction policy ends.

sizeInEntries

int
Min: 0

100000

Specifies a value for the maximum disk cache size, in number of entries.

sizeInGB

int
Min: 3

3

Specifies a value for the maximum disk cache size, in gigabytes (GB).

distributedMap > library

Specifies a reference to a shared library.

NameTypeDefaultDescription

apiTypeVisibility

string

spec,ibm-api,api,stable

The types of API packages that this class loader supports. This value is a comma-separated list of any combination of the following API packages: spec, ibm-api, api, stable, third-party.

description

string

Description of shared library for administrators

filesetRef

List of references to top level fileset elements (comma-separated string).

Id of referenced Fileset

name

string

Name of shared library for administrators

Expand
distributedMap > library > file

Id of referenced File

Expand
distributedMap > library > fileset

Id of referenced Fileset

Expand
distributedMap > library > folder

Id of referenced folder