<?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 xml:lang="en" id="GUID-697087D6-C029-51E8-8722-9E2584420276"><title>SMS Stack Architecture</title><shortdesc>The SMS Stack is a plug-in to the socket server. This section provides the architectural relationships of the SMS stack. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody><section><title>SMS stack components</title> <ol id="GUID-B7B94BE7-8F08-5104-9741-87600C6B2BB2"><li id="GUID-A354C7A1-7DE5-571F-9DFB-2F3AC90ED12D"><p>SMSPROT - The SMS stack protocol module </p> </li> <li id="GUID-7636FB1A-5162-5136-8ADD-2C4DCE36818A"><p>GSMU - GSM Utility class </p> </li> <li id="GUID-B9C83C25-4727-5992-A40A-83EFDABFE2FF"><p>SMSU - SMS Utility class </p> </li> </ol> <p><b>SMSPROT</b> </p> <p>SMSPROT.prt is a socket server (ESOCK) plug-in DLL implemented with a protocol module suffix <codeph>PRT</codeph>. The main functions of the SMS protocol module are to send queues, receive queues and maintain the connection to the socket server. For more information about SMSPROT, <xref href="GUID-4ADE94EF-346F-541A-B0FB-AF43ADB1C66D.dita">see SMS Protocol Modules</xref>. </p> <p><b>GSMU</b> </p> <p>The GSM Utility (GSMU) class provides some utility functions for the SMS stack. The SMS messages are represented by a <xref href="GUID-FA6D9B1B-3845-3B81-ACBB-34977D3C9631.dita"><apiname>CSmsMessage</apiname></xref> object of the GSMU class. GSMU also provide methods to send and receive the SMS messages through the socket server. For more information about GSMU, <xref href="GUID-A957A1DF-AF81-5A9D-BB44-1B34B2EB809E.dita">see GSM Utilities</xref>. </p> <p><b>SMSU</b> </p> <p>The SMS Utility (SMSU) class provides the base class for active objects of the SMS stack. For more information about SMSU, <xref href="GUID-A4FBD7D4-DCC0-517A-BCAA-D36D8940A64D.dita">see SMS Utilities</xref>. </p> <fig id="GUID-B0D5C075-FE00-5E3B-9F1A-C6F9D45A3BF3"><title>

             SMS Stack Architectural Relationships

#smswap.sms.esk

[sockman]

protocols= sms

[sms]

filename= SMSPROT.PRT

index= 1

</codeblock> <p>The SMS stack is initialised and loaded when the first client makes a request to the stack through the socket server. The SMS stack is unloaded when the last client disconnects. The ESK file is used to customise different time out values.For more information see <xref href="GUID-EE0D8964-C343-5389-8932-9AC48DCC67FD.dita">Configuration</xref>. </p> </section> <section><title>SMS communication</title> <p>The three main components that enable applications to send and receive SMS messages are the baseband signalling stack, Telephony system plug-in (TSY) and the SMS stack. The SMS stack communicates with the baseband signalling stack through the TSY to send and receive the messages from the network. The different types of receive modes are defined in the <xref href="GUID-AAFF75F0-B2F2-33D9-AE9D-7AC5B7EDD801.dita"><apiname>TMobileSmsReceiveMode</apiname></xref> class. Receive modes describe how a message is processed by the SMS stack. </p> <p><b>EReceiveStored </b> </p> <p>In <xref href="GUID-78CBD8FD-99CE-304C-A2BE-81287EB5555E.dita"><apiname>EReceiveStored</apiname></xref> mode, the baseband stack stores the incoming SMS messages. The baseband stack acknowledges to the network before it passes the SMS to the TSY. The message is then passed to the SMS stack for processing. The message is stored in the reassembly store until it is processed. If the processing is successful, a positive acknowledgement is sent to the TSY. If the processing is unsuccessful, a negative acknowledgement is sent to the TSY and the message is processed later by sending a resume command to the TSY. Since the message is stored in the baseband stack it is not lost due to lack of memory in the SMS stack. The disadvantage of this method is that the network is acknowledged even if the message is not passed to the messaging client. </p> <p><b>EReceiveUnstoredPhoneAck </b> </p> <p>In <xref href="GUID-D1BC871D-76F9-3A12-9979-6E06EBFABE8C.dita"><apiname>EReceiveUnstoredPhoneAck</apiname></xref> mode, the message is acknowledged as soon as it is received by the baseband stack but it is the responsibility of the SMS stack that stores and processes the message. The disadvantage of this mode is that if sufficient memory or disk space is not available the message is lost. The network does not resend the message because of the positive acknowledgement was sent by the baseband stack. </p> <p><b>EReceiveUnstoredClientAck </b> </p> <p>In <xref href="GUID-2A9E4D0B-BBF4-3894-8A4B-E76554751904.dita"><apiname>EReceiveUnstoredClientAck</apiname></xref> mode the baseband stack does not store or acknowledge any incoming SMS messages. The SMS stack has the responsibility to store and acknowledge the received SMS. If sufficient memory is not available the SMS stack rejects the incoming message and sends a negative acknowledgement to the network. The network does not send any other SMS to the device until it receives a resume request from the device. The resume request is initiated by the SMS stack. </p> <p>Two other modes specified in the <xref href="GUID-AAFF75F0-B2F2-33D9-AE9D-7AC5B7EDD801.dita"><apiname>TMobileSmsReceiveMode</apiname></xref> class, they are <xref href="GUID-9F61E856-9E38-37F5-86E6-4AEC6317AFF4.dita"><apiname>EReceiveModeUnspecified</apiname></xref> and <xref href="GUID-133EB470-9241-3285-9B34-DC6522BD1D8E.dita"><apiname>EReceiveEither</apiname></xref>. For more information about the enumerations see the cpp reference documentation. </p> </section> </conbody></concept>