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

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

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

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

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

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

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

    12 <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

    13 

    14 MsvInitialCacheCreation = 40

    15 

    16 MsvCacheIncrement = 20

    17 

    18 MsvCacheThreshold = 70

    19 

    20 MsvSearchSortCachePercentage = 20</codeblock> </section> </conbody></concept>