start_cache_warmup

Definition

To start the cache warm-up mechanism

Command Usage

Command Arguments

Name	Description
<INST_TARGET>	Optional: The target of the command (instance ID or instance type; only updater, guider or rater). When not specified: all updaters, raters and guiders.
<PARTITION_ID>	Optional: The target partition for the command. Only supported with targets 'guider' (0-239) and 'rater' (0-479). When not specified: all partitions.

Detailed Information

The start_cache_warmup command starts or restarts the data cache warm-up mechanism in the running instances of the SAP CC system after operations such as data migration or mass provisioning, for example, which can invalidate cached data.

To avoid latency and increase the reactivity of the SAP CC system, a warm-up mechanism is provided for the cached structures handled by the rater and guider instances of the system. This mechanism consists in:

• Retrieving all the customer master data either from the database or from another instance, depending whether the Network Data Transfer mechanism is activated, or not
• Loading this data into the related cached structures handled by the different system instances

The cache warm-up mechanism uses a loading strategy ensuring that the cached structures contain only the last versions of the master data. The CACHE_WARMUP_THREAD_COUNT system parameter allows you to activate or deactivate this mechanism.

Authorization

To work with this command in the user interface, you must have a specific role in your SAP CC user profile.

Refer to the SAP CC 5.0 Security Guide for more user assistance and information about the necessary authorizations.

Additional Information

Consult the SAP CC Application Help for more information about the data cache warm-up function.

Messages

Code	Message	Action
err.too_many_arguments	Error: The command does not accept more than 2 arguments.	Specify at most 2 arguments.
err.bad_target	Error: Bad target: {target}.	Specify a valid instance type or instance ID of type updater, guider or rater.
err.invalid_partition	Error: Invalid partition: {partitionId}.	Specify a valid partition (0-239 for instance type 'guider', 0-479 for instance type 'rater').
startCacheWarmup.ok.all	OK: The cache warm-up process has been started for all partitions.
startCacheWarmup.ok.partition	OK: The cache warm-up process has been started for partition {partitionId}.
startCacheWarmup.failed	Error: Unable to start the cache warm-up process.	Check the logs of the SAP CC system.