<?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 reference

  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

<reference id="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E" xml:lang="en"><title>Tables

for Application Developers and Phone Creators</title><shortdesc>This section lists the public tables that Symbian platform provides.

These tables are available to application developers and phone creators. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody>

<section id="GUID-9CD43AFE-62B6-4637-8F88-AB01AEC4FC73"><p>Each item in the following list shows the name of a Symbian plaform

table and the purpose of that table. Each item also states if there are limits

on the number of records the table can contain. Each entry in the Table Name

column links to the details of the structure of a record in that table.</p><table id="GUID-FF8C06C6-365D-5A0D-A1FF-07194D2C5881">

<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>

<thead>

<row>

<entry>Table Name</entry>

<entry>Description</entry>

<entry> Number of records</entry>

</row>

</thead>

<tbody>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-52230909-4652-5613-8E52-6761E948907D">Access

Point</xref>  </p> </entry>

<entry><p>Defines an Access Point. </p></entry>

<entry><p>No limit. </p></entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-D405660A-CC87-5700-90D4-5CC6343386F7">Chargecard</xref>  </p> </entry>

<entry><p>Information about the charge or credit card used to pay for the

service. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-6C3F3B79-CA04-559F-9D9D-188BE8BBF962">ConnectionPreferences</xref>  </p> </entry>

<entry><p>Information about the preferred Access Point. </p> </entry>

<entry><p>No limit but only two are used. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-430CB4B1-2AC5-5773-AA59-ED8D275D555A">DialInISP </xref>  </p> </entry>

<entry><p>Defines inbound circuit-switched connections from Internet Service

Providers. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-430CB4B1-2AC5-5773-AA59-ED8D275D555A">DialOutISP</xref>  </p> </entry>

<entry><p>Defines the outbound circuit-switched connectons to Internet Service

Providers. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-7383902B-10D2-52F3-8BDB-478CA6FB587D">GlobalSettings</xref>  </p> </entry>

<entry><p>Defines global phone settings. </p> </entry>

<entry><p>One record only. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-57197DDE-9DE0-5978-8F2F-D2E370489E3C"> IAP</xref>  </p> </entry>

<entry><p>Defines Internet Access Point settings. Each Internet Access Point

is defined as a specified service using a specified bearer. </p> </entry>

<entry><p>One record for each Access Point </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-2C3649AE-AEB1-5625-84AE-8FC2E406F604"> IncomingGPRS</xref>  </p> </entry>

<entry><p>Defines the providers for the inbound wireless connection from GPRS

service. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-AFCD9E94-411C-51E0-B2E4-F1F490199887">LANBearer </xref>  </p> </entry>

<entry><p>Defines connections that use a Local Area Network like Ethernet

or Wi-Fi. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-7230C019-50CA-52A6-A21B-EED1C6D7E60C"> LANService </xref>  </p> </entry>

<entry><p>Defines lLocal area network services. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-1988731C-4EF5-52E5-88EB-DB4B636B1597">Location</xref>  </p> </entry>

<entry><p>Defines location information like country code, area prefix etc. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-3AA68B24-193B-5C17-86E1-DA6909805353">Modembearer </xref>  </p> </entry>

<entry><p>Defines modem-based connections like Ethernet, Bluetooth and Infrared. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-303A3C65-3391-540D-B0FB-75E92DC7663E"> Network </xref>  </p> </entry>

<entry><p>Defines the information about the available networks. Each record

identifies one available network used for multi-homing (maintaining multiple

connections, sometimes over multiple technologies). </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-2C3649AE-AEB1-5625-84AE-8FC2E406F604">OutgoingGPRS </xref>  </p> </entry>

<entry><p>Defines the providers for the outbound wireless connection to GPRS

service. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-14D30617-5B76-50AA-A412-DA26FB994BF5">Proxies </xref>  </p> </entry>

<entry><p>Information about the proxy servers. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-437C4AE0-D16B-50B7-8AD8-A4E8FA5F15E5">Tier</xref>  </p> </entry>

<entry><p>This table is optional. The Symbian platform Reference Tier Manager

uses this table. </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-4109E59D-03CA-59F9-BEE6-AFD9F5DC9BA4">UmtsR99QoSAndOn</xref>  </p> </entry>

<entry><p>Information about Quality of Service (QoS ). </p> </entry>

<entry><p>No limit. </p> </entry>

</row>

</tbody>

</tgroup>

</table></section>

