Symbian3/PDK/Source/GUID-266B3FD6-A414-599D-BF31-FF67ADDD4E70.dita
changeset 14 578be2adaf3e
parent 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-266B3FD6-A414-599D-BF31-FF67ADDD4E70.dita	Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-266B3FD6-A414-599D-BF31-FF67ADDD4E70.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-266B3FD6-A414-599D-BF31-FF67ADDD4E70" xml:lang="en"><title>SMS
-Stack Configuration for Class 0 Messages</title><shortdesc>This section describes how Class 0 SMS messages are handled in
-Symbian platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
-
-<section id="GUID-73942F43-66DA-5C58-837D-EBF75CF68254"><title>Introduction</title> <p>According
-to the 3GPP specification TS 23.038, a mobile terminated Class 0 SMS message
-should be displayed to the user immediately even if there is no memory available
-in the Universal Subscriber Identity Module (U)SIM or the phone memory. </p> </section>
-<section id="GUID-3E7EA24B-A540-5D98-A77B-53B8C5A6A93F"><title>Class 0 SMS</title> <p><b>Normal
-condition </b> </p> <p>The SMS stack receives message segments from the network
-through the telephony system plug-in (TSY). The received segments are acknowledged
-and passed to the reassembly store to assemble all the received segments.
-The message is then forwarded to the clients. The reassembly store is a permanent
-file store and the message segments are stored as streams. </p> <p><b>Out of disk condition </b> </p> <p>When sufficient disk space is not available
-the SMS stack is unable to reassemble the message segments and pass them to
-the clients due to lack of memory. A pre-allocated memory, which can be configured,
-is available for handling the class 0 SMS . </p> <p><b>Pre - allocated memory </b> </p> <p>When this feature is configured a
-separate memory is available for handling the Class 0 SMS messages when sufficient
-disk space is not available. This can be enabled by adding a <codeph>ReassemblyStore</codeph> section
-in the <codeph>.esk</codeph> file. The pre-allocated memory is created during
-the phone boot time and hence it is always created. </p> </section>
-<section id="GUID-2F30F88B-1BBA-403E-8E29-21BFE729E6D5"><title>Configuring the SMS stack</title> <p>The <codeph>.esk</codeph> file
-is used to customise the SMS stack to handle Class 0 SMS messages. The following
-section should be added to allocate a separate memory for the Class 0 SMS
-in out of disk situations. The reserve memory is allocated by the SMS stack. </p> <codeblock id="GUID-AA2A2F3A-6D49-5460-9591-B5AC548A6B88" xml:space="preserve">
-[ReassemblyStore]
-
-Class0=1
-
-MaxClass0Messages= 10
-
-NumberOfPDUsegments= 20
-
-GuardTimeOut= 12
-</codeblock> <p><b>ESK
-configuration fields</b> </p> <p><b>Class0 </b> </p> <p>This field must be set to 1 to enable the SMS stack
-to allocate reserve memory. When the Class 0 field is set to 0 or is not configured,
-Class 0 SMS messages are handled as normal SMS by the SMS stack. </p> <p>When
-Class0 is set to 1 and other fields are not configured the default values,
-configured above, are used by the SMS stack. </p> <p> <i>Note: The following
-fields are optional</i>. </p> <p><b>MaxClass0Messages </b> </p> <p>This field stores an integer value to specify
-the maximum number of Class 0 messages to be stored. The default value is
-10. </p> <p><b>NumberOfPDUSegments </b> </p> <p>This field stores an integer value to
-specify the number of PDU segments that can be stored in the reserve memory.
-The default value is 20. </p> <p><b>GuardTime </b> </p> <p>This field stores a value that specifies the time
-that the SMS stack must wait for a message to be completely received before
-forwarding the message to clients. The default value is 12 hours. If all the
-segments of the SMS are received then the SMS is forwarded to the messaging
-clients before the guard time expires. </p> </section>
-<section id="GUID-0288C480-9EE4-4218-8B08-93B220883690"><title>SMS stack behaviour</title> <p>The SMS stack receives and
-processes SMS messages from the TSY. If the received message is a Class 0
-SMS and if sufficient memory is available the stack attempts to store the
-message in the permanent store. If sufficient memory is not available, and
-the stack is configured to handle Class 0 messages in out of disk conditions,
-it uses the pre-allocated reserve memory to reassemble the segments. </p> <p><b>Maximum number of segments exceeded </b> </p> <p>The stack waits to receive
-all segments of the Class 0 SMS. The maximum number of segments depends on
-the value specified in the <codeph>NumberOfPDUSegments</codeph> field. If
-the stack exceeds the maximum level it reassembles the partial message and
-forwards it to the clients. If the maximum number of segments is not exceeded
-then the stack waits for the duration of the guard period specified in the <filepath>.esk</filepath> file.
-If the duration expires then a partial message is reassembled and forwarded
-to the clients. </p> <p><b>Maximum number of messages exceeded </b> </p> <p>When the stack receives
-a Class 0 SMS after it has reached the configured number of messages, it reassembles
-the oldest incomplete message and forwards it to the client. </p> <p><b>Type 0 SMS </b> </p> <p>Type 0 messages are generally positively acknowledged
-and discarded. Class 0 Type 0 message are handled as explained above both
-in normal and out of disk conditions. All other Type 0 messages are handled
-as non class 0 messages. </p> <p><b>WAP class 0 messages over SMS bearer </b> </p> <p>The Class 0 messages
-that contain WAP datagram are handled as non class 0 messages. </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-266B3FD6-A414-599D-BF31-FF67ADDD4E70" xml:lang="en"><title>SMS
+Stack Configuration for Class 0 Messages</title><shortdesc>This section describes how Class 0 SMS messages are handled in
+Symbian platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+
+<section id="GUID-73942F43-66DA-5C58-837D-EBF75CF68254"><title>Introduction</title> <p>According
+to the 3GPP specification TS 23.038, a mobile terminated Class 0 SMS message
+should be displayed to the user immediately even if there is no memory available
+in the Universal Subscriber Identity Module (U)SIM or the phone memory. </p> </section>
+<section id="GUID-3E7EA24B-A540-5D98-A77B-53B8C5A6A93F"><title>Class 0 SMS</title> <p><b>Normal
+condition </b> </p> <p>The SMS stack receives message segments from the network
+through the telephony system plug-in (TSY). The received segments are acknowledged
+and passed to the reassembly store to assemble all the received segments.
+The message is then forwarded to the clients. The reassembly store is a permanent
+file store and the message segments are stored as streams. </p> <p><b>Out of disk condition </b> </p> <p>When sufficient disk space is not available
+the SMS stack is unable to reassemble the message segments and pass them to
+the clients due to lack of memory. A pre-allocated memory, which can be configured,
+is available for handling the class 0 SMS . </p> <p><b>Pre - allocated memory </b> </p> <p>When this feature is configured a
+separate memory is available for handling the Class 0 SMS messages when sufficient
+disk space is not available. This can be enabled by adding a <codeph>ReassemblyStore</codeph> section
+in the <codeph>.esk</codeph> file. The pre-allocated memory is created during
+the phone boot time and hence it is always created. </p> </section>
+<section id="GUID-2F30F88B-1BBA-403E-8E29-21BFE729E6D5"><title>Configuring the SMS stack</title> <p>The <codeph>.esk</codeph> file
+is used to customise the SMS stack to handle Class 0 SMS messages. The following
+section should be added to allocate a separate memory for the Class 0 SMS
+in out of disk situations. The reserve memory is allocated by the SMS stack. </p> <codeblock id="GUID-AA2A2F3A-6D49-5460-9591-B5AC548A6B88" xml:space="preserve">
+[ReassemblyStore]
+
+Class0=1
+
+MaxClass0Messages= 10
+
+NumberOfPDUsegments= 20
+
+GuardTimeOut= 12
+</codeblock> <p><b>ESK
+configuration fields</b> </p> <p><b>Class0 </b> </p> <p>This field must be set to 1 to enable the SMS stack
+to allocate reserve memory. When the Class 0 field is set to 0 or is not configured,
+Class 0 SMS messages are handled as normal SMS by the SMS stack. </p> <p>When
+Class0 is set to 1 and other fields are not configured the default values,
+configured above, are used by the SMS stack. </p> <p> <i>Note: The following
+fields are optional</i>. </p> <p><b>MaxClass0Messages </b> </p> <p>This field stores an integer value to specify
+the maximum number of Class 0 messages to be stored. The default value is
+10. </p> <p><b>NumberOfPDUSegments </b> </p> <p>This field stores an integer value to
+specify the number of PDU segments that can be stored in the reserve memory.
+The default value is 20. </p> <p><b>GuardTime </b> </p> <p>This field stores a value that specifies the time
+that the SMS stack must wait for a message to be completely received before
+forwarding the message to clients. The default value is 12 hours. If all the
+segments of the SMS are received then the SMS is forwarded to the messaging
+clients before the guard time expires. </p> </section>
+<section id="GUID-0288C480-9EE4-4218-8B08-93B220883690"><title>SMS stack behaviour</title> <p>The SMS stack receives and
+processes SMS messages from the TSY. If the received message is a Class 0
+SMS and if sufficient memory is available the stack attempts to store the
+message in the permanent store. If sufficient memory is not available, and
+the stack is configured to handle Class 0 messages in out of disk conditions,
+it uses the pre-allocated reserve memory to reassemble the segments. </p> <p><b>Maximum number of segments exceeded </b> </p> <p>The stack waits to receive
+all segments of the Class 0 SMS. The maximum number of segments depends on
+the value specified in the <codeph>NumberOfPDUSegments</codeph> field. If
+the stack exceeds the maximum level it reassembles the partial message and
+forwards it to the clients. If the maximum number of segments is not exceeded
+then the stack waits for the duration of the guard period specified in the <filepath>.esk</filepath> file.
+If the duration expires then a partial message is reassembled and forwarded
+to the clients. </p> <p><b>Maximum number of messages exceeded </b> </p> <p>When the stack receives
+a Class 0 SMS after it has reached the configured number of messages, it reassembles
+the oldest incomplete message and forwards it to the client. </p> <p><b>Type 0 SMS </b> </p> <p>Type 0 messages are generally positively acknowledged
+and discarded. Class 0 Type 0 message are handled as explained above both
+in normal and out of disk conditions. All other Type 0 messages are handled
+as non class 0 messages. </p> <p><b>WAP class 0 messages over SMS bearer </b> </p> <p>The Class 0 messages
+that contain WAP datagram are handled as non class 0 messages. </p> </section>
 </conbody></concept>
\ No newline at end of file