Using the Clear Cache Value command

Use the Clear Cache Value command to submit a search key and clear its related value from the caches of all nodes in the cluster. The clearing is achieved by invalidating the cache value for the key, ensuring that the cached key value will not be used.

The same set of keys can be searched for and used to clear a cache value as to dump a cache value. For more information, see Search key formats.

Sample logged request and response using user search key

When you clear the cache, the response received the first time differs from subsequent times. The first use of the tool gives a result similar to the following request and response:

Request:

[6/23/14 12:20:17:742 EDT] 0000007f diagnostics I [http:192.0.2.0:34689
admin@EXAMPLE.LOCAL] Broadcasting clear cache value request for key: (User
loginName "CustomerLoginName@EXAMPLE.LOCAL")

Response:

[6/23/14 12:20:17:748 EDT] 00000046 diagnostics I [ObjectSystemQueue
admin@EXAMPLE.LOCAL] Invalidating 1 item in the global cache keyed by: (User
loginName "CustomerLoginName@EXAMPLE.LOCAL")

After you clear the cache value, however, a second search on the same key will result in an invalid cache instance with the GenericDataCache$RemoveRef being returned, as shown in the following request and response:

Request:

[6/23/14 12:21:04:854 EDT] 0000007f diagnostics I [http:192.0.2.0:34691
admin@EXAMPLE.LOCAL] Broadcasting dump cache value request for key: (User
loginName "CustomerLoginName@EXAMPLE.LOCAL")

Response:

[6/23/14 12:21:04:876 EDT] 00000057 diagnostics I [ObjectSystemQueue
admin@EXAMPLE.LOCAL] Cached reference for key: (User loginName
"CustomerLoginName@EXAMPLE.LOCAL")
GenericDataCache$RemovedRef@20840766{key=(User loginName
"CustomerLoginName@EXAMPLE.LOCAL"), Tx timestamp=2014-06-23 12:20:17.749,
value=java.lang.Object@49f249f2}
[6/23/14 12:21:31:988 EDT] 00000082 diagnostics I [http:192.0.2.0:34692
admin@EXAMPLE.LOCAL] Broadcasting dump cache value request for key: ExampleClassName
0xE76E32CC3130411F887BD983C63E9E96