Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



mtmgen command syntax

The mtmgen command creates a messaging type module (MTM) data file based on a specified plain text configuration file. The command can also register and unregister the MTM with the Message Server.

Two versions of the mtmgen tool are provided by the SDK — WINS and WINC. On the WINC platform, you can only generate .dat files, not register and unregister MTMs.

From v6.1, both versions are invoked using a stub file which is located in the path. The command to run the tool can be executed from a Windows command prompt. The WINS version is run if -urel or -udeb is specified. The WINS version is also run if either the -u or -i flags are specified. The WINC version is run if neither -urel nor -udeb are specified and only the -g flag is set.

By default, MTMs are installed to and uninstalled from the debug Emulator.

During processing, mtmgen writes information to a file called mtmgen.txt. This file is located in the c:\logs\mtmgen\ directory which must be created before the log file can be written. Note that file locations used by mtmgen are relative to the Emulator if the WINS version is run and relative to the development PC's file system if the WINC version is run.

Invocation syntax

mtmgen [-urel|-udeb]-<flags> <path of configuration file> <path for .dat file>

-urel

Use the version of mtmgen for the release Emulator (WINS only)

-udeb

Use the version of mtmgen for the debug Emulator (WINS only) — the default

path of configuration file

The path of the configuration file

path for .dat file

The path of the output .dat file

The possible flags are:

-g

Generate a .dat file from the specified configuration file (WINS or WINC versions).

-i

Register the specified MTM with the Message Server (WINS version only).

-u

Unregister the specified MTM with the Message Server (WINS version only).

Example

The following command would create a .dat file in the directory c:\System\MTM\ based on the configuration file c:\example.cfg, unregister the MTM if is already registered, and finally register it.

> MTMGEN -ugi c:\\example.cfg c:\\System\\MTM\\