FAQ-1094 How can I edit the CommDB settings of the Symbian OS emulator?


FAQ-1094 How can I edit the CommDB settings of the Symbian OS emulator?

» Symbian OS » Developer Knowledgebase » FAQ-1094

Classification:	General	Category:	Development
Created:	07/21/2004	Modified:	07/23/2004
Number:	FAQ-1094
Platform:	Symbian OS v7.0, Symbian OS v7.0s, Symbian OS v8.0, Symbian OS v8.0a, Symbian OS v8.0b

Question:
How can I edit the CommDB settings Symbian OS emulator? I am looking for a tool which allows me to view and edit the CommDB settings of a Symbian OS SDK used by the emulator and create new CommDB databases.

Answer:

CommDB settings are stored in binary files using the Symbian DBMS format. The procedure to view and/or edit the contents of CommDB settings is the following:

1. Download and install the Symbian CommDB Editor from the Symbian Developer Network web site at the following link:

http://www.symbian.com/developer/downloads/tools.html#cdb

This tool allows a user to view and edit CommDB settings using an easy-to-use graphics interface and it supports Symbian OS SDKs Version 7.0
and higher.

2. Execute the CEDDUMP.EXE utility which comes with any Symbian OS SDK. This will read the binary CommDB settings file and create the text file
CEDOUT.CFG in the C: drive of the emulator. You can view and modify this file with any text editor.

3. Launch the Symbian CommDB Editor from the "Start Menu\Symbian OS Tools\Symbian CommDB Editor\Symbian CommDB Editor"
menu link.

4. Select the "Actions->Select CommDB Version" menu option of the Symbian CommDB Editor and then choose the directory which
contains the definition of the CommDB database structure for the Symbian OS appropriate for the installed Symbian SDK. For example,
if you use the Symbian OS SDK Version 7.0 then select directory "7.0".

5. Select option "Files->Import CFG File" and then point to the CEDOUT.CFG file generated in step (2) in order to load it.

6. You can now examine and modify the structure of the CommDB Tables using the "Information" and "Tables" menu items of the editor.
Note also that you can use the "Files->Export XHTML File" option in order to convert the CommDB database to a typical HTML file in
order to view it with any web browser.

7. After making changes to the CommDB settings select the "Files->Export CFG File" or "Files-Export XML File" menu options
in order to create a new CommDB configuration file, either in the CFG format or the new XML format. This file will contain the changes
made during the editing process.

8. Copy the contents of directory C:\Program Files\Common Files\Symbian\Tools\ced-tools\ to the \epoc32\tools\ directory of the
Symbian OS SDK you are currently using.

9. Execute the CED.EXE command line utility installed in step (8) with argument the name of the new CFG or XML file created
in step (7). This will create a new binary CommDB database file with the new CommDB settings.