.. highlight:: xml
.. index:: Flushing DataPower Cache

.. _cache_tasks:

Tasks/Commands for Flushing DataPower Cache
===========================================

DataPower caches stylesheets, XML documents and various other items. There is often a need to flush the cache. For example, the stylesheet/XSLT cache should be flushed after XSLT files were updated on the file system. DPBuddy provides several tasks to flush DataPower caches.

.. _flushStylesheetCache:

``flushStylesheetCache``/``flushDocumentCache``/``flushXMLCache`` 
-----------------------------------------------------------------

These tasks flush XSLT and/or XML document caches:

* ``flushStylesheetCache`` flushes the XSLT cache.

* ``flushDocumentCache`` flushes the XML document cache.

* ``flushXMLCache`` flushes both the XML document and XSLT caches.

Attributes/Options
^^^^^^^^^^^^^^^^^^

.. list-table ::
   :widths: 20 80 8
   :header-rows: 1

   * - Name
     - Description
     - Required 
   * - xmlManager
     - Regular expression matching the names of XML managers that should be flushed. 

       Exception is raised if no matching XML manager was found.

       Defaults to ".*" (matches all XML managers).
     - No

Examples
^^^^^^^^

Flush the document cache of the default XML manager.

.. code-block:: bat

   dpbuddy flushDocumentCache -xmlManager "def.*"

.. code-block:: xml

   <dp:flushXMLCache xmlManager="def.*"/>

You can find more examples under ``samples`` in your distribution or `online <http://myarch.com/dpbuddy-examples-cache>`_.

.. _AAA:

``flushAAACache``
-----------------

This task flushes the AAA policy cache.

Attributes/Options
^^^^^^^^^^^^^^^^^^
     
.. list-table ::
   :widths: 20 80 8
   :header-rows: 1

   * - Name
     - Description
     - Required 
   * - policy
     - Regular expression matching the names of AAA policies that should be flushed. 

       Exception is raised if no matching AAA policy was found.

       Defaults to ".*" (matches all AAA policies).
     - No
     
Examples
^^^^^^^^

Flush "test" AAA policy.

.. code-block:: xml

   <dp:flushAAACache policy="Test.*"/>

.. _miscCache:
   
``flushMiscCache``
------------------

This task allows you to flush the following DataPower caches: DNS, RBM and ND (neighbor discovery).

Attributes/Options
^^^^^^^^^^^^^^^^^^

.. list-table ::
   :widths: 20 80 8
   :header-rows: 1

   * - Name
     - Description
     - Required     
   * - cacheTypes
     - Comma-delimited list of cache types. A cache type must be one of the following: DNS, RBM or ND.

       Flushing the RBM cache removes all cached user names and passwords from memory.
     - Yes
     
.. _allCache:

``flushAllCache``
-----------------

This task invokes ``flushXMLCache``, ``flushAAACache`` and ``flushMiscCache`` tasks. 

``flushXMLCache`` and ``flushAAACache`` are invoked with ".*" regexp to flush all XML managers and AAA policies. ``flushMiscCache`` is invoked with the RBM and DNS cache types.