<?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 id="GUID-B79B6DD2-40C5-591B-AF56-5ACD167C66F5" xml:lang="en"><title>Installing

an MTM</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>This section explains how to install MTMs during build time to include

them in ROM and how to install MTMs at run time on to a target phone (not

in ROM). </p>

<section><title>Build time</title> <p>To install an MTM during build time,

complete the following steps: </p> <ol id="GUID-69A643BE-D84D-5799-AC9B-DE4909FC474A">

<li id="GUID-4D566FC3-1D68-52A6-B089-20D10FDD86E4"><p>Build the MTM DLLs to

a <filepath>\sys\bin</filepath> directory on any drive. For example, <filepath>c:\sys\bin</filepath>. </p> </li>

<li id="GUID-1FD3BE6E-75CB-52E9-9437-1F099DE63777"><p>Build the MTM resource

file to <filepath>resource\messaging\mtm</filepath>. </p><note> You can do

this manually or use the mmp file syntax to export it to the <filepath>\resource\messaging\mtm</filepath> directory

automatically at build time.</note> </li>

</ol> <p><b>Example</b> </p> <codeblock id="GUID-90D8E09C-7F3D-5D07-8056-083A0EAC1486" xml:space="preserve">// mtm.mmp

//

/**

@file

@SYMPurpose mtm.dll

*/

TARGET        mtm.dll

TARGETTYPE    dll

TARGETPATH    sys/bin

CAPABILITY    ReadDeviceData WriteDevicedata 

UID        0x1000008d 0x10204286

VENDORID    0x70000001

SOURCEPATH    ../src

USERINCLUDE     ../inc

SYSTEMINCLUDE    /epoc32/include 

LIBRARY        euser.lib 

LIBRARY        msgs.lib 

LIBRARY        bafl.lib 

LIBRARY        efsrv.lib 

SOURCEPATH    .

start resource mtm.rss

TARGET        mtm.rsc

TARGETPATH  resource/messaging/mtm

end

</codeblock> </section>

<section><title>Run time</title> <p>After creating a group of MTMs, you have

to write an MTM installation application to install and register the MTMs

with the Message Server using the <xref href="GUID-92D6CC11-C597-5D00-AAE5-866289B7462F.dita">MTM

resource file</xref>. A program to do this would typically be run at the end

of installation. </p> <p><b>Procedure</b> </p> <p>To install an MTM at run

time on to a target phone, complete the following steps: </p> <ol id="GUID-33B69DC3-8A6B-585F-BE2F-F8484CACAC4C">

<li id="GUID-209A4F6B-05D8-5F3E-979B-B28153FD66F9"><p>Create a session with

the Message Server using the <xref href="GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B.dita"><apiname>CMsvSession</apiname></xref> class. </p> </li>

<li id="GUID-ECF08244-F9C6-582D-8A90-1387D627E5B8"><p>Call <xref href="GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B.dita#GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B/GUID-E6553712-78CF-366C-B72A-5B673616C1A0"><apiname>CMsvSession::InstallMtmGroup()</apiname></xref> to

install a new group of MTMs. </p> <p> <b> Result:</b> The <xref href="GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B.dita#GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B/GUID-E6553712-78CF-366C-B72A-5B673616C1A0"><apiname>CMsvSession::InstallMtmGroup()</apiname></xref> function

notifies the Message Server about the availability of a new MTM. When this

is done, all running client processes are also notified about the availability

of a new MTM. </p> <codeblock id="GUID-5CEEAD15-9165-5346-99B8-FB80240438E6" xml:space="preserve">// Creating a Message Server session

CDummyObserver ob;

iSession=CMsvSession::OpenSyncL(ob);

CleanupStack::PushL(iSession);

//Install an MTM using a resource file

iSession-&gt;InstallMtmGroup(ResourceFileName);</codeblock> </li>

</ol> <p>To remove an MTM, call the <xref href="GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B.dita#GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B/GUID-808E9D5B-9F41-3450-B48C-3312E4296E8E"><apiname>CMsvSession::DeInstallMtmGroup()</apiname></xref> function. </p> <p> <b>Result:</b> The <xref href="GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B.dita#GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B/GUID-808E9D5B-9F41-3450-B48C-3312E4296E8E"><apiname>CMsvSession::DeInstallMtmGroup()</apiname></xref> function dynamically notifies the running client processes about the non-availability

of the MTM. </p><note> The <xref href="GUID-C8FBC95B-223A-31E5-8D4C-D45B61BD078F.dita"><apiname>InstallMtmGroup()</apiname></xref> and <xref href="GUID-D32B5980-3046-31D7-A516-5556B4FED834.dita"><apiname>DeInstallMtmGroup()</apiname></xref> functions

must be used only by an MTM installation application.</note> </section>

<section><title>See also</title> <p><xref href="GUID-92D6CC11-C597-5D00-AAE5-866289B7462F.dita">MTM

Resource File</xref>  </p> </section>