Siebel Order Management Infrastructure Guide > PSP 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, then the Attribute Adjustments 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 where the method invoked is EventMethodCacheRefresh.
2. Navigate to the Administration - Runtime Events screen, then the Action Sets view, and create a new record in the Action Sets list applet.
3. Give the record a name, such as "Cache Refresh BC - Applet Name".
4. Create a new record in the middle list applet, with the following values:
   • Name is PSP Refresh
   • Action Type is BusService
5. In the More Info form applet (at the bottom), 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

     Example:

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

6. Navigate to the Administration - Runtime Events screen, then the 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 where the Method Invoked is EventMethodCacheRefresh, 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 25, for example:

   Property	Value
   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 33 shows an example of a Clear Cache workflow.

      Figure 33. Example of a Clear Cache Workflow Process

4. Navigate to the Administration - Runtime Events screen, then the Action Sets view, and create a new record in the Action Sets list applet with a name such as "Cache Refresh BC - Applet Name".
5. Create a new record in the middle list applet, with the following values:

   Property	Value
   Name	PSP Refresh
   Action Type	BusService

6. In the More Info form applet (at the bottom), enter the following values:

   Property	Value
   Business Service Name	Workflow Process Manager
   Business Service Method	RunProcess
   Business Service Context	Process Name

   For example:

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

7. Navigate to the Administration - Runtime Events screen, then the Events view, and create a new record with the following values:

   Property	Value
   Object Type	Applet
   Object Name	The name of the applet referred to in Step 1
   Event	InvokeMethod
   Subevent	EventMethodCacheRefresh
   Action Set Name	The name of the action set created in Step 4