Comms database configuration file format

The Comms database Configuration Editor, CED, takes as input a configuration file in either text format (.cfg) or an XML format (.xml). Both contain information about the new settings for the comms database.

These files can either be created manually, or by using the CEDDUMP tool, which creates a configuration file by dumping the contents of the comms database into a .cfg file.

CED can also be used to convert between text and XML configuration files.

The text file format has the extension .cfg. This file contains the table records and settings to be edited in the comms database.

You can create/modify this file with any text editor, using the following file format (parameters are not case sensitive).

[<Table Name>]

ADD_TEMPLATE
  <Field Name>=<String>
  <Field Name>=<Boolean>
  <Field Name>=<Int>
  FIELD_COUNT=<Field Count>
END_TEMPLATE

ADD_SECTION
  <String Field Name>=<String>
  <Boolean Field Name>=<Boolean>
  <Field Name>=<Int>
  FIELD_COUNT=<Field Count>
END_ADD

where:

• ADD_TEMPLATE creates the template record. You can only include one ADD_TEMPLATE section per table.

• ADD_SECTION adds the record to the table.

• <Table_Name> is a string taken from the CDBCols.h file.

• <Field Name> is a string taken from the CDBCols.h file. The value could be any type of string, a boolean (TRUE or FALSE), or a positive integer.

• <Field Count> is the number of fields in that record definition.

If you are using an XML file as input to the CED utility, you need to use the following format:

<DialInISPTable>

<DialInISP operation="template">

<Name>Default Dial In ISP</Name>
<UseLoginScript>FALSE</UseLoginScript>
<IpAddrFromServer>TRUE</IpAddrFromServer>
<IpDNSAddrFromServer>TRUE</IpDNSAddrFromServer>
<EnableIPHeaderComp>FALSE</EnableIPHeaderComp>
<EnableLCPExtension>FALSE</EnableLCPExtension>
<DisablePlainTextAuth>FALSE</DisablePlainTextAuth>
<EnableSWComp>FALSE</EnableSWComp>
<UseEdge>FALSE</UseEdge>

</DialInISP>

<DialInISP operation="add">
<Name>Dial In CS ISP</Name>
<UseLoginScript>FALSE</UseLoginScript>
<IpAddrFromServer>TRUE</IpAddrFromServer>
<IpDNSAddrFromServer>TRUE</IpDNSAddrFromServer>
<EnableIPHeaderComp>FALSE</EnableIPHeaderComp>
<EnableLCPExtension>FALSE</EnableLCPExtension>
<DisablePlainTextAuth>FALSE</DisablePlainTextAuth>
<EnableSWComp>FALSE</EnableSWComp>
<UseEdge>FALSE</UseEdge>

</DialInISP>

</DialInISPTable>

The syntax of this XML file is specified by a set of XML Schema files which describe the structure of each comms database table and its parameters as well as the valid range of values they can receive.

The XML Schema files which define the syntax for the XML-based input file for CED are all stored in a specific directory and, therefore, different directories can be created for various Symbian OS versions.