Siebel Order Management Infrastructure Guide > Product Selection and Pricing Engine > About Tuning Performance of PSP >

Configuring a Clear Cache Button

The PSP cache persists until the Siebel Server is restarted, but you can force a refresh of cached data across all servers in the enterprise. In the Administration - Pricing views, Clear Cache buttons exist for this purpose, to allow administrative updates against a running system. All objects cached by PSP must support a Clear Cache button that forces this refresh of cached data.

Requirements for configuring Clear Cache buttons vary as follows:

• If the business component does not have a cache refresh key defined, a run-time event must be defined to refresh the cache. See Clear Cache Button for BusComps without a Cache Refresh Key.
• If the business component does have a cache refresh key defined, a workflow and a run-time event must be defined to refresh the cache. See Clear Cache Button for BusComps with a Cache Refresh Key.

NOTE:  Although there is a Clear Cache button in the Administration - Pricing screen, Dynamic Matrix view, the run-time event for this button is fixed. This is the Clear Cache button associated with the PSP Dynamic Look-Up Transform Cache. Do not try to configure this Clear Cache button as you would the Clear Cache button used by the PSP Generic Cache.

Clear Cache Button for BusComps without a Cache Refresh Key

In this case, you must define a run-time event to refresh the cache.

To configure a new Clear Cache button for a business component without a cache refresh key defined

1. Create a control in the desired applet in which the method invoked is EventMethodCacheRefresh.
2. Navigate to the Administration - Runtime Events screen, then Action Sets view, and create a new record in the Action Sets list.
3. Give the record a name, such as Cache Refresh BC - Applet Name.
4. Create a new record in the middle list, with the following values:
   • Name is PSP Refresh
   • Action Type is BusService
5. In the More Info form, enter the following values:
   • Business Service Name is Row Set Transformation Toolkit
   • Business Service Method is Refresh BC
   • Business Service Context is a list of business component names with commas as the separator, and with each business component name included in quotation marks. For example:

   Business Service Context ="ProcessName", "PSP Refresh Cache On Cache Key - Price List"

6. Navigate to the Administration - Runtime Events screen, then Events view, and create a new record with the following values:
   • Object Type is Applet
   • Object Name is the name of the applet referred to in Step 1
   • Event is InvokeMethod
   • Subevent is EventMethodCacheRefresh
   • Action Set Name is the name of the action set created in Step 2

Clear Cache Button for BusComps with a Cache Refresh Key

In this case, you must define a workflow and a run-time event to refresh the cache.

To configure a new Clear Cache button for a business component with a cache refresh key defined

1. Create a control in the desired applet with Method Invoked = EventMethodCacheRefresh and add the control to the desired applet web template.
2. Define the cache keys by adding user properties to the Row Set Transformation Toolkit business service, according to the format shown in Table 34, for example:

   Name:	Cache Key: Price List Item
   Value:	Price List Id

3. Create a workflow that does the following:
   1. Calls the Get Cache Key method to determine the selected cache key values.
   2. Invokes the Refresh BC On Cache Key method for each business component that shares the same cache key.

      Figure 34 shows an example of a Clear Cache workflow.

      Figure 34. Example of a Clear Cache Workflow Process

4. Navigate to the Administration - Runtime Events screen, then Action Sets view, and create a new record in the Action Sets list with a name such as Cache Refresh BC - Applet Name].
5. Create a new record in the middle list, with the following values:
   • Name is PSP Refresh
   • Action Type is BusService
6. In the More Info form, enter the following values:
   • Business Service Name is Workflow Process Manager
   • Business Service Method is RunProcess
   • Business Service Context is Process Name

     For example:

   Business Service Context = PSP Refresh Cache On Cache Key - Price List

7. Navigate to the Administration - Runtime Events screen, then Events view, and create a new record with the following values:
   • Object Type is Applet
   • Object Name is the name of the applet referred to in Step 1
   • Event is InvokeMethod
   • Subevent is EventMethodCacheRefresh
   • Action Set Name is the name of the action set created in Step 4