<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept xml:lang="en" id="GUID-216CD63D-DDA8-5882-B335-3BD79F862D24"><title>Configuring the Messaging Cache</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>With SQL implementation in Messaging Framework, index entries are stored in an SQL database and only the most recently used index entries are cached in RAM. </p> <section><title>Required background</title> <p>Before you start, you must understand <xref href="GUID-2FAB8281-569A-52BE-8BC8-A2D378068706.dita">caching</xref>. </p> </section> <section id="GUID-A0D02001-E949-50A1-BB97-25F0B5D87A5E"><title>Procedure</title> <p>You can configure the cache size and other caching-related parameters using the <filepath>msgcache.ini</filepath> configuration file, located at <filepath>Z:\private\1000484b\</filepath>. The following table lists the cache configuration parameters: </p> <table id="GUID-71D321E8-8846-5715-8353-294E9287DF07"><tgroup cols="4"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/><thead><row><entry>Parameter</entry> <entry>Default value</entry> <entry>Unit</entry> <entry>Description</entry> </row> </thead> <tbody><row><entry><p> <codeph>MsvMaximumCacheSize</codeph>  </p> </entry> <entry><p>1024 </p> </entry> <entry><p>KB </p> </entry> <entry><p>The maximum size of cache. </p> </entry> </row> <row><entry><p> <codeph>MsvInitialCacheCreation</codeph>  </p> </entry> <entry><p>40 </p> </entry> <entry><p>Percent </p> </entry> <entry><p>The percentage of <codeph>MsvMaximumCacheSize</codeph> allocated to the cache during server start-up. </p> </entry> </row> <row><entry><p> <codeph>MsvCacheIncrement</codeph>  </p> </entry> <entry><p>20 </p> </entry> <entry><p>Percent </p> </entry> <entry><p>The percentage of <codeph>MsvMaximumCacheSize</codeph> allocated to cache in each subsequent allocation (after initial memory allocation). </p> </entry> </row> <row><entry><p> <codeph>MsvCacheThreshold</codeph>  </p> </entry> <entry><p>70 </p> </entry> <entry><p>Percent </p> </entry> <entry><p>The percentage of the cache that must be occupied before the next allocation is initiated. </p> </entry> </row> <row><entry><p> <codeph>MsvSearchSortCachePercentage</codeph>  </p> </entry> <entry><p>20 </p> </entry> <entry><p>Percent </p> </entry> <entry><p>The percentage of memory that should be allocated to search and sort cache. </p> </entry> </row> </tbody> </tgroup> </table> </section> <section><title>msgcache.ini example</title> <codeblock id="GUID-FEEF0743-46EC-50D9-848B-EB9C94A4202F" xml:space="preserve">MsvMaximumCacheSize = 1000

MsvInitialCacheCreation = 40

MsvCacheIncrement = 20

MsvCacheThreshold = 70