|
||
The Comms database (CommsDat) is used to store configuration settings for network connections. This page describes the individual Comms database reference tables, the fields that can be used in those tables, and the characteristics of those fields.
See also Configuring Comms Database For Network Connections for an overview and other references.
The Comms Database contains a large number of tables, some are for internal use, some for use by device creators only, and some are available for use by anyone, this last set are known as public tables. The following are the important public tables used in the Comms database as distributed in Symbian OS. There are some restrictions on the number of records that can be created for some tables.
Table Name | Description | Number of records |
---|---|---|
Information about the charge or credit card used to pay for the service. |
Any number of records can be created |
|
Preferred Access Point information. |
Any number of records can be created but only two will be used |
|
Inbound circuit-switched connections from Internet Service Providers. |
Any number of records can be created |
|
Outbound circuit-switched connectons to Internet Service Providers. |
Any number of records can be created |
|
Global phone settings. |
Only one record should be created |
|
Internet Access Point settings each defined as a specified service using a specified bearer. |
There should be one record created for each Access Point |
|
Inbound wireless connection from GPRS service providers. |
Any number of records can be created |
|
Connections using a Local Area Network such as Ethernet or Wi-Fi. |
Any number of records can be created |
|
Local area network services. |
Any number of records can be created |
|
Location information like country code, area prefix etc. |
Any number of records can be created |
|
Modem-based connections such as Ethernet, Bluetooth and Infrared. |
Any number of records can be created |
|
Information about available networks. Each record identifies one available network used for multi-homing (maintaining multiple connections, sometimes over multiple technologies). |
One record should be created for each network |
|
Outbound wireless connection to GPRS service providers. |
Any number of records can be created |
|
Information about proxy servers used. |
Any number of records can be created |
|
QoS related information. |
Any number of records can be created |
This section describes the general structure of a reference table.
The first column Field name specifies the exact field name used in the configuration files (both CFG and XML format)
The second column Description provides a description of the field
The third column CommsDat field ID specifies the constants used to represent the fields
The fourth column Field value type specifies the type of values assigned to each field such as Integers, Enums, Booloeans, Text, etc
The fifth column Possible values specifies the possible values that can be assigned to each field, for example:
CED value
is the actual value assigned in the
configuration files
Description
provides the meaning of the value
Database value
specifies how an Enum or a Boolean
is represented in the Comms database.
The Comms database has multiple IAP's representing possible network connection choices. It allows the device to connect to another network if the attempt to connect to the first network fails. For example, to try a GSM connection if a GPRS connection is not available. The connection preferences table sets the preferred order of choice for the device. The highest priority connection should be given the ranking 1 and the next priority network connection should be given ranking 2. If the device fails to connect to the first connection, it attempts the connection with ranking 2. The other records should have ranking 0. The records with this ranking are not used by Symbian OS.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table:
KCDTIdConnectionPrefsRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible values | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Ranking |
This field is used to specify the order in which attempts at a connection should be carried out. The highest ranking is 1 and is always attempted first. If this fails, an IAP with rank 2 is then attempted. A ranking of 0 indicates that a connection preference is only being stored and is not used for connections. For incoming connections, CommsDat limits the ranking to 0 or 1. For outgoing connection preferences, the maximum ranking is the value in ConnectionAttempts field in the GlobalSettings table. Multiple records with the same ranking (except for 0) and the same direction are not allowed. |
|
KCDTIdRanking |
Integer |
|
||||||||||||||||||||||||||||||||||||
Direction |
Direction of the data |
|
KCDTIdDirection |
Enum |
|
||||||||||||||||||||||||||||||||||||
BearerSet |
Bearers used in the connection |
|
KCDTIdBearerSet |
Enum |
|
||||||||||||||||||||||||||||||||||||
DialogPref |
A flag to prompt the user of the connection. It can be set to warn the user of the connection or prompt the user with a menu to choose the connection. |
|
KCDTIdDialogPref |
Enum |
|
||||||||||||||||||||||||||||||||||||
IAP |
Integer representing the Access Point record in the IAP table |
|
KCDTIdIAPLink |
Integer |
Record id from the IAP table |
DialInISP
and DialOutISP
tables have
similar fields. These tables contain the configuration settings for the
wireline connections. This table should be configured when the applications use
a wireline connection. The DialInISP
table is configured for
inbound ISP connections, and the DialOutISP
table is configured
for outbound ISP connections using wireline.
The following table shows the values for the DialOutISP
table. The DialInISP
table has similar fields but the values
should be replaced accordingly.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for DialInISP table:
KCDTIdDialInISPRecord
.
Record ID for DialOutISP table:
KCDTIdDialOutISPRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field type | Possible values | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Description |
Description of the ISP |
|
KCDTIdDescription |
Short text |
A text description of the ISP This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
DialResolution |
Specifies whether to add additional information from the Location table such as AreaCode, NatCode to the ISP number (DefaultTelNum) to be dialled. |
|
KCDTIdDialResolution |
Boolean |
This field cannot have null value and the default value isTRUE |
||||||||||||||||||||||||||||||||||||||||||
UseLoginScript |
Enables the user to login with or without a script |
|
KCDTIdUseLoginScript |
Boolean |
This field cannot have null value and the default value isTRUE |
||||||||||||||||||||||||||||||||||||||||||
PromptForLogin |
To prompt the user to enter the login information, i.e. username and password |
|
KCDTIdPromptForLogin |
Boolean |
This field cannot be null and the default value is TRUE |
||||||||||||||||||||||||||||||||||||||||||
IfPromptForAuth |
A boolean flag to prompt for authentication by the ISP once the conection is established |
|
KCDTIdIfPromptForAuth |
Boolean |
This field cannot be null, FALSE is the default value. |
||||||||||||||||||||||||||||||||||||||||||
IpAddrFromServer |
Detrmines whether or not to get IP address from the ISP |
|
KCDTIdIpAddrFromServer |
Boolean |
This field cannot be null. This field should be set to FASLE for using static IP address |
||||||||||||||||||||||||||||||||||||||||||
IpDNSAddrFromServer |
Detrmines whether or not to get DNS address for IPv4 from the ISP |
|
KCDTIdpDNSAddrFromServer |
Boolean |
This field cannot be null, may be set to FALSE for using static DNS server address specified in IpNameServer1 and IpNameServer2 fields. |
||||||||||||||||||||||||||||||||||||||||||
Ip6DNSAddrFromServer |
Detrmines whether or not to get DNS address for IPv6 from the ISP |
|
KCDTIdIp6DNSAddrFromServer |
Boolean |
This field cannot be null, may be set to FALSE for using static DNS server address specified in Ip6NameServer1 and Ip6NameServer2 fields. |
||||||||||||||||||||||||||||||||||||||||||
Type |
Information about the browser protocol used like HTML or WML |
|
KCDTIdType |
Enum |
This field can have a null value |
||||||||||||||||||||||||||||||||||||||||||
DefaultTelNumber |
The ISP telephone number |
C |
KCDTIdDefaultTelNum |
Short text |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
LoginScript |
The login script osed to login to the ISP |
|
KCDTIdLoginScript |
Long text |
User defined |
||||||||||||||||||||||||||||||||||||||||||
LoginName |
User name to login with |
|
KCDTIdLoginName |
Short text |
User defined |
||||||||||||||||||||||||||||||||||||||||||
LoginPass |
User password to login with |
|
KCDTIdLoginPass |
Short text |
User defined |
||||||||||||||||||||||||||||||||||||||||||
Chargecard |
An optional field containing the chargecard or credit card details used to pay for the service by the user |
|
KCDTIdChargecard |
Integer |
A reference to the chargecard table record This is an optional field and can have null value |
||||||||||||||||||||||||||||||||||||||||||
DisplayPCT |
A boolean flag used whether or not to display post connection terminal |
|
KCDTIdDisplayPCT |
Boolean |
This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IfParams |
Interface parameter string used to specify the lower layer that interface protocol is to use |
|
KCDTIdIfParams |
Short text |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IfNetworks |
List of network protocols to be used by the network interface (nif) separated by comma |
|
KCDTIdIfNetworks |
Long text |
User defined. Example IP, IP6 This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IfAuthName |
Prompt user to enter authentication username used in the datalink layer. Example in PPP |
|
KCDTIdIfAuthName |
Short text |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IfAuthPass |
Prompt user to enter authentication password used in the datalink layer. Example in PPP |
|
KCDTIdIfAuthPass |
Short text |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
AuthRetries |
Number of times to retry authentication when it fails |
|
KCDTIdAuthRetries |
Short text |
User defined integer value This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IfCallbackEnabled |
A boolean flag indicating whether callback is enabled or not The process is as follows:
|
|
KCDTIdIfCallbackEnabled |
Boolean |
This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IfCallbacktype |
Information regarding the type of callback used as specified by IETF Refer to Callback Control Protocol (CBCP) and Microsoft CBCP |
|
KCDTIdIfCallBackType |
Enum |
0 is the default value |
||||||||||||||||||||||||||||||||||||||||||
IfCallbackInfo |
Callback information such as callback phone number |
|
KCDTIdIfCallbackInfo |
Binary |
User defined 0 is the default value |
||||||||||||||||||||||||||||||||||||||||||
CallbackTimeout |
Time duration to wait for ISP to callback in microseconds |
C |
KCDTIdCallbackTimeout |
Integer |
User defined. 0 is the default value |
||||||||||||||||||||||||||||||||||||||||||
IpAddr |
Static IP address used by the interface. This address is used when dynamic IP is not allocated by the ISP |
|
KCDTIdIpAddr |
Short text |
User defined A static IP address. This field can be null when dynamic IP address is used. |
||||||||||||||||||||||||||||||||||||||||||
IpNetMask |
IP netmask of the interface if required |
|
KCDTIdIpNetMask |
Short text |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IpGateway |
Gateway IP address |
|
KCDTIdIpGateway |
Short text |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IpNameServer1 |
Static address of the primary IPv4 DNS server |
|
KCDTIdIpNameServer1 |
An IPv4 address |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IpNameServer2 |
Static IP address of the secondary IPv4 DNS server |
|
KCDTIdIpNameServer2 |
An IPv4 address |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
Ip6NameServer1 |
Static IP address of the primary IPv6 DNS server |
|
KCDTIdIp6NameServer1 |
An IPv6 address |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
Ip6NameServer2 |
Static IP address of the secondary IPv6 DNS server |
|
KCDTIdIp6NameServer2 |
An IPv6 address |
User defined This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
ConfigDaemonName |
Address configuration daemon name |
|
KCDTIdConfigDaemonName |
Short text |
User defined. Example DHCP, MobileIP,etc This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IpAddrLeaseValidFrom |
Start of lease of dynamic address allocated by the ISP |
|
KCDTIdIpAddrLeaseValidFrom |
Short text |
User defined text values of start date and time of the lease This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
IpAddrLeaseValidTo |
End of lease of dynamic address allocates by the ISP |
|
KCDTIdIpAddrLeaseValidto |
Short text |
User defined text value containing the end date and time of the lease This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
EnableIPHeaderComp |
A boolean value flag determining IP header compression protocol. IP header compression is the process of compress the excess header before transmission and uncompress them at the receiving end |
|
KCDTIdEnableIpHeaderComp |
Boolean |
This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
EnableLCPExtension |
Information regarding LCP extension. LCP extensions include
callback option, Time remaining and Identification packets as defined in RFC
1570. Note that for the DialInISP table the field is called
|
|
KCDTIdEnableLCPExtension |
Boolean |
FALSE is the default value |
||||||||||||||||||||||||||||||||||||||||||
DisablePlainTextAuth |
Password Authentication Protocol (PAP) uses plain text passwords for authentication of remote server and is the least secure method. Challenge Handshake Authentication Protocol (CHAP) uses similar method but with complex passwords and it is more secure. Plain text passwords or disabled when CHAP is used |
|
KCDTIdDisablePlainTextAuth |
Boolean |
This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
EnableSWComp |
Information regarding software compression. When this option is enabled the payload is compressed. This is different from header compression |
|
KCDTIdEnableSWComp |
Boolean |
This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
BearerService |
Bearer service refers to a service that allows transmission of information signals between network interfaces (NIFs). It defines the correct service to use when setting up the data connection. Enumeration defined in RMobileCall::TMobileCallDataService. Unrestricted data information (UDI) is the ability to transfer any bit pattern over a digital channel and Restricted data information (RDI) is not capable of transferring all data values over a digital channel. For example- the 8-bit value “0” cannot be transmitted. UDI/RDI is the information transfer capability that is set to/from the network. This can be set to either UDI or RDI. The "information transfer rate" for a data call would then be set to "64 kbps". Together, the two parts are used to request 64K IDSN data calls, commonly abbreviated as 64U or 64R calls. Public Land Mobile Network (PLMN)is a generic name for all mobile wireless networks that use land based radio transmitters or base stations. Packet Assembly/Disassembly (PAD) is a device that is used to assemble/disassemble packets which allows mobile phone devices to connect to packet-switched networks. PAD may also carry out buffering tasks. |
|
KCDTIdBearerService |
Enum |
|
||||||||||||||||||||||||||||||||||||||||||
BearerName |
Name of the bearer used to establish and transmit data over the connection |
|
KCDTIdBearerName |
Enum |
|
||||||||||||||||||||||||||||||||||||||||||
BearerSpeed |
Baud rate of the bearer |
|
KCDTIdBearerSpeed |
Enum |
2400, 4800, 9600, 14400, 19200, 28800, 33600, 38400, 56000, 64000 The data rates are specified in bits per second (bps). This field can have null value. |
||||||||||||||||||||||||||||||||||||||||||
BearerProtocol |
A set of standards governed by the ITU-T allowing different bearers can communicate with each other. Bearer protocol definitions are typically referred to by the letter V followed by a number |
|
KCDTIdBearerProtocol |
Enum |
|
||||||||||||||||||||||||||||||||||||||||||
BearerCE |
Defines the quality of service (QoS) of the connection |
|
KCDTIdBearerCE |
Enum |
This field can have null value. |
||||||||||||||||||||||||||||||||||||||||||
BearerType |
The method used by the bearer to transmit data |
|
KCDTIdBearertype |
Enum |
This field can have null value. |
||||||||||||||||||||||||||||||||||||||||||
ChannelCoding |
The channel coding used for the connection. This field can only be used when the BearerType field has a value of "HSCSD". Channel coding is a way of reducing information rate through the channel (connection) in order to increase the reliability of the data HSCSD has ability to use at best 4 multiple time slots at a time, giving a potential max transfer rate of 4 X 14.4K |
|
KCDTIdChannelCoding |
Enum |
This field can have null value. |
||||||||||||||||||||||||||||||||||||||||||
AIUR |
The AIUR (Air Interface User Rate) is the rate indicated between a Mobile Terminal (Mobile Station) and the IWF (Interworking Function) for transparent and non-transparent data services The IWF is responsible for connecting circuit-switched data paths of a mobile network with a fixed network such as PSTN or ISDN |
|
KCDTIdAiur |
Enum |
UNSPECIFIED 9600, 14400, 19200, 28800, 38400, 43200, 57600 The data rates are specified in bits per second (bps) The database stores the values such as TMobileCallAiur::EAiurBps9600 for the rate of 9600. |
||||||||||||||||||||||||||||||||||||||||||
RlpVersion |
Radio Link Protocol (RLP)- is an automatic repeat request (ARQ) protocol used over a wireless air interface. RLP are differentiated by version numbers |
|
KCDTIdRlpVersion |
Enum |
This field can have null value |
||||||||||||||||||||||||||||||||||||||||||
InitString |
Initialisation string for the bearer, used specifically when a modem is in use. It is used to initialise (init) the modem by sending it a string of commands, typically Hayes commands. These commands configure the modem's options for things like error correction, data compression, flow control, and many other parameters Init strings may be used to improve the connection for example when there is trouble with the connection or it seems too slow |
|
KCDTIdInitstring |
Binary |
A binary string typically a Hayes command such as AT or ATZ This field can have null value. |
||||||||||||||||||||||||||||||||||||||||||
IwfToMs |
Integer specifying network to MS window size. IWF stands for Interworking Function and MS stands for Mobile Station. |
|
KCDTIdIwfToMs |
Integer |
User defined integer value |
||||||||||||||||||||||||||||||||||||||||||
MsToIwf |
Integer specifying mobile device to network window size |
|
KCDTIdMsToIwf |
Integer |
User defined integer value |
||||||||||||||||||||||||||||||||||||||||||
RetransmissionAttempts |
Specifies number of RLP retransmission attempts |
|
KCDTIdRetransmissionAttempts |
Integer |
User defined |
||||||||||||||||||||||||||||||||||||||||||
ResequencePeriod |
Specifies the period when packets are being resequenced |
|
KCDTIdResequencePeriod |
Integer |
User defined integer specifying time in microseconds 0 is the default value |
||||||||||||||||||||||||||||||||||||||||||
V42Compression |
Enumeration specifying whether or not to set V.42 Compression and the direction that compression is used V.42 compression follows the V.42bis protocol which is a data compression protocol used on top of the bearer protocol |
|
KCDTIdV42Compression |
Enum |
|
||||||||||||||||||||||||||||||||||||||||||
V42Codewords |
Specifies the V.42 codewords if V.42 compression is used. A codeword represents a string of characters in compressed form |
|
KCDTIdV42Codewords |
Enum |
0 is the default value |
||||||||||||||||||||||||||||||||||||||||||
V42MaxLength |
Specifies the maximum string length of the data before V.42 compression |
|
KCDTIdV42MaxLength |
Integer |
User defined integer value |
||||||||||||||||||||||||||||||||||||||||||
Assymetry |
For HSCSD. An enumeration to specify whether 1) Asymmetrical bias on the connection is preferred 2) Type of asymmetrical bias used. Note The service provided by uplink and downlink is different |
|
KCDTIdAssymetry |
Enum |
|
||||||||||||||||||||||||||||||||||||||||||
UserInitUpgrade |
Specifies whether the user will initialise service upgrade over HSCSD or not |
|
KCDTIdUserInitUpgrade |
Boolean |
|
||||||||||||||||||||||||||||||||||||||||||
UseEdge |
Specifies whether to use EDGE technology. EDGE stands for Enhanced Data rates for GSM Evolution. This technology works in GSM networks, also known as EGPRS. This is a upgrade to GPRS and can function on any network with GPRS, provided the carrier implements the necessary upgrades.. It can outperform GPRS data throughput by 300% |
|
KCDTIdUseEdge |
Boolean |
|
||||||||||||||||||||||||||||||||||||||||||
RequestedTimeSlots |
Requested number of time slots for HSCSD |
|
KCDTIdRequestedTimeSlots |
Integer |
User defined integer value |
||||||||||||||||||||||||||||||||||||||||||
MaximumTimeSlots |
Maximum number of time slots for HSCSD which could be requested during the connection |
|
KCDTIdMaximumTimeSlots |
Integer |
User defined integer value |
||||||||||||||||||||||||||||||||||||||||||
AckTimer |
An integer specifying the RLP acknowledgement timeout |
|
KCDTIdAckTimer |
Integer |
User defined time in microseconds |
||||||||||||||||||||||||||||||||||||||||||
BearerTechnology |
Specifies whether the bearer is a CSD/HSCSD bearer |
|
KCDTIdBearerTechnology |
Enum |
|
This table contains a device's global settings.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdGlobalSettingsRecord
.
Field name | Description | CommsDat fieldname | Commsdat field ID | Field value type | Possible Values | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SmsBearer |
Default bearer for SMS |
|
KCDTIdSMSBearer |
Enum |
|
||||||||||||||||||
SmsReceiveMode |
If the client receives an unstored new message which the phone
has not acknowledged, then the client has the responsibility of attempting to
store the message and then either “ |
|
KCDTIdSMSReceiveMode |
Enum |
|
||||||||||||||||||
GPRSAttachMode |
Determines when a device attaches to a GPRS network |
|
KCDTIdGPRSAttachMode |
Enum |
|
||||||||||||||||||
AcceptIncomingGprs |
Determines whether or not to accept an incoming GPRS connection when an application is waiting for the service |
|
KCDTIdAcceptincomingGPRS |
Boolean |
|
||||||||||||||||||
ConnectionAttempts |
Maximum number of attempts to connect to the network |
|
KCDTIdMaxConnectionAttempts |
Integer |
1 or 2 2 is the default value |
||||||||||||||||||
ModemForDataAndFax |
Default bearer for data and fax calls |
|
KCDTIdModemDataFax |
Integer |
A reference to a record in the ModemBearer table |
||||||||||||||||||
LocationForDataAndFax |
Default location information for data and fax calls |
|
KCDTIdLocationDataFax |
Integer |
A reference to a record in the Location table |
||||||||||||||||||
GPRSClassCBearer |
The preferred bearer when the device is forced into GPRS Class C operation. Class C means that the device can be active in either GSM or GPRS mode, but not at the same time |
|
KCDTIdGPRSClasscBearer |
Enum |
|
||||||||||||||||||
DefaultNetwork |
Default network information |
|
KCDTIdDefaultNetwork |
Integer |
Reference to the default network record in the network table |
||||||||||||||||||
BearerAvailablityCheckTSY |
The TSY used to check for bearer availablity |
|
KCDTIdBearerAvailabilityCheckTSY |
Short text |
Possible TSY values |
||||||||||||||||||
ModemForPhoneServicesAndSMS |
Modem settings for phone and SMS services |
|
KCDTIdModemPhoneServicesSMS |
Integer |
A reference to a record in the ModemBearer table |
||||||||||||||||||
LocationForPhoneServicesAndSMS |
Sets the default location from which you are dialling for phone services such as a SMS service |
|
KCDTIdLocationPhoneServicesSMS |
Integer |
A reference to a record in the Location table |
||||||||||||||||||
RedialAttempts |
Maximum number of redial attempts when the ISP dailled is busy |
|
KCDTIdMaxRedialAttempts |
Integer |
User defined integer value This field cannot have null value |
||||||||||||||||||
maxMBufHeap |
Maximum RMBuf heap size |
|
KCDTIdMaxMBufHeap |
Integer |
User defined integer value specifying maximum size of the buffer (in bytes) |
||||||||||||||||||
DefaultAgent |
The default agent to be used |
|
KCDTIdDefaultAgent |
Integer |
A reference to a record in the AgentLookup table |
Internet Access Points (IAPs) configuration table. There should be one record created for each Access Point with a specific service and a specific bearer. The fields in this table have references to records in other tables.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdIAPRecord
.
Field name | Description of field | CommsDat field name | CommsDat field ID | Field value type | Possible Values |
---|---|---|---|---|---|
IAPService |
The service used by an Access Point |
|
KCDTIdIAPService |
Integer |
A reference to a record in the service table |
IAPServiceType |
Name of the service table |
|
KCDTIdIAPServicetype |
Short text |
A reference to one of the service table |
IAPBearer |
Bearer information |
|
KCDTIdIAPBearer |
Integer |
A reference to a record in the Bearer table |
IAPBearerType |
Type of the bearer to be used |
|
KCDTIdIAPBearerType |
Medium text |
Name of the bearer table such as ModemBearer or LANBearer |
IAPNetwork |
Network information |
|
KCDTIdIAPNetwork |
Integer |
A reference to a record in the Network table |
IAPNetworkWeighting |
A weighting for a particular IAP. The IAP with highest weighting is attempted first. This is an alternative way to make a connection if the ConnectionPreferences ranking is not used |
|
KCDTIdIAPNetworkWeighting |
Integer |
User defined integer value |
Location |
The location information to be used by the particular Access Point |
|
KCDTIdIAPLocation |
Integer |
A reference to a record in the Location table |
All the fields in the IAP table can hav null value except the IAPService field.
The IncomingGPRS
/OutgoingGPRS
tables have
similar fields. These fields contain the configuration settings for using the
GPRS service. These tables should be configured for services using a wireless
GPRS connection. Configure the IncomingGPRS
table for inbound
connections, and configure the OutgoingGPRS
table for outbound
connections. The following table shows the values for an
IncomingGPRS
table record. A similar record can be used for the
OutboundGPRS
table by changing the values accordingly.
Note:
A new table called UmtsR99QosAndOn has been added to list the QoS fields exclusively. The integer field UmtsR99QosAndOn acts as a record link between the UmtsR99QosAndOn table and the existing GPRS tables for QoS related fields.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for IncomingGPRS table:
KCDTIdIncomingGprsRecord
.
Record ID for OutgoingGPRS table:
KCDTIdOutgoingGprsRecord
.
Field name | Description of field | CommsDat field name | CommsDat field ID | Field value type | Possible values | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
APN |
Access point name |
CCDWCDMAPacketServiceRecord::iGPRSAPN |
KCDTIdAPN |
Medium text |
User defined text |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PDPType |
Packet data protocol (PDP) used by the packet switching networks to communicate with GPRS |
|
KCDTIdWCDMAType |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PDPAddress |
PDP address of the device |
|
KCDTIdWCDMAPDPAddress |
Short text |
User defined URL or an IP address |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IfPromptForAuth |
A boolean flag to prompt for authentication by the ISP once the conection is established |
|
KCDTIdWCDMAIfPromptForAuth |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IfParams |
Interface parameter string used to specify the lower layer that interface protocol is to use |
|
KCDTIdWCDMAIfParams |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IfNetworks |
List of network protocols to be used by the network interface (nif) separated by comma |
|
KCDTIdWCDMAIfNetworks |
Short text |
User defined. Example IP, IP6 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IfAuthName |
Prompt user to enter authentication username used in the datalink layer. Example in PPP |
|
KCDTIdWCMAIfAuthName |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IfAuthPass |
Prompt user to enter authentication password used in the datalink layer. Example in PPP |
|
KCDTIdWCMAIfAuthPass |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AuthRetries |
Number of times to retry authentication whenit fails |
|
KCDTIdWCMAAuthRetries |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
EnableLCPExtension |
Information regarding LCP extension. LCP extensions include callback option, Time remaining and Identification packets as defined in RFC 1570 |
|
KCDTIdWCMAEnableLCPExtension |
Boolean |
FALSE is the default value. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpAddrFormServer |
Detrmines whether or not to get IP address from the ISP |
|
KCDTIdWCMAIPAddrFromServer |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpDNSAddrFromServer |
A boolean flag that detrmines whether or not to get DNS address for IPv4 from the ISP |
|
KCDTIdWCMAIPDNSAddrFromServer |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ip6DNSAddrFromServer |
A boolean flag that detrmines whether or not to get DNS address for IPv6 from the ISP |
|
KCDTIdWCMAIP6DNSAddrFromServer |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpAddr |
Static IP address used by the interface. This address is used when dynamic IP is not allocated by the ISP |
|
KCDTIdWCMAIPAddr |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpNetMask |
IP netmask of the interface if required |
|
KCDTIdWCMAIPNetmask |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpGateway |
Gateway IP address |
|
KCDTIdWCMAIPGateway |
Short text |
User defined 0.0.0.1 is the default value |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpNameServer1 |
Static address of the primary IPv4 DNS server |
|
KCDTIdWCMAIPNameServer1 |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpNameServer2 |
Static IP address of the secondary IPv4 DNS server |
|
KCDTIdWCMAIPNameServer2 |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ip6NameServer1 |
Static IP address of the primary IPv6 DNS server |
|
KCDTIdWCMAIP6NameServer1 |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ip6NameServer2 |
Static IP address of the secondary IPv6 DNS server |
|
KCDTIdWCMAIP6NameServer2 |
Short text |
User defined |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ConfigDaemonName |
Address configuration daemon name |
|
KCDTIdWCMAConfigDaemon |
Short text |
User defined. Example DHCP, MobileIP,etc |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpAddrLeaseValidFrom |
Start of lease of dynamic address allocated by the ISP |
|
KCDTIdWCMAIPAddrLeaseValidFrom |
Short text |
User defined text values of start date and time of the lease |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IpAddrLeaseValidTo |
End of lease of dynamic address allocates by the ISP |
|
KCDTIdWCMAIPAddrLeaseValidTo |
Short text |
User defined text value containing the end date and time of the lease |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GprsUseEdge |
A boolean flag which specifies whether to use EDGE technology. EDGE stands for Enhanced Data rates for GSM Evolution. This technology works in GSM networks, also known as EGPRS. This is a upgrade to GPRS and can function on any network with GPRS, provided the carrier implements the necessary upgrades.. It can outperform GPRS data throughput by 300% |
|
KCDTIdWCMAUseEdge |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ReqPrecedence |
Requested quality of service precedence class |
|
KCDTIdReqPrecedence |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ReqDelay |
An enumeration field determining the requested quality of service delay class |
|
KCDTIdWCMAReqDelay |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ReqReliability |
An enumeration field determining the requested quality of service reliability class |
|
KCDTIdREqReliability |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ReqpeakThroughput |
An enumeration field determining the requested quality of service peak throughput |
|
KCDTIdReqThroughput |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ReqMeanThroughput |
An enumeration field determining the requested quality of service mean throughput class |
|
KCDTIdReqMeanThroughput |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MinPrecedenceDelay |
An enumeration field determining the minimum quality of service reliability class and the values are similar to the in RequiredPrecedence field |
|
KCDTIdMinPrecedenceDelay |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MinDelay |
An enumeration field determining the minimum quality of service delay class and the values are similar to the in ReqDelay fields |
|
KCDTIdMinDelay |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MinReliablility |
An enumeration field determining the minimum quality of service reliability class and the field values are similar to the ReqReliability field |
|
KCDTIdMinReliability |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MinPeakThroughput |
An enumeration field determining the minimum quality of service peak throughput class and the field values are similar to the ReqPeakThroughput field |
|
KCDTIdMinPeakThroughput |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MinMeanThroughput |
An enumeration field determining the minimum quality of service mean throughput class and the field values are similar to the ReqMeanThroughput field |
|
KCDTIdMinMeanThroughput |
Enum |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UmtsR99QoSAndOn |
A record link between the Incoming/Outgoing GPRS table and the UmtsR99QosAndOn table |
|
KCDTIdUmtsR99QoSAndOn |
Integer |
A reference to a record in the UmtsR99QoSAndOn table |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DataCompression |
A boolean flag to specify data compression |
|
KCDTIdWCDMADataCompression |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Header Compression |
A boolean flag to specify IP header compression |
|
KCDTIdWCDMAHeaderCompression |
boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnonymousAccess |
A boolean flag specifying whether anonymous access is enabled.Anonymous access allows the device to connect to the network without authentication |
|
KCDTIdWCMAAnonymousAccess |
Boolean |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GprsAccessPointType |
A flag specifying the type of support the ISP provides to the device |
|
KCDTIdAPType |
Enum |
This field can have a null value |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
QosWarningTimeout |
An integer to warn the user when the required QoS is not satisfied |
|
KCDTIdQOSWarningTimeout |
Integer |
User defined integer value in microseconds |
This table lists various QoS related fields. It supports R99/R4 revision of 3GPP QoS parameters (as per 3GPP TS 23.107 v.4).
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table:
KCDTIdUmtsR99QoSAndOnTableRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible values | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ReqTrafficClass |
Information regarding requested traffic class |
|
KCDTIdWCDMAReqTrafficClass |
Enum |
|
|||||||||||||||||||||||||||||||||
MinTrafficClass |
Minimum acceptable traffic class |
|
KCDTIdWCDMAMinTrafficClass |
Enum |
|
|||||||||||||||||||||||||||||||||
ReqDeliveryOrder |
Requested value for sequential SDU delivery |
|
KCDTIdWCDMAReqDeliveryOrder |
Enum |
|
|||||||||||||||||||||||||||||||||
MinDeliveryOrder |
Acceptable minimum value for sequential SDU delivery |
|
KCDTIdWCDMAMinDeliveryOrder |
Enum |
|
|||||||||||||||||||||||||||||||||
ReqDeliveryErroneousSDU |
Requested value for erroneous SDU delivery |
|
KCDTIdWCDMADeliverErroneousSDU |
Enum |
|
|||||||||||||||||||||||||||||||||
MinDeliveryErroneousSDU |
Minimum acceptable value for erroneous SDu delivery |
|
KCDTIdWCDMAMinDeliveryOrder |
Enum |
|
|||||||||||||||||||||||||||||||||
ReqMaxSDUSize |
Specifies the maximum SDU size |
|
KCDTIdWCDMAReqMaxSDUSize |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||
MinAcceptableMaxSDUsize |
Specifies the minimum size of SDU |
|
KCDTIdWCDMAMinAcceptableMaxSDUSize |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||
ReqMinUplinkRate |
Specifies minimum requested uplink bitrate |
|
KCDTIdWCDMAReqMinUplinkRate |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||
ReqMaxUplinkRate |
Specifies maximum requested uplink bitrate |
|
KCDTIdWCDMAReqMaxUplinkRate |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||
ReqMaxDownlinkRate |
Specifies maximum requested downlink rate |
|
KCDTIdWCDMAReqMaxDownlinkRate |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||
ReqMinDownlinkrate |
Specifies minimum requested downlink rate |
|
KCDTIdWCDMAReqMinDownlinkRate |
Integer |
User defined integer value |
|||||||||||||||||||||||||||||||||
ReqBER |
Specifies target BER |
|
KCDTIdWCDMAReqBER |
Enum |
|
|||||||||||||||||||||||||||||||||
MaxBER |
Specifies maximum accepted target BER |
|
KCDTIdWCDMAMaxBER |
Enum |
|
|||||||||||||||||||||||||||||||||
ReqSDUErrorRatio |
Requested target SDU error ratio |
|
KCDTIdWCDMAReqSDUErrorRatio |
Enum |
|
|||||||||||||||||||||||||||||||||
MaxSDUErrorRatio |
Maximum acceptable target SDU error ratio |
|
KCDTIdWCDMAMaxSDUErrorRatio |
Enum |
|
|||||||||||||||||||||||||||||||||
ReqTrafficHandlingPriority |
Requested traffic handling priority |
|
KCDTIdWCDMAReqTrafficHandlingPriority |
Enum |
|
|||||||||||||||||||||||||||||||||
MinTrafficHandlingPriority |
Minimum acceptable traffic handling priority |
|
KCDTIdWCDMAMinTrafficHandlingPriority |
Enum |
|
|||||||||||||||||||||||||||||||||
ReqTransferDelay |
Requested transfer delay |
|
KCDTIdWCDMAReqTransferDelay |
Integer |
User defined value in milliseconds |
|||||||||||||||||||||||||||||||||
MaxTransferDelay |
Maximum accepted transfer delay |
|
KCDTIdWCDMAMinTransferDelay |
Integer |
User defined value in milliseconds |
|||||||||||||||||||||||||||||||||
ReqGuaranteedUplinkRate |
Requested guaranteed uplink rate |
|
KCDTIdWCDMAReqGuaranteedUplinkRate |
Integer |
User defined bitrate |
|||||||||||||||||||||||||||||||||
MinGuaranteedUplink |
Minimum acceptable guaranteed uplink rate |
|
KCDTIdWCDMAMinGuaranteedUplinkRate |
Integer |
User defined bitrate |
|||||||||||||||||||||||||||||||||
ReqGuaranteedDownlinkRate |
Requested guaranteed downlink rate |
|
KCDTIdWCDMAReqGuaranteedDownlinkRate |
Integer |
User defined bitrate |
|||||||||||||||||||||||||||||||||
MinGuaranteedDownlinkRate |
Minimum acceptable guaranteed downlink rate |
|
KCDTIdWCDMAMinGuaranteedDownlinkRate |
Integer |
User defined bitrate |
|||||||||||||||||||||||||||||||||
SignallingIndication |
Specified whether signalling indication is used |
|
KCDTIdWCDMASignallingIndication |
Boolean |
TRUE or FALSE |
|||||||||||||||||||||||||||||||||
ImCnSignallingIndication |
Specifies whether IP multimedia system (IMS) core network (CN) signalling indication is used |
|
KCDTIdWCDMAImCmSignallingIndication |
Boolean |
TRUE or FALSE |
|||||||||||||||||||||||||||||||||
SourceStatisticsDescriptor |
Static source descriptor as defined in 3GPP TS 23.107 and TS 24.008 |
|
KCDTIdWCDMASourceStatisticsDescriptor |
Enum |
|
This table should be configured when a device connects to a local area network such as ethernet and Wi-Fi.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdLANBearerRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible Values | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
IfName |
Interface name used to implement a network connection protocol such as PPP. |
|
KCDTIdLANBearerNifName |
Short text |
User defined interface name |
||||||
LDDName |
Logical device driver (LDD) name used as an interface with lower layer physical device driver (PDD). |
|
KCDTIdLANBearerLddName |
Short text |
Name of the driver used |
||||||
PDDName |
The name of the physical device driver interacting with the hardware. |
|
KCDTIdLANBearerPddName |
Short text |
Name of the driver used |
||||||
LDDFileName |
The .DLL file used by the the logical device driver (LDD). |
|
KCDTIdLANBearerLddFilename |
Short text |
.DLL file name |
||||||
PDDFileName |
The .DLL file used by the physical device driver (PDD). |
|
KCDTIdLANBearerPddFileName |
Short text |
.DLL file name |
||||||
LastSocketActivityTimeout |
Time to stay connected when all socket activity is ceased. |
|
KCDTIdLANLastSocketActivityTimeout |
Integer |
User defined integer value in seconds |
||||||
LastSessionClosedTimeout |
Time to stay connected when the session is closed. |
|
KCDTIdLANLastSessionClosedTimeout |
Integer |
User defined integer value in seconds. |
||||||
LastSocketClosedTimeout |
Time to stay online when the socket is closed |
|
KCDTIdLANLastSocketClosedTimeout |
Integer |
|||||||
Agent |
The file name of the agent used. |
|
KCDTIdLANBearerAgent |
Short text |
The file name with extension such as DummyPSD.agt |
||||||
BearerTechnology |
The method used by the bearer to transmit data. |
|
KCDTIdLANBearerTechnology |
Enum |
|
||||||
PacketDriverName |
The name of the packet driver. The packet driver is used to initiate access to a specific packet type, to end access to it, to send a packet, to get statistics on the NIF and to get information about the NIF. |
|
KCDTIdLANBearerPacketDriverName |
Short text |
Name of the packet driver |
This table contains the details of the gateway server.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdLANServiceRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible Values | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name |
Name of the network such as ethernet. |
Short text |
Ethernet |
|||||||||||
IfNetworks |
Type of network layer interface used. |
|
KCDTIdLANIfNetworls |
Short text |
ip |
|||||||||
IpNetmask |
Netmasking address. |
|
KCDTIdLANIpNetmask |
Short text |
User defined address |
|||||||||
IpGateway |
Gateway IP address . |
|
KCDTIdLANIpGateway |
Integer |
User defined address |
|||||||||
IpAddrFromServer |
Detrmines whether or not to get IP address from the ISP |
|
KCDTIdLANIpAddrFromServer |
Boolean |
This field cannot be null. This field should be set to FASLE for using static IP address |
|||||||||
IpAddr |
IP address of the device. |
|
KCDTIdLANIpAddr |
Integer |
User defined address |
|||||||||
IpDNSAddrFromServer |
Detrmines whether or not to get DNS address for IPv4 from the ISP. |
|
KCDTIdLANIpDNSAddrFromServer |
Boolean |
This field cannot be null, may be set to FALSE for using static DNS server address specified in IpNameServer1 and IpNameServer2 fields. |
|||||||||
Ip6DNSAddrFromServer |
Detrmines whether or not to get DNS address for IPv6 from the ISP. |
|
KCDTIdLANIp6DNSAddrFromServer |
Boolean |
This field cannot be null, may be set to FALSE for using static DNS server address specified in Ip6NameServer1 and Ip6NameServer2 fields. |
|||||||||
IpNameServer1 |
Static address of the primary IPv4 DNS server. |
|
KCDTIdLANIpNameServer1 |
An IPv4 address |
User defined This field can have null value |
|||||||||
IpNameServer2 |
Static address of the secondary IPv4 DNS server. |
|
KCDTIdLANIpNameserver2 |
An IPv4 address |
User defined This field can have null value |
|||||||||
Ip6NameServer1 |
Static address of the primary IPv6 DNS server. |
|
KCDTIdLANIp6NameServer1 |
An IPv6 address |
User defined This field can have null value |
|||||||||
Ip6NameServer2 |
Static address of the secondary IPv6 DNS server. |
|
KCDTIdLANIp6NameServer2 |
An IPv6 address |
User defined This field can have null value |
|||||||||
IpAddrLeaseValidFrom |
Address configuration daemon name |
|
KCDTIdLANIpAddrLeaseValidfrom |
Short text |
User defined text values of start date and time of the lease This field can have null value |
|||||||||
IpAddrLeaseValidTo |
Start of lease of dynamic address allocated by the ISP |
|
KCDTIdLANIpAddrLeaseValidTo |
Short text |
User defined text value containing the end date and time of the lease This field can have null value |
|||||||||
ConfigDaemonManagerName |
Name of the ECOM daemon manager plug-in for NIFMAN used to load a specific configuration daemon |
|
KCDTIdLANConfigdaemonManagerName |
Short text |
Same as description |
|||||||||
ConfigDaemonName |
End of lease of dynamic address allocates by the ISP |
|
KCDTIdLANConfigDaemonName |
Short text |
Same as description |
|||||||||
LANServiceExtensionTableName |
Name of the extension table |
|
KCDTIdLANServiceExtensionTableName |
Same as description |
Same as description |
|||||||||
LanServiceExtensionTableRecordId |
Record of the extension table |
|
KCDTIdLANServiceExtensionTable Record |
Same as description |
Same as description |
This table holds the details of device's location information.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdLocationRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible Values | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Mobile |
A boolean flag specifying whether the device is a mobile or not. |
|
KCDTIdMobile |
Boolean |
|
||||||
UsePulseDial |
A bolean flag specifying whether to use pulse dialing. |
|
KCDTIdusePulseDial |
Boolean |
|
||||||
WaitForDialTone |
A boolean flag specifying whether to wait fordial tone. |
|
KCDTIdWaitForDialTone |
Boolean |
|
||||||
PauseAfterDialOut |
An integer value specifying time to pause after using the dial-ot code. |
|
KCDTIdPauseAfterDialOut |
Integer |
User defined integer value in seconds |
||||||
IntlPrefixCode |
The prefix code used for international calls. |
|
KCDTIdIntlPrefixCode |
Short text |
User defined integer value |
||||||
NatPrefixCode |
Prefix code used for national calls. |
|
KCDTIdNatPrefixCode |
Short text |
User defined integer value |
||||||
NatCode |
The country code. |
|
KCDTIdNatCode |
Short text |
User defined integer value |
||||||
AreaCode |
The area code. |
|
KCDTIdAreaCode |
Short text |
User defined integer value |
||||||
DialOutCode |
Number used to dial external line. |
|
KCDTIdDialOutCode |
Short text |
User defined integer value |
||||||
DisableCallWaitingCode |
Code used to disable call waiting facility. |
|
KCDTIdDisableCallWaitingCode |
Short text |
User defined integer value |
||||||
BearerTechnology |
The method used by the bearer to transmit data. |
|
KCDTIdBearerTechnology |
Enum |
|
This table should be configured for modem-based connections such as ethernet, Wi-Fi and Bluetooth.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdModemBearerRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible Values | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
IfName |
The interface name that is used to implement a networkl layer protocol such as PPP |
|
KCDTIdNifName |
Short text |
User defined interface name |
||||||||||||||||||||||||
Agent |
The file name of the agent used |
|
KCDTIdBearerAgent |
Short text |
Filename of the agent with the extension such as DummyPSD.agt |
||||||||||||||||||||||||
ControlChannelPortName |
The modem control channel port name. A Control Channel is used in Optical Burst Switching, which provides the advantages of circuit switching and packet switching data. The channel is dedicated to providing a separate and secured transmission of BHP(Burst Header Packet). |
|
KCDTIdControlChannelPortName |
Short text |
A port number |
||||||||||||||||||||||||
BCAStack |
Baseband Channel Adapter stack (BCA) provides an interface for the hardware adaptation layer (HAL) specifically, it is used to interface the R-Interface data plane transport with a NIF (network interface). |
|
KCDTIdBCDStack |
Short text |
A list of BCA's separated by commas |
||||||||||||||||||||||||
PortName |
The Comm port name used by the modem |
|
KCDTIdPortName |
Short text |
User defined port name |
||||||||||||||||||||||||
TSYName |
The name of the TSY which provides the hardware specific implementation of the ETEL server interface. |
|
KCDTIdTsyName |
Short text |
A TSY name |
||||||||||||||||||||||||
CSYName |
The name of the CSY which implements the comm port specific interface to C32 |
|
KCDTIdCsyName |
Short text |
A CSY name |
||||||||||||||||||||||||
DataBits |
Number of data bits used for serial port configuration |
|
KCDTIdDataBits |
Enum |
|
||||||||||||||||||||||||
StopBits |
Number of stop bits used for serial port configuration |
|
KCDTIdStopBits |
Enum |
|
||||||||||||||||||||||||
Parity |
The type of parity used to detect corrupted data |
|
KCDTIdParity |
Enum |
|
||||||||||||||||||||||||
Rate |
Rate The baud rate of the modem. Measured in bits per second (bps). This specifies the maximum rate that data can be sent on this modem bearer. |
|
KCDTIdRate |
Enum |
50, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 576000, 1152000 The data rates are specified in bits per second (bps) The enum value is expressed as TBps::EBps50, TBps::EBps70, etc.
|
||||||||||||||||||||||||
SpecialRate |
A user defined baud rate. This field will be used only if SPECIAL is mentioned in the rate field |
|
KCDTIdSpecialRate |
Integer |
User defined value |
||||||||||||||||||||||||
HandShaking |
The handshaking process between modems is encapsulated into one integer. This integer can be viewed as a binary bitmask of bits, each bit representing one of the pins inside the RS232 serial cable. The integer value can actually be derived from taking a binary OR of each of the bits |
|
KCDTIdHandshaking |
Integer |
Integer bit mask |
||||||||||||||||||||||||
XOnChar |
Character used to signal to the transmitter to resume sending when using XON/XOFF handshaking. This is a type of software flow control - using an agreed-upon set of characters as start and stop signals. XON/XOFF flow control typically assigns the ASCII DC1 character (also known as control-Q) as the start signal and the DC3 character (Device Code3 (control-S)) as the stop signal. Both of these characters are usually reserved for this purpose. There is also the option to choose different characters. Whenever the sender or the receiver wants to interrupt the data flow from the other (e.g. full buffers), it sends an XOFF to stop transmission. When its buffers are able again, it sends an XON to signal that data can be sent again. |
|
KCDTIdXonChar |
Integer |
Integer value representing ctrl+Q. The field is set to 0 when the software for handshaking is not used |
||||||||||||||||||||||||
XOffChar |
Character used to signal the transmitter to suspend sending when using XON/XOFF handshaking. |
|
KCDTIdXoffChar |
Integer |
Integer value representing ctrl+S. The field is set to 0 when the software for handshaking is not used |
||||||||||||||||||||||||
FaxClassPref |
Preferred fax modem class supported by the fax client |
|
KCDTIdFaxClassPref |
Enum |
|
||||||||||||||||||||||||
SpeakerPref |
Preferred speaker mode |
|
KCDTIdSpeakerPref |
Enum |
|
||||||||||||||||||||||||
SpeakerVolPref |
Preferred speaker volume |
|
KCDTIdSpeakerVolPref |
Enum |
|
||||||||||||||||||||||||
ModemInitString |
A modem initialisation string. The modem is usually initialised by sending a string of commands, typically Hayes commands. These commands are useful in modem configuration. |
|
KCDTIdModemInitString |
Binary |
Hayes AT commands such as AT, ATZ, etc. |
||||||||||||||||||||||||
DataInitString |
Data initialisation string |
|
KCDTIdDataInitString |
Binary |
Hayes AT commands such as AT, ATZ, etc. |
||||||||||||||||||||||||
FaxInitString |
Fax initialsation string |
|
KCDTIdFaxInitString |
Binary |
Hayes AT commands such as AT, ATZ, etc. |
||||||||||||||||||||||||
IspInitString |
Initialsation string specific to a particular ISP |
|
KCDTIdIspInitString |
Binary |
Hayes AT commands such as AT, ATZ, etc. |
||||||||||||||||||||||||
DialPauseLength |
Command to modify the pause created during dialling using the comma character (','). |
|
KCDTIdDialPauseLength |
Short text |
Hayes AT command specifying the pause duration in seconds by setting the S8 register. |
||||||||||||||||||||||||
CarrierTimeOut |
Command to set the time out the modem uses when establishing a link before giving up and returning to command mode. |
|
KCDTIdCarrierTimeOut |
Short text |
Hayes AT command specifying the timeout period in seconds usually by setting the value in a S- register, usually the S10 register. |
||||||||||||||||||||||||
AutoAnswerRingCount |
Command to set the number of rings before the modem auto answers. |
|
KCDTIdAutoAnswerRingCount |
Short text |
Hayes AT command specifying the number of rings, specifically setting the S1 register |
||||||||||||||||||||||||
SpeakerVolControlLow |
Command to set the modem speaker volume to low. |
|
KCDTIdSpeakerVolControlLow |
Short text |
Hayes AT command, specifically L0. |
||||||||||||||||||||||||
SpeakerVolControlMedium |
Command to set the modem speaker volume to medium. |
|
KCDTIdSpeakerVolControlMedium |
Short text |
Hayes AT command, specifically L1 |
||||||||||||||||||||||||
SpeakerVolControlHigh |
Command to set the modem speaker volume to high. |
|
KCDTIdSpeakerVolControlHigh |
Short text |
Hayes AT command, specifically L2. |
||||||||||||||||||||||||
SpeakerAlwaysOff |
Command to set the modem speaker always off. |
|
KCDTIdSpeakerAlwaysOff |
Short text |
Hayes AT command, specifically M0. |
||||||||||||||||||||||||
SpeakerOnUntilCarrier |
Command to set the modem speaker on untill the carrier. |
|
KCDTIdSpeakerOnUntilCarrier |
Short text |
Hayes AT command, specifically M1. |
||||||||||||||||||||||||
SpeakerAlwaysOn |
Command to set the modem speaker on. |
|
KCDTIdSpeakerAlwaysOn |
Short text |
Hayes AT command, specifically M2 |
||||||||||||||||||||||||
SpeakerOnAfterUntilCarrier |
Command to set the modem speaker on except during dialling. |
|
KCDTIdSpeakerOnAfterUntilCarrier |
Short text |
Hayes AT command, specifically M3. |
||||||||||||||||||||||||
DialToneWaitModifier |
The dial command modifier waits for dial tone |
|
KCDTIdDialToneWaitModifier |
Short text |
Hayes AT command, specifically W. |
||||||||||||||||||||||||
CallProgress1 |
Disable busy and dial tone detection |
|
KCDTIdCallProgress1 |
Short text |
Hayes AT command, specifically X1. |
||||||||||||||||||||||||
CallProgress2 |
Dial tone detection is enabled and busy detection is disabled |
|
KCDTIdCallProgress2 |
Short text |
Hayes AT command, specifically X2. |
||||||||||||||||||||||||
CallProgress3 |
Dial tone detection is disabled and busy detection is enabled |
|
KCDTIdCallProgress3 |
Short text |
Hayes AT command, specifically X3. |
||||||||||||||||||||||||
CallProgress4 |
Both dial tone and busy detection are enabled |
|
KCDTIdCallProgress4 |
Short text |
Hayes AT command, specifically X4. |
||||||||||||||||||||||||
EchoOff |
Switch echo mode off |
|
KCDTIdEchoOff |
Short text |
Hayes AT command, specifically E0. |
||||||||||||||||||||||||
VerboseText |
Switch verbose mode on |
|
KCDTIdVerboseText |
Short text |
Hayes AT command, specifically V1. |
||||||||||||||||||||||||
QuietOff |
Switch to quiet mode off |
|
KCDTIdQuietOff |
Short text |
Hayes AT command, specifically Q0. |
||||||||||||||||||||||||
QuietOn |
Switch to quiet mode on |
|
KCDTIdQuietOn |
Short text |
Hayes AT command, specifically Q1. |
||||||||||||||||||||||||
DialCommandStateModifier |
Dial command modifier- used to return to command mode after dialling. |
|
KCDTIdDialCommandStateModifier |
Short text |
Hayes AT command, specifically ; |
||||||||||||||||||||||||
OnLine |
Enter on-line mode from on-line command mode |
|
KCDTIdOnLine |
Short text |
Hayes AT command, specifically O |
||||||||||||||||||||||||
ResetConfiguration |
Reset the modem configuration |
|
KCDTIdResetConfiguration |
Short text |
Hayes AT command, specifically Z |
||||||||||||||||||||||||
ReturnToFactoryDefs |
Reset the modem configuration to factory defaults |
|
KCDTIdReturnToFactoryDefs |
Short text |
Hayes AT command, specifically &F |
||||||||||||||||||||||||
DCDOnDuringLink |
Command the modem to only assert DCD when a carrier is actually detected |
|
KCDTIdDcdOnDuringLink |
Short text |
Hayes AT command, specifically &C1 |
||||||||||||||||||||||||
DTRHangUp |
Command the modem to hang up the current call when the DTE drops the DTR line |
|
KCDTIdDtrHangUp |
Short text |
Hayes AT command, specifically &D2 |
||||||||||||||||||||||||
DSRAlwaysOn |
Command the modem to always assert DSR |
|
KCDTIdDsrAlwaysOn |
Short text |
Hayes AT command, specifically &S0 |
||||||||||||||||||||||||
RTSCTSHandshake |
Command the modem to use RTS/CTS flow control |
|
KCDTIdRtsCtsHandshake |
Short text |
Hayes AT command, specifically &K3 |
||||||||||||||||||||||||
XonXoffHandshake |
Command the modem to use software flow control. |
|
KCDTIdXonXoffHandshake |
Short text |
Hayes AT command, specifically &K4 |
||||||||||||||||||||||||
EscapeCharacter |
The character used by the DTE to return to command mode from on-line mode. |
|
KCDTIdEscapeCharacter |
Short text |
A single character such as + |
||||||||||||||||||||||||
EscapeGuardPeriod |
Command the modem to use a particular escape sequence guard period. |
|
KCDTIdEscapeGuardPeriod |
Short text |
Hayes AT command, specifically S12 |
||||||||||||||||||||||||
NoDialTone |
Modem response when no dial tone is detected. |
|
KCDTIdNoDialTone |
Short text |
NODIALTONE |
||||||||||||||||||||||||
Busy |
Modem response when a busy tone is detected. |
|
KCDTIdBusy |
Short text |
BUSY |
||||||||||||||||||||||||
NoAnswer |
Modem response when no answer is detected. |
|
KCDTIdNoAnswer |
Short text |
NOANSWER |
||||||||||||||||||||||||
Carrier |
Carrier report message. |
|
KCDTIdCarrier |
Short text |
CARRIER |
||||||||||||||||||||||||
Connect |
Connection report message. |
|
KCDTIdConnect |
Short text |
CONNECT |
||||||||||||||||||||||||
CompressionClass5 |
Compression Class 5 report message. |
|
KCDTIdCompressionClass5 |
Short text |
COMPRESSION:CLASS 5 |
||||||||||||||||||||||||
CompressionV42bis |
Compression V.42 bis report message. |
|
KCDTIdCompressionV42bis |
Short text |
COMPRESSION:V.42 bis |
||||||||||||||||||||||||
CompressionNone |
No compression report message |
|
KCDTIdCompressionNone |
Short text |
COMPRESSION:NONE |
||||||||||||||||||||||||
PrototcolLAPD |
LAPD protocol report message |
|
KCDTIdProtocolLapd |
Short text |
PROTOCOL:LAPD |
||||||||||||||||||||||||
ProtocolALT |
ALT protocol report message |
|
KCDTIdProtocolAlt |
Short text |
PROTOCOL:ALT |
||||||||||||||||||||||||
ProtocolALTCELLULAR |
ALT-CELLULAR report message |
|
KCDTIdProtocolAltcellular |
Short text |
PROTOCOL:ALT-CELLULAR |
||||||||||||||||||||||||
ProtocolNone |
No protocol report message. |
|
KCDTIdProtocolNone |
Short text |
PROTOCOL:NONE |
||||||||||||||||||||||||
MessageCentreNumber |
Phone number of message centre. |
|
KCDTIdMessageCentreNumber |
Integer |
Message Centre telephone number |
||||||||||||||||||||||||
MessageValidityPeriod |
Validity period for SMS in minutes |
|
KCDTIdMessageValidityPeriod |
Integer |
User defined integer specifying a time period in minutes |
||||||||||||||||||||||||
MessageDeliveryReport |
A boolean flag to specifies whether to produce SMS delivery report |
|
KCDTIdMessageDeliveryReport |
Boolean |
|
||||||||||||||||||||||||
MinimumSignalLevel |
Minimum signal strength of the modem. This is the minimum signal level required for a connection to succeed. The connection will fail if below this level. Setting the column to null will turn off this functionality. The value must be in dBm with an offset of 10000 added to it |
|
KCDTIdMinSignalLevel |
Integer |
User defined integer value specifying the signal level. |
||||||||||||||||||||||||
LastSocketActivityTimeout |
Time (in seconds) to stay online when all socket activity has ceased |
|
KCDTIdLastSocketActivityTimeout |
Integer |
User defined integer specifying time in seconds |
||||||||||||||||||||||||
LastSessionClosedTimeout |
Time (in seconds) to stay online when session has closed |
|
KCDTIdLastSessionClosedTimeout |
Integer |
User defined integer specifying time in seconds |
||||||||||||||||||||||||
LastSocketClosedTimeout |
Time (in seconds) to stay online when socket has closed |
C |
KCDTIdLastSocketClosedTimeout |
Integer |
User defined integer specifying time in seconds |
||||||||||||||||||||||||
SirSettings |
This field sets the serial port's infra-red settings. This enables the range of infrared to be set, to modify the pulse width or even to completely shutdown serial infrared. |
|
KCDTIdSirSettings |
Integer |
|
||||||||||||||||||||||||
CommRole |
Specifies whether comm port should be opened in the role of DTE or DCE. The content of this field is a bit mask. The value of this is ANDed with KModemCommRoleDCE. For example, say the value of CommRole is 1 then the role set is DCE, else the role set is DTE. (see KModemCommRoleDCE). |
|
KCDTIdCommRole |
Integer |
Integer bitmask |
This table contains the configuration settings for each available network. One record should be created for each network. This table is very useful for multi-homing.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdNetworkRecord
.
Field name | Description | Possible values |
---|---|---|
Name |
A name for the network. Each network is given a unique name . This field is configured only to support multi-homing |
User defined network name such as Intranet1 |
This table contains the details of the proxy server used. This is an optional table that should be configured when a proxy server is used.
The page on reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdProxiesRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible values | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
ISP |
The information regarding the ISP |
|
KCDTIdISP |
Integer |
A reference to a record in the serviice table specified by the ProxyServiceType field |
||||||
ProxyServiceType |
The service table information |
|
KCDTIdProxyServiceType |
Short text |
Name of the service table used such as DialOutISP, IncomingGPRS,etc |
||||||
UseProxyServer |
A boolean flag specifying whether to use a proxy server |
|
KCDTIdUseProxyServer |
Boolean |
|
||||||
ProtocolName |
Name of the protocol that can be used by the proxy server |
|
KCDTIdProtocolName |
Short text |
User defined protocol name such as Http |
||||||
ProxyServerName |
Name of the proxy server used if any |
|
KCDTIdServerName |
Long text |
Proxy server's URL |
||||||
PortNumber |
Port number used by the proxy server |
|
KCDTIdPortNumber |
Integer |
A port number |
||||||
Exceptions |
A list of addresses for which the proxy server should not be used |
|
KCDTIdExceptions |
Long text |
URL address separated by semicolon |
This table contains the details of the user account used to pay for certain services. This is an optional table.
The reference table structure gives the meaning of individual columns in the tables.
Record ID for table: KCDTIdChargecardRecord
.
Field name | Description | CommsDat field name | CommsDat field ID | Field value type | Possible values |
---|---|---|---|---|---|
AccountNumber |
User's account number |
|
KCDTIdAccountNumberr |
Short text |
A valid account number |
Pin |
PIN number of the account. The pin will be masked by * |
|
KCDTIdPin |
Short text |
A valid pin number |
LocalRule |
Operator dependant rule specifying the order in which the account information is used for local calls |
|
KCDTIdLocalRule |
Short text |
Operator dependant rule |
NatRule |
Operator dependant rule specifying the order in which the account information is used for national calls |
|
KCDTIdNatRule |
Short text |
Operator dependant rule |
IntlRule |
Operator dependant rule specifying the order in which the account information is used for international calls |
|
KCDTIdIntlRule |
Short text |
Operator dependant rule |