Rating Management parameters

Guidewire provides the following configuration parameters in the config.xml file that relate to Guidewire Rating Management.
Important: To determine whether your Guidewire PolicyCenter license agreement includes Guidewire Rating Management, contact your Guidewire sales representative. Rating Management requires an additional license key. For instructions on obtaining and installing this key, contact your Guidewire support representative.

EnableRateRoutinesJar

Set this Boolean parameter to true if you want rate routines to be preloaded from the rate routines JAR file at system startup. This parameter also enables the Generate JAR File and Download JAR File buttons on the Rate Books screen.

If you enable this parameter, then you must also specify the location in the RateRoutinesJarFile parameter.

Note:

The precompile rate routine JAR file feature is not supported on JBoss application servers.

Default: false

See also

OverriddenTableArgsLabelSimple

You can speed up rate table preloading by setting the parameter OverriddenTableArgsLabelSimple to true. (The RateBookPreloadEnabled parameter must also be true.)

When true, when viewing a rate routine on the Rate Routine screen, parameters in rate routine steps may appear as ellipses (...).

RateBookCacheUpdateIntervalSecs

The time in seconds after which the rate book cache is rebuilt: all non-active rate books are refreshed and any rate books added after the last update are added to the cache.

Default: 307

RateBookExportResultAgeForPurging

Purge Rate Book Export Result batch processing removes from the PolicyCenter database RateBookExportResult Excel and XML files that have been around for more days than this parameter.

Default: 60

See also

RateBookPreloadEnabled

This parameter determines whether to load Rating Management components on system startup. If true, PolicyCenter loads all rate books and their associated rate routines and rate tables on system startup.

Note: Unrelated to whether this parameter is true or false, PolicyCenter always preloads some parts of rate books that load quickly. After this, PolicyCenter writes this message to the log file:
INFO Application.Rating.RateTableManagement Preloading all ratebooks
Therefore, this message is not an indication of the RateBookPreloadEnabled parameter setting.

Default: true

See also

RateRoutineIndexingThreshold

When editing a long rate routine, you can edit the rate routine by section. A long rate routine has more steps than the value of the indexing threshold, the RateRoutineIndexingThreshold parameter.

Default: 150

See also

RateRoutinesJarFile

Specify the file system location of the rate routines JAR file. May be an absolute path or path relative to the web application root. For allowed locations, see Deploying non-OSGi Java classes and JAR files. Guidewire recommends that you deploy the JAR file in the following location:

modules/configuration/plugins/Gosu/lib/rateroutines.jar

For example, if you are running PolicyCenter under Apache Tomcat and the WAR file expands into <TOMCAT_HOME>/webapps/pc, where <TOMCAT_HOME> is the Tomcat root directory, then set RateRoutinesJarFile to webapps/pc/modules/configuration/plugins/Gosu/lib/rateroutines.jar.

If the directory does not exist, PolicyCenter will attempt to create it. If the file exists, it must be a valid JAR file. If the file does not exist, PolicyCenter will create it if EnableRateRoutinesJar is true. If the JAR does not exist at startup, PolicyCenter compiles all rate routines in the rate books returned by the RateBookPreloadPlugin to the JAR. To avoid this delay during startup, deploy the JAR file to the production system when you build PolicyCenter.

Note:

The precompile rate routine JAR file feature is not supported on JBoss application servers.

See also

RateRoutinesUpdateJarFile

Specify the location of the rate routines JAR file that is updated dynamically while PolicyCenter is running. If you specify this parameter, PolicyCenter modifies the file referred to by it whenever an update event happens. If you do not specify this parameter, PolicyCenter updates the file pointed to by RateRoutinesJarFile.

Note:

You must use this parameter if you are running PolicyCenter on Windows Server.

For allowed locations, see Deploying non-OSGi Java classes and JAR files. Guidewire recommends that you deploy the JAR file in the following location:

modules/configuration/plugins/Gosu/lib/rateroutines_update.jar

If the directory does not exist, PolicyCenter attempts to create it.

Modify the startup process

If you specify RateRoutinesUpdateJarFile, the JAR file must not exist at system startup. If it exists, PolicyCenter throws an exception and fails to start. Therefore, perform these steps before starting the server:
  1. If the file specified by RateRoutinesUpdateJarFile exists, then copy it to the file specified by RateRoutinesJarFile.
  2. Delete the file specified by RateRoutinesUpdateJarFile.
  3. Start the server.
For example, the following Windows shell script starts the server on Tomcat:
SET ROUTINES_JAR = %TOMCAT_HOME%\webapps\pc\modules\configuration\plugins\gosu\lib\rateroutines.jar
SET UPDATE_JAR=%TOMCAT_HOME%\webapps\pc\modules\configuration\plugins\gosu\lib\rateroutines_update.jar
IF EXIST %UPDATE_JAR% {
  del %ROUTINES_JAR%
  ren %UPDATE_JAR% %ROUTINES_JAR%
}
%TOMCAT_HOME%\bin\startup.bat

RateTableManagementNormalizationRowLimit

PolicyCenter determines whether to normalize a rate table if the table contains this many rows or more.

If the number of rows in the normalized table would exceed this limit, the table is automatically marked as non-normalizable. PolicyCenter stores the non-normalized version of the table.

Default: 10000

See also

RateTableManagementNormalizationRowThreshold

If the number of rows in the normalized table would exceed this threshold, the user is given the option to store a non-normalized version of the table.

Default: 1000

See also

RatingWorksheetContainerAgeForPurging

The Purge Rating Worksheets batch process uses this parameter as one factor in determining if a worksheet container can be purged. To be considered for purging, the worksheet container’s job must have been completed at least RatingWorksheetContainerAgeForPurging days.

Default: 90

See also

RTMCacheMaxDuration

Upper bound on how often caches of RateBook and RateTableDefinition entities are refreshed, measured in seconds. This parameter addresses an issue with cluster installations.

The caches are refreshed when these entities are updated in the global cache. However, in a cluster installation, there is a possibility that messages for these updates can be lost. If the cache is not up-to-date, operations that depend upon these entities will fail. Keep in mind that rate books and rate table definitions are both versioned. So if, during quoting, a rate routine references a version that is not in the cache, the rate routine will fail.

To handle this, PolicyCenter forces a refresh of the caches based on this maximum duration. Cache refresh can happen in the middle of other operations. During refresh, the performance of operations that depend upon these entities, such as quoting, will be impacted.

The maximum value is 2147483. Do not set it any higher or the system will refresh the caches on each request.

Default: 600 seconds

SmallRateTableRowLimit

Before importing rate tables, PolicyCenter scans the import file. The scan does not examine rate tables with more rows than specified in SmallRateTableRowLimit.

Default: 10000