products.jpg
Configuration file format (CML)

http://www.winwap.com/DTD/cml10.dtd

The quick configuration functinality is designed so that a user does not have to set dial-up information and gateway settings manually. Simply by importing a file, or running a setup application on the PC with an Activesync connection the user will get some specific operators settings set up on the device automatically. The format is named CML (Connection Markup Language).

The connection file format:

<!ENTITY % boolean "(true|false)">
The boolean type refers to logical value of true or false/


<!ELEMENT cml (ras+)>
<!ATTLIST cml
provider CDATA #IMPLIED
>
The cml element defines a deck and encloses all information and RAS settings in the deck.

<!ELEMENT ras (auth, (proxy | gateway)?)>
<!ATTLIST ras
name CDATA #REQUIRED
autodial %boolean "true"
country NMTOKEN #IMPLIED
area NMTOKEN #IMPLIED
phone NMTOKEN #REQUIRED
>

The ras element is a container of proxy or gateway settings. A ras must contain authentication information. The country attribute specifies the country code portion of the provider phone number. The area attribute contains the area code. Do not include parentheses or other delimiters in the area code string. (For example, "206" is a valid area code; "(206)" is not.) The phone attribute specifies provider phone number. If the area code is set, one combines phone with the country and area codes. If the area code is not set, one uses the phone string as the entire phone number.

<!ELEMENT auth EMPTY>
<!ATTLIST auth
username CDATA #REQUIRED
password CDATA #REQUIRED
>

The auth element sets authentication settings.

<!ELEMENT proxy (auth?)>
<!ATTLIST proxy
addr CDATA #REQUIRED
port NMTOKEN "80"
>

The proxy element sets proxy settings.

<!ELEMENT gateway EMPTY>
<!ATTLIST gateway
addr CDATA #REQUIRED
port NMTOKEN "9200"
cor %boolean "false"
>

The gateway element sets WAP gateway settings. The cor attribute specifies connection oriented or connection less session establishing.