DynaCacheInvalidation command

This is a scheduled command that can be invoked on a URL. It invalidates entries in the WebSphere Application Server dynamic cache, where the cached page's dependency ID, cache ID, or template is read from the CACHEIVL table. The default cache invalidation interval is 10 minutes. You can change this default in the WebSphere Commerce Administration Console. In addition, this command can be invoked as a URL given the startTime and startNanos parameters together or given the clear parameter alone. To execute this command on the URL, you need to logon to your store with as a WebSphere Commerce site administrator.

Command structure

http://host_name/path/
The fully qualified name of your WebSphere Commerce Server and the configuration path.

Diagram of the command structure: the command starts with the fully qualified name of your WebSphere Commerce Server and the configuration path, followed by the command name, DynaCacheInvalidation  and the ? character. End the command with a list of parameters in the form of name value pairs. Separate each name value pair with the & character. For a detailed description of the parameters and their values, refer to the list entitled Parameter values.

Parameter values

startTime|startNanos
The startTime and startNanos parameters are used to query the latest unprocessed rows in the CACHEIVL table. These parameters are used to construct a unique timestamp object using a milliseconds time value that can be used for the query. The timestamp value is the time that has elapsed since January 1, 1970, 00:00:00 GMT in milliseconds. When the DynaCacheInvalidation scheduled command first runs, startTime and startNanos are set to 0 (zero).
startTime=milliseconds
This parameter is any positive integer that represents the integral part of the timestamp in milliseconds.
startNanos=nanoseconds
This parameter is any positive integer that represents the fractional part of the timestamp in nanoseconds.
clear=true
The value of this parameter is always set to "true". The command will invoke the corresponding API to clear all the contents in the dynamic cache. Any other values are ignored.

Note: Normally you specify either the startTime and startNanos parameters together, or the clear parameter by itself. If you specify all three parameters, the command takes the clear parameter.

Example

The following example invalidates the cached pages in the CACHEIVL table for all rows beginning from the first row:

 http://host_name/path/DynaCacheInvalidation?startTime=0&startTimeNanos=0

The following example clears all the cached pages in the dynamic cache:

 http://host_name/path/DynaCacheInvalidation?clear=true

Behavior

For more information on Dynamic caching see the chapter on Dynamic Caching in the WebSphere Commerce Administration Guide.

Exception conditions

This command does not throw any exceptions.