Defining the capacity and concurrent write behavior for the document cache

When the DataPower® Gateway retrieves a document, an XML manager might cache the document.

About this task

On the Document Cache tab of an XML manager you can define the capacity of the document cache and the concurrent write behavior for the document cache.

  • The count and size properties control the capacity of the document cache.
  • The concurrent writes property controls the creation and refreshing of documents. After the maximum number is reached, requests bypass the cache and are forwarded to the target server directly. The responses are not written to the cache.

    For example, when the maximum number is 20, a maximum of 20 cache entries can be created for document writes. Each entry is populated with a different document when the DataPower Gateway receives the server response to the request. When another request requests a document that has no entry in the cache or is expired, the request bypasses the cache and is forwarded to the remote server. The remote server responds directly to the request instead of writing the response to the cache.

Procedure

  1. In the Document cache count field, enter the maximum number of documents that is allowed in the cache.
  2. In the Document cache size field, enter the maximum size for document cache.
    Regardless of size, no document that is greater than 1073741824 bytes is cached. This restriction applies even when the cache has available space.
  3. In the Maximum concurrent writes field, enter the maximum number of concurrent writes to create documents or refresh expired documents in the cache.