Symbian3/PDK/Source/GUID-9AF990D7-C490-5D60-9816-E84B5165A5B2.dita
changeset 14 578be2adaf3e
parent 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-9AF990D7-C490-5D60-9816-E84B5165A5B2.dita	Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-9AF990D7-C490-5D60-9816-E84B5165A5B2.dita	Fri Aug 13 16:47:46 2010 +0100
@@ -1,80 +1,80 @@
-<?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 concept
-  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
-<concept id="GUID-9AF990D7-C490-5D60-9816-E84B5165A5B2" xml:lang="en"><title>BIO
-Watcher Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>The BIO Watcher component is part of the Watcher Framework that handles
-BIO messages that come from the SMS and WAP stack. </p>
-<section id="GUID-A69FED58-8F99-4F6A-8F30-587AB6FA1A7A"><title>Purpose</title> <p>To handle BIO messages that come from the
-SMS stack and WAP stack. </p> </section>
-<section id="GUID-5FF9CFB3-34FE-46BF-B91C-24CFA2F423A7"><title>Key terms</title> <dl>
-<dlentry>
-<dt>Replace-type-messages</dt>
-<dd><p>Replace-type-messages are SMS messages received from the service centre,
-where the protocol identifier contains a <b>Replace Short Message Type</b> code. </p> </dd>
-</dlentry>
-<dlentry>
-<dt>BIO message</dt>
-<dd><p>Bearer Independent Objects (BIO) messages contain data that can be
-received and interpreted by the device, see <xref href="GUID-17DE7D55-00C9-5D40-8AE4-39BDB20FCC5B.dita">BIO
-Watcher Framework</xref> for more details. </p> </dd>
-</dlentry>
-</dl> </section>
-<section id="GUID-0FEFAE52-D59F-42CF-AEA4-80CCEE26E7D5"><title>Architecture</title> <p>BIO Watcher is made of two watchers—NBS
-Watcher and WAP Watcher. The Watcher Framework supports both of them. </p> <p> <b>NBS
-watcher:</b> The NBS watcher handles the reception of SMS messages. When initialised
-by Watcher Framework, the watcher queries the BIO Messaging database for BIO
-messages that are of type <codeph>ENbs</codeph>. For each of these BIO messages,
-the watcher creates an object that opens a connection to the SMS stack and
-waits for the particular message type. The message types are either defined
-by the port number that the message is received on or by a string to watch
-for at the start of the message. </p> <p>When the NBS Watcher receives a non-class
-2 SMS message, it creates a new entry under the global inbox in the Message
-Store. For class 2 messages, the entry is created in the class 2 folder as
-defined by the SMS settings, which can be the global inbox. The details field
-of the entry is used to store the phone number of the incoming message or
-the name of the sender (provided if the watcher finds a match for the phone
-number in the contacts database). The description field is used to store the
-first N characters of the SMS message, where N is defined in the SMS settings,
-or for BIO messages, the description as retrieved from the BIO database. BIO
-messages also have the <codeph>BioType</codeph> field set to the UID of the
-BIO message as retrieved from the BIO database. The <xref href="GUID-790D9BA9-2FB7-3073-AF2F-FFD049C3FD3D.dita"><apiname>CSmsHeader</apiname></xref> class,
-which is a wrapper around the <xref href="GUID-FA6D9B1B-3845-3B81-ACBB-34977D3C9631.dita"><apiname>CSmsMessage</apiname></xref> class provided
-by the SMS Stack component, is used to externalise the SMS message to the
-entry’s <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref>. The watcher also places a copy of the
-body text of the message in the rich text stream of the entry’s <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref>. </p> <p>The
-NBS Watcher is also responsible for handing the following special SMS types: </p> <ul>
-<li id="GUID-ED0F0075-FEF7-5195-B4E3-92A228830838"><p> <b>Replace type messages:</b> When
-the watcher receives a replace type message, it scans the folder (where the
-message is delivered to) for messages that have a matching protocol ID and
-from address. For each of the messages, it checks the time stamps from the
-service centre and discards the older message. </p> </li>
-<li id="GUID-6BD849B6-045C-5E67-B31F-5202302A6EA1"><p> <b>Message indications:</b> The
-watcher can listen for incoming message waiting indications. The <xref href="GUID-A9FE5C23-4F39-345E-873B-682D9807BAA0.dita"><apiname>CSmsSettings</apiname></xref> class
-defines whether the watcher listens and delivers the messages to the Inbox
-or discards them. If the watcher is configured to listen for messages, it
-uses the SMS utilities in the SMS Client MTM to decode the message to determine
-the notification type and number of messages. </p> </li>
-<li id="GUID-2884C04E-161F-5E02-92BC-0295240167E5"><p> <b>Delivery reports:</b> The
-watcher can be configured to listen to the delivery reports. The SMS utilities
-get a string from the <filepath>SMSs.rss</filepath> resource file to generate
-descriptions and details fields to store with SMS messages. </p> </li>
-</ul> <p> <b>WAP watcher:</b> The WAP watcher listens for incoming messages
-from the WAP stack using the WAP Message API. To determine ports to listen
-for messages, the watcher queries the BIO database for BIO message types—<codeph>EWsp</codeph>, <codeph>EWspSecure</codeph>, <codeph>EWap</codeph>, <codeph>EWapSecure</codeph> and registers them as an observer of the BIO
-database. It listens for new BIO message with these types when they are added.
-The watcher stores the messages in the global inbox tagged with the BIO type
-listed in the BIO database. </p> <p> <b>Note:</b> The Symbian
-platform provides the preceding two watchers, but licensees can write their
-own watchers. </p> </section>
-<section id="GUID-3CA936AF-57E4-448A-AEF5-91EDE6F52AE3"><title>See also</title> <p><xref href="GUID-E18592CD-223D-5B50-AF40-1AC7267BAB8C.dita">Watcher
-Framework</xref>  </p> </section>
+<?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 concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-9AF990D7-C490-5D60-9816-E84B5165A5B2" xml:lang="en"><title>BIO
+Watcher Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The BIO Watcher component is part of the Watcher Framework that handles
+BIO messages that come from the SMS and WAP stack. </p>
+<section id="GUID-A69FED58-8F99-4F6A-8F30-587AB6FA1A7A"><title>Purpose</title> <p>To handle BIO messages that come from the
+SMS stack and WAP stack. </p> </section>
+<section id="GUID-5FF9CFB3-34FE-46BF-B91C-24CFA2F423A7"><title>Key terms</title> <dl>
+<dlentry>
+<dt>Replace-type-messages</dt>
+<dd><p>Replace-type-messages are SMS messages received from the service centre,
+where the protocol identifier contains a <b>Replace Short Message Type</b> code. </p> </dd>
+</dlentry>
+<dlentry>
+<dt>BIO message</dt>
+<dd><p>Bearer Independent Objects (BIO) messages contain data that can be
+received and interpreted by the device, see <xref href="GUID-17DE7D55-00C9-5D40-8AE4-39BDB20FCC5B.dita">BIO
+Watcher Framework</xref> for more details. </p> </dd>
+</dlentry>
+</dl> </section>
+<section id="GUID-0FEFAE52-D59F-42CF-AEA4-80CCEE26E7D5"><title>Architecture</title> <p>BIO Watcher is made of two watchers—NBS
+Watcher and WAP Watcher. The Watcher Framework supports both of them. </p> <p> <b>NBS
+watcher:</b> The NBS watcher handles the reception of SMS messages. When initialised
+by Watcher Framework, the watcher queries the BIO Messaging database for BIO
+messages that are of type <codeph>ENbs</codeph>. For each of these BIO messages,
+the watcher creates an object that opens a connection to the SMS stack and
+waits for the particular message type. The message types are either defined
+by the port number that the message is received on or by a string to watch
+for at the start of the message. </p> <p>When the NBS Watcher receives a non-class
+2 SMS message, it creates a new entry under the global inbox in the Message
+Store. For class 2 messages, the entry is created in the class 2 folder as
+defined by the SMS settings, which can be the global inbox. The details field
+of the entry is used to store the phone number of the incoming message or
+the name of the sender (provided if the watcher finds a match for the phone
+number in the contacts database). The description field is used to store the
+first N characters of the SMS message, where N is defined in the SMS settings,
+or for BIO messages, the description as retrieved from the BIO database. BIO
+messages also have the <codeph>BioType</codeph> field set to the UID of the
+BIO message as retrieved from the BIO database. The <xref href="GUID-790D9BA9-2FB7-3073-AF2F-FFD049C3FD3D.dita"><apiname>CSmsHeader</apiname></xref> class,
+which is a wrapper around the <xref href="GUID-FA6D9B1B-3845-3B81-ACBB-34977D3C9631.dita"><apiname>CSmsMessage</apiname></xref> class provided
+by the SMS Stack component, is used to externalise the SMS message to the
+entry’s <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref>. The watcher also places a copy of the
+body text of the message in the rich text stream of the entry’s <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref>. </p> <p>The
+NBS Watcher is also responsible for handing the following special SMS types: </p> <ul>
+<li id="GUID-ED0F0075-FEF7-5195-B4E3-92A228830838"><p> <b>Replace type messages:</b> When
+the watcher receives a replace type message, it scans the folder (where the
+message is delivered to) for messages that have a matching protocol ID and
+from address. For each of the messages, it checks the time stamps from the
+service centre and discards the older message. </p> </li>
+<li id="GUID-6BD849B6-045C-5E67-B31F-5202302A6EA1"><p> <b>Message indications:</b> The
+watcher can listen for incoming message waiting indications. The <xref href="GUID-A9FE5C23-4F39-345E-873B-682D9807BAA0.dita"><apiname>CSmsSettings</apiname></xref> class
+defines whether the watcher listens and delivers the messages to the Inbox
+or discards them. If the watcher is configured to listen for messages, it
+uses the SMS utilities in the SMS Client MTM to decode the message to determine
+the notification type and number of messages. </p> </li>
+<li id="GUID-2884C04E-161F-5E02-92BC-0295240167E5"><p> <b>Delivery reports:</b> The
+watcher can be configured to listen to the delivery reports. The SMS utilities
+get a string from the <filepath>SMSs.rss</filepath> resource file to generate
+descriptions and details fields to store with SMS messages. </p> </li>
+</ul> <p> <b>WAP watcher:</b> The WAP watcher listens for incoming messages
+from the WAP stack using the WAP Message API. To determine ports to listen
+for messages, the watcher queries the BIO database for BIO message types—<codeph>EWsp</codeph>, <codeph>EWspSecure</codeph>, <codeph>EWap</codeph>, <codeph>EWapSecure</codeph> and registers them as an observer of the BIO
+database. It listens for new BIO message with these types when they are added.
+The watcher stores the messages in the global inbox tagged with the BIO type
+listed in the BIO database. </p> <p> <b>Note:</b> The Symbian
+platform provides the preceding two watchers, but licensees can write their
+own watchers. </p> </section>
+<section id="GUID-3CA936AF-57E4-448A-AEF5-91EDE6F52AE3"><title>See also</title> <p><xref href="GUID-E18592CD-223D-5B50-AF40-1AC7267BAB8C.dita">Watcher
+Framework</xref>  </p> </section>
 </conbody></concept>
\ No newline at end of file