<section id="GUID-257F5AF4-3833-5994-B891-6E28625CF8E0"><title>Structure of

records in the tables</title> <p>This section describes the structure of the

records that make the Symbian platform defined tables. </p> <p>Each section

contains the following information: </p> <ul>

<li id="GUID-C8FA6D93-6CC7-584A-82DC-A85E63C303D3"><p>the name of the Symbian

platform class that defines the <xref href="GUID-231840A2-255B-5200-8AD1-1D7667FCB448.dita">record</xref>.

The data members of the class define the fields and the links to other records. </p> </li>

<li id="GUID-7C90A227-D85E-588D-A4A4-CE0B76ECEC99"><p>the symbol that defines

the <xref href="GUID-6DAF85AD-E412-5823-81C2-FC1755A90A84.dita#GUID-6DAF85AD-E412-5823-81C2-FC1755A90A84/GUID-4DDD4947-D379-5B68-8DC0-B67B074FA852">unique

numeric Id</xref> that identifies the table. </p> </li>

<li id="GUID-95612672-DC88-5C86-AAAF-0BC0E97403A7"><p>information about each

field in the record: </p> <ul>

<li id="GUID-BB3432AF-0050-5361-94F0-50D4AA09EB07"><p>the name assigned to

the field </p> </li>

<li id="GUID-6B456F60-A379-54A2-94CE-2957D71A268D"><p>the description of the

field </p> </li>

<li id="GUID-25F75336-9BB9-5E59-AACC-0C87900FEC2C"><p>the name of the data

member that represents the field or the link to another record. </p> </li>

<li id="GUID-F042B889-8391-5944-9ECC-76804795D478"><p>the symbol that defines

the <xref href="GUID-6DAF85AD-E412-5823-81C2-FC1755A90A84.dita#GUID-6DAF85AD-E412-5823-81C2-FC1755A90A84/GUID-4DDD4947-D379-5B68-8DC0-B67B074FA852">unique

numeric Id</xref> that identifies the field. </p> </li>

<li id="GUID-AEF4A880-4C1D-5B74-BACF-1C1E10B8C9AA"><p>the type of value that

are assigned to the field. For example: Integers, Enums, Booloeans, Text,

etc </p> </li>

<li id="GUID-71CF4BCF-0E99-5FBA-BB20-2027A67C8488"><p>The range of values

or the set of values that the field can hold. </p> </li>

</ul> </li>

</ul> </section>

<section id="GUID-52230909-4652-5613-8E52-6761E948907D"><title>Access Point</title> <p>This

table defines an <xref href="GUID-A1148010-887F-549D-9DA0-D36FF4661FFE.dita">Access

Point</xref>. This table replaces the <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-57197DDE-9DE0-5978-8F2F-D2E370489E3C">IAP

table</xref>. </p> <p><b> Name

of the class that defines the structure of a record in this table </b> </p> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>CCDAccessPointRecord</apiname></xref>  </p> <p><b> Symbol that defines the unique numeric ID for the table </b> </p> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdAccessPointRecord</apiname></xref>  </p> <p><b>List of fields that define a record for this table </b> </p> <table id="GUID-48AF7218-D68B-509D-96A0-13BEA7951EFA">

<tgroup cols="6"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/><colspec colname="col4"/><colspec colname="col5"/>

<thead>

<row>

<entry>Field name</entry>

<entry>Description</entry>

<entry>Name of the class data member</entry>

<entry>Symbol defining the unique numeric Id of the field</entry>

<entry>Field value type</entry>

<entry> Possible Values</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>Tier </p> </entry>

<entry><p>The Tier that controls this access point </p> </entry>

<entry><p> <codeph>iTier</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdTier</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>The Id of a Tier in the <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-437C4AE0-D16B-50B7-8AD8-A4E8FA5F15E5">Tier</xref> table. </p> </entry>

</row>

<row>

<entry><p>MCpr </p> </entry>

<entry><p>A link to the MCPR table </p> </entry>

<entry><p> <codeph>iMCpr</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdMCpr</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>The Id of an <xref href="GUID-CF890168-0FCA-5BFD-AC86-E355B611A6B0.dita">MCpr</xref> in

the <xref href="GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1.dita#GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1/GUID-89580412-F28B-559B-B75E-49A0C8677B03">MCPR

table</xref>. </p> </entry>

</row>

<row>

<entry><p>Cpr </p> </entry>

<entry><p>A link to the CPR table </p> </entry>

<entry><p> <codeph>iCpr</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdCpr</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>The Id of a <xref href="GUID-E3E4E9A1-359E-5475-A355-1DA446FE7170.dita">Cpr</xref> in

the <xref href="GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1.dita#GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1/GUID-5EA551C3-CCB1-5BB2-9B27-6AD46FD3DA00">CPR

table</xref>. </p> </entry>

</row>

<row>

<entry><p>SCpr </p> </entry>

<entry><p>A link to the SCPR table </p> </entry>

<entry><p> <codeph>iSCpr</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdSCpr</apiname></xref>  </p> </entry>

<entry><p>Enum </p> </entry>

<entry><p>The Id of an <xref href="GUID-E3E4E9A1-359E-5475-A355-1DA446FE7170.dita">SCpr</xref> in

the <xref href="GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1.dita#GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1/GUID-08B57B63-09AB-5823-85E3-4614859BF35E">SCPR

table</xref>. </p> </entry>

</row>

<row>

<entry><p>Protocol </p> </entry>

<entry><p>A link to the Protocol table </p> </entry>

<entry><p> <codeph>iProtocol</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdProtocol</apiname></xref>  </p> </entry>

<entry><p>Enum </p> </entry>

<entry><p>The Id of a Protocol (<xref href="GUID-F8069628-BD32-535C-963A-A1CF8172E275.dita#GUID-F8069628-BD32-535C-963A-A1CF8172E275/GUID-832AD765-692C-56BE-92AC-AF8AEFB69413">Flow</xref>)

in the <xref href="GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1.dita#GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1/GUID-38030834-D957-5F72-BFB8-BAFD1AABEA87">Protocol

table</xref>. </p> </entry>

</row>

<row>

<entry><p>AppSID </p> </entry>

<entry><p>An integer that defines the SID (secure Id) of the only client application

that can use this Access Point. If this field is null, zero or empty, any

client can use this Access Point </p> </entry>

<entry><p> <codeph>iAppSID</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdAppSID </apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>When not needed, set to zero (0). </p> </entry>

</row>

<row>

<entry><p>SelectionPolicy </p> </entry>

<entry><p>Optional. Provides the selection policy for this access point. This

field replaces IAPSelectionPolicy. The value is interpreted by the MCPR. For

example, in the reference MCPRs this value refers to a RecordId in the <xref href="GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1.dita#GUID-FD0779D4-7B98-50A9-A2ED-2F3CA5EE51C1/GUID-ED2B57CA-DF29-5157-8DB6-EABCE8446718">AP

Priority Selection Policy Table</xref>  </p> </entry>

<entry><p> <codeph>iSelectionPolicy</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdSelectionPolicy</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>Dependent on MCPR implementation. </p> </entry>

</row>

<row>

<entry><p>CprConfig </p> </entry>

<entry><p>Optional. This field provides additional information about the Layer

that is understood by the Layer. For example, it can refer to a row in a table

the MCPR knows about that holds meta-data for the MCPR and all the other providers

needed to build the layer </p> </entry>

<entry><p> <codeph>iCprConfig</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTId CprConfig </apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>Dependent on Layer implementation. </p> </entry>

</row>

<row>

<entry><p>ConfigAPIdList </p> </entry>

<entry><p>Optional. A string that identifies one or more Configuration Access

Points for this Access Point </p> </entry>

<entry><p> <codeph>iConfigAPIdList</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdConfigAPIdList</apiname></xref>  </p> </entry>

<entry><p>Short Text </p> </entry>

<entry/>

</row>

</tbody>

</tgroup>

</table> </section>

<section id="GUID-D405660A-CC87-5700-90D4-5CC6343386F7"><title>Chargecard

table</title> <p>This table contains the details of the user account used

to pay for services. This is an optional table. </p> <p><b> Name

of the class that defines the structure of a record in this table </b> </p> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>CCDChargecardRecord</apiname></xref>  </p> <p><b> Symbol that defines the unique numeric ID for the table </b> </p> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdChargecardRecord</apiname></xref>  </p> <p><b>List of fields that define a record for this table </b> </p> <table id="GUID-12159945-B6A4-5104-8ABF-DB30A255B071">

<tgroup cols="6"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/><colspec colname="col4"/><colspec colname="col5"/>

<thead>

<row>

<entry>Field name</entry>

<entry>Description</entry>

<entry>Name of the class data member</entry>

<entry>Symbol defining the unique numeric Id of the field</entry>

<entry>Field value type</entry>

<entry> Possible values</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>AccountNumber </p> </entry>

<entry><p>The account number of the user. </p> </entry>

<entry><p> <codeph>iAccountNumber</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdAccountNo</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>A valid account number </p> </entry>

</row>

<row>

<entry><p>Pin </p> </entry>

<entry><p>The PIN of the account. The pin is masked by <b>*</b> characters </p> </entry>

<entry><p> <codeph>iPin</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdPin</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>A valid PIN </p> </entry>

</row>

<row>

<entry><p>LocalRule </p> </entry>

<entry><p>A rule that defines the order in which the account information is

used for local calls. This depends on the Network operator </p> </entry>

<entry><p> <codeph>iLocalRule</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdLocalRule</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>Operator dependent rule </p> </entry>

</row>

<row>

<entry><p>NatRule </p> </entry>

<entry><p>A rule that defines the order in which the account information is

used for national calls. This depends on the Network operator </p> </entry>

<entry><p> <codeph>iNatRule</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdNatRule</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>Operator dependent rule &lt;/p&gt; </p></entry>

</row>

<row>

<entry><p>IntlRule </p> </entry>

<entry><p>A rule that defines the order in which the account information is

used for international calls. This depends on the Network operator </p> </entry>

<entry><p> <codeph>iIntlRule</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdIntlRule</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>Operator dependent rule </p> </entry>

</row>

</tbody>

</tgroup>

</table> </section>

<section id="GUID-14D30617-5B76-50AA-A412-DA26FB994BF5"><title>Proxies</title> <p>This

table contains the details of a proxy server. This table is optional and is

defined when a proxy server is used. </p> <p><b> Name

of the class that defines the structure of a record in this table </b> </p> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>CCDProxiesRecord</apiname></xref>  </p> <p><b> Symbol that defines the unique numeric ID for the table </b> </p> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdProxiesRecord</apiname></xref>  </p> <table id="GUID-C8E7260A-1012-529A-A7B7-7104ED284D15">

<tgroup cols="6"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/><colspec colname="col4"/><colspec colname="col5"/>

<thead>

<row>

<entry>Field name</entry>

<entry>Description</entry>

<entry>Name of the class data member</entry>

<entry>Symbol defining the unique numeric Id of the field</entry>

<entry>Field value type</entry>

<entry> Possible values</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>ISP </p> </entry>

<entry><p>The information about the ISP </p> </entry>

<entry><p> <codeph>iService</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdISP</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>A reference to a record in the service table specified by the ProxyServiceType

field </p> </entry>

</row>

<row>

<entry><p>ProxyServiceType </p> </entry>

<entry><p>The service table information </p> </entry>

<entry><p> <codeph>iServiceType</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdProxyServiceType</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>Name of the service table used such as DialOutISP, IncomingGPRS,etc </p> </entry>

</row>

<row>

<entry><p>UseProxyServer </p> </entry>

<entry><p>A boolean flag that indicates whether to use a proxy server </p> </entry>

<entry><p> <codeph>iUseProxyServer</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdUseProxyServer</apiname></xref>  </p> </entry>

<entry><p>Boolean </p> </entry>

<entry><p>TRUE - use the proxy server </p> <p>FALSE - do not use the proxy

server </p> </entry>

</row>

<row>

<entry><p>ProtocolName </p> </entry>

<entry><p>The name of the protocol that can be used by the proxy server </p> </entry>

<entry><p> <codeph>iProtocolName</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdProtocolName</apiname></xref>  </p> </entry>

<entry><p>Short text </p> </entry>

<entry><p>User defined protocol name such as Http </p> </entry>

</row>

<row>

<entry><p>ProxyServerName </p> </entry>

<entry><p>The name of the proxy server used if any </p> </entry>

<entry><p> <codeph>iServerName</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdServerName</apiname></xref>  </p> </entry>

<entry><p>Long text </p> </entry>

<entry><p>Proxy server's URL </p> </entry>

</row>

<row>

<entry><p>PortNumber </p> </entry>

<entry><p>The port number used by the proxy server </p> </entry>

<entry><p> <codeph>iPortNumber</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdPortNumber</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p>A port number </p> </entry>

</row>

<row>

<entry><p>Exceptions </p> </entry>

<entry><p>A list of addresses for which the proxy server should not be used </p> </entry>

<entry><p> <codeph>iExceptions</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdExceptions</apiname></xref>  </p> </entry>

<entry><p>Long text </p> </entry>

<entry><p>URL address separated by semicolon </p> </entry>

</row>

</tbody>

</tgroup>

</table> </section>

<section id="GUID-6C3F3B79-CA04-559F-9D9D-188BE8BBF962"><title>Connection

preferences table</title> <p>The Comms Database has many Internet Access Points

(IAP) that represent possible network connections. The Connection Preferences

table is lists the IAPs in order of preference. If the device cannot connect

to the most preferred network, the device tries to connect to the next network

in the list. </p> <p>For example, a device can try a GSM connection if a a

GPRS connection is not available. </p> <title> Name

of the class that defines the structure of a record in this table </title> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>CCDConnectionPrefsRecord</apiname></xref>  </p> <title> Symbol that defines the unique numeric ID for the table </title> <p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdConnectionPrefsRecord</apiname></xref>  </p> <title>List of fields that define a record for this table </title> <table id="GUID-0D95F8B1-C380-514C-9EEC-24D96C2539C4">

<tgroup cols="6"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><colspec colname="col3"/><colspec colname="col4"/><colspec colname="col5"/>

<thead>

<row>

<entry>Field name</entry>

<entry>Description</entry>

<entry>Name of the class data member</entry>

<entry>Symbol defining the unique numeric Id of the field</entry>

<entry>Field value type</entry>

<entry>Possible values</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>Ranking </p> </entry>

<entry><p>This field defines the order of preference. </p> <p>A value of 1

is the highest; a value of 2 is the next highest etc. </p> <p>A value of 0

means that the connection information is stored in this table. It is not used

to make connections. </p> <p>For inbound connections the CommsDat API limits

the value to 0 or 1. Only one record with the value 1 is allowed. There is

no limit on the number of records with the value 0. </p> <p>For outbound connections

the maximum value is the value in the <xref href="GUID-387A8240-0765-52F2-98A4-8F9FC809E03E.dita#GUID-387A8240-0765-52F2-98A4-8F9FC809E03E/GUID-7383902B-10D2-52F3-8BDB-478CA6FB587D">GlobalSettings</xref> table. Only one record with the value 1 is allowed. Only one record with

the value 2 is allowed etc. There is no limit on the number of records with

the value 0. </p> <p>Multiple records with the same ranking (except for 0)

and the same direction are not allowed. There is no limit on the number of

records with the value 0. </p> </entry>

<entry><p> <codeph>iRanking</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdRanking</apiname></xref>  </p> </entry>

<entry><p>Integer </p> </entry>

<entry><p><table id="GUID-7B33A1CF-7517-5431-A67A-144146B6E5FB">

<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>

<thead>

<row>

<entry> CED value </entry>

<entry> Description </entry>

</row>

</thead>

<tbody>

<row>

<entry><p>1</p> </entry>

<entry><p>First choice </p> </entry>

</row>

<row>

<entry><p>2</p> </entry>

<entry><p>Second choice </p> </entry>

</row>

<row>

<entry><p>0</p> </entry>

<entry><p>Not used </p> </entry>

</row>

</tbody>

</tgroup>

</table> </p> </entry>

</row>

<row>

<entry><p>Direction </p> </entry>

<entry><p>Indicates the direction of the data </p> </entry>

<entry><p> <codeph>iDirection</codeph>  </p> </entry>

<entry><p> <xref href="GUID-1CDD0B97-8B00-3373-9908-512C9BC1CF51.dita"><apiname>KCDTIdDirection</apiname></xref>  </p> </entry>

<entry><p>Enum </p> </entry>

<entry><p><table id="GUID-4E8A1569-B068-585A-8FF9-60DB2C564F38">

<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>

<thead>

<row>

<entry> CED value </entry>

<entry> Description </entry>

<entry>Database value</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>Incoming </p> </entry>

<entry><p>Inbound connection </p> </entry>

<entry><p>TCommDbConnectionDirection::ECommDbConnectionDirectionIncoming </p> </entry>

</row>

<row>

<entry><p>Outgoing </p> </entry>

<entry><p>Outbound connection </p> </entry>

<entry><p>TCommDbConnectionDirection::ECommDbConnectionDirectionOutgoing </p> </entry>

</row>

<row>

<entry><p>UNKNOWN </p> </entry>

<entry><p>Connection direction is unknown </p> </entry>

<entry><p>TCommDbConnectionDirection::ECommDbConnectionDirectionUnknown </p> </entry>

</row>