GSM -Utilities

The GSM utility (GSMU) class provides the functionality specified in the -3GPP standards 23.038 and23.040.

Specialised SMS classes

The GSMU provides a specialised -SMS class called TGsmuLex8. TGsmulex8 provides -methods to decode the PDU data.

PDU element classes

The following classes provide -utility methods to encode and decode different elements of a PDU.

- - - -GSMU Class -Functionality - - - - -

TSmsOctet

Provides methods to encode and decode the octets of a PDU

- - -

CSmsAlphabetConverter

Provides methods for character conversion between native type and -user defined type. This class provides the functionality to compliment CSmsBufferSegmenter, TSmsBufferReassembler and TSmsAlphabetPacker.

- - -

CSmsmAddress

Provides methods to represent the recipient device or the service -centre address.

- - -

TGsmSmsTypeOfAddress

Provides methods to specify the type of address used. The type of -address includes the details of the numbering plan indicator and the type -of numbering used.

- - -

TGsmSmsTelNumber

Provides methods to encapsulate basic address information like source -device address, destination address and the service centre address in a SMS -message.

- - -

TSmsServiceCenterTimeStamp

Provides methods to get and set the service centre time stamp in -a SMS message.

- - -

TSmsValidityPeriod

Provides methods to get and set the validity period in a PDU.

- - -

TSmsStatus

Provides methods to get and set the SMS status in the STATUS -REPORT PDU.

- - -

TSmsParameterIndicator

Provides methods to get and set flags in the reports and COMMAND PDUs. -The flags represent extension, user data, data coding scheme and protocol -identifier.

- - -

TSmsProtocolIdentifier

Provides methods to get and set the protocol identifier.

- - -

TSmsCommandType

Provides methods to get and set the type of commands in a COMMAND PDU.

- - -

CSmsuserData

Provides methods to get and set user data elements from a PDU.

- - -

CSmsCommandData

Provides methods to get and set various information elements from -a SMS command message.

- - - -

PDU classes

The following classes provide methods -to create and process the six types of messages DELIVER, SUBMIT, DELIVER -REPORT, SUBMIT REPORT, STATUS REPORT and COMMAND.

- - - -class -Functionality - - - - -

CSmsPDU

Provides generic interface to encode and decode all six types of -PDUs. CSmsPDU provides the common functionalities to encode -and decode different types of PDUs. For more information about the methods -provided by this class see the reference documentation.

- - -

CSmsDeliver

Provides the methods to create a DELIVER PDU.

- - -

CSmsSubmit

Provides methods to create a SUBMIT PDU.

- - -

CSmsDeliverReport

Provides methods to create a DELIVER REPORT PDU. -A DELIVER REPORT message is created to acknowledge a received SMS.

- - -

CSmsSubmitReport

Provides methods to process a SUBMIT REPORT message sent by the -network in response to a submit message. The SUBMIT REPORT contains the result -of the SUBMIT message like if the message was submitted successfully, if not -the reason for the failure.

- - -

CSmsStatusReport

Provides the methods to process the STATUS REPORT message sent by -the network. The message contains the details of the status of a previously -sent SUBMIT message.

- - -

CSmsCommand

Provides methods to create a COMMAND message. This message is mobile -originated and sent to the network requesting some action like status of sent -message.

- - - -

Buffer classes

The GSMU provides the utility classes -to store the SMS messages before segmentation and concatenation. CSmsBufferBase is -the base class to create the buffer space in the memory. CSmsBuffer is -used to store an array of TText in the memory. CSmsEditorBuffer class -is used by the messaging server to store the text in CRichText type.

User data settings

TSmsUserDataSettings class -is used to encapsulate the settings such as character concatenation. The stored -settings affect the encoding and decoding of the messages.

CSmsMessage

CSmsMessage class -is used to represent a complete message inside the SMS stack before segmentation -and a complete message after reassembly. If the message type is class 0, incomplete -messages are also stored by the CSmsMesasge. The complete -message is stored in the CSmsBuffer. The main function -of the CSmsMessage is to store the information in a SMS -and to encode and decode the message into different PDUs. The text in a message -is accessed using Buffer() method. The CSmsMessage also -supports decoding of partial complete Class 0 SMS.

The CSmsMesasge -class supports the following functionality:

To add hyperlink in -a SMS message using CSmsHyperlinkOperations
To get and set the reply -address path using CSmsReplyAddressOperations
To get, set and remove -special message indicators using CSmsSpecialMessageOperations
To support the voice -mail notifications.
CSmsSMSCCtrlParameterOperations class -provide the clients with methods to manipulate Short Message Service Centre -(SMSC) control information elements. class
To support segmentation -and reassembly in the SMS stack.
To pack and unpack data -from the SMS messages.

The GSMU also provides the segmentation and reassembly store described -in SMS Stack Message -Stores.

+ + + + + +GSM +UtilitiesThis section describes the GSM utility classes and the functionality +they provide in the SMS stack. . +

The GSM utility (GSMU) class provides the functionality specified in the +3GPP standards 23.038 and23.040.

Specialised SMS classes

The GSMU provides a specialised +SMS class called TGsmuLex8. TGsmulex8 provides +methods to decode the PDU data.

PDU element classes

The following classes provide +utility methods to encode and decode different elements of a PDU.

+ + + +GSMU Class +Functionality + + + + +

TSmsOctet

Provides methods to encode and decode the octets of a PDU

+ + +

CSmsAlphabetConverter

Provides methods for character conversion between native type and +user defined type. This class provides the functionality to compliment CSmsBufferSegmenter, TSmsBufferReassembler and TSmsAlphabetPacker.

+ + +

CSmsmAddress

Provides methods to represent the recipient device or the service +centre address.

+ + +

TGsmSmsTypeOfAddress

Provides methods to specify the type of address used. The type of +address includes the details of the numbering plan indicator and the type +of numbering used.

+ + +

TGsmSmsTelNumber

Provides methods to encapsulate basic address information like source +device address, destination address and the service centre address in a SMS +message.

+ + +

TSmsServiceCenterTimeStamp

Provides methods to get and set the service centre time stamp in +a SMS message.

+ + +

TSmsValidityPeriod

Provides methods to get and set the validity period in a PDU.

+ + +

TSmsStatus

Provides methods to get and set the SMS status in the STATUS +REPORT PDU.

+ + +

TSmsParameterIndicator

Provides methods to get and set flags in the reports and COMMAND PDUs. +The flags represent extension, user data, data coding scheme and protocol +identifier.

+ + +

TSmsProtocolIdentifier

Provides methods to get and set the protocol identifier.

+ + +

TSmsCommandType

Provides methods to get and set the type of commands in a COMMAND PDU.

+ + +

CSmsuserData

Provides methods to get and set user data elements from a PDU.

+ + +

CSmsCommandData

Provides methods to get and set various information elements from +a SMS command message.

+ + + +

PDU classes

The following classes provide methods +to create and process the six types of messages DELIVER, SUBMIT, DELIVER +REPORT, SUBMIT REPORT, STATUS REPORT and COMMAND.

+ + + +class +Functionality + + + + +

CSmsPDU

Provides generic interface to encode and decode all six types of +PDUs. CSmsPDU provides the common functionalities to encode +and decode different types of PDUs. For more information about the methods +provided by this class see the reference documentation.

+ + +

CSmsDeliver

Provides the methods to create a DELIVER PDU.

+ + +

CSmsSubmit

Provides methods to create a SUBMIT PDU.

+ + +

CSmsDeliverReport

Provides methods to create a DELIVER REPORT PDU. +A DELIVER REPORT message is created to acknowledge a received SMS.

+ + +

CSmsSubmitReport

Provides methods to process a SUBMIT REPORT message sent by the +network in response to a submit message. The SUBMIT REPORT contains the result +of the SUBMIT message like if the message was submitted successfully, if not +the reason for the failure.

+ + +

CSmsStatusReport

Provides the methods to process the STATUS REPORT message sent by +the network. The message contains the details of the status of a previously +sent SUBMIT message.

+ + +

CSmsCommand

Provides methods to create a COMMAND message. This message is mobile +originated and sent to the network requesting some action like status of sent +message.

+ + + +

Buffer classes

The GSMU provides the utility classes +to store the SMS messages before segmentation and concatenation. CSmsBufferBase is +the base class to create the buffer space in the memory. CSmsBuffer is +used to store an array of TText in the memory. CSmsEditorBuffer class +is used by the messaging server to store the text in CRichText type.

User data settings

TSmsUserDataSettings class +is used to encapsulate the settings such as character concatenation. The stored +settings affect the encoding and decoding of the messages.

CSmsMessage

CSmsMessage class +is used to represent a complete message inside the SMS stack before segmentation +and a complete message after reassembly. If the message type is class 0, incomplete +messages are also stored by the CSmsMesasge. The complete +message is stored in the CSmsBuffer. The main function +of the CSmsMessage is to store the information in a SMS +and to encode and decode the message into different PDUs. The text in a message +is accessed using Buffer() method. The CSmsMessage also +supports decoding of partial complete Class 0 SMS.

The CSmsMesasge +class supports the following functionality:

To add hyperlink in +a SMS message using CSmsHyperlinkOperations
To get and set the reply +address path using CSmsReplyAddressOperations
To get, set and remove +special message indicators using CSmsSpecialMessageOperations
To support the voice +mail notifications.
CSmsSMSCCtrlParameterOperations class +provide the clients with methods to manipulate Short Message Service Centre +(SMSC) control information elements. class
To support segmentation +and reassembly in the SMS stack.
To pack and unpack data +from the SMS messages.

The GSMU also provides the segmentation and reassembly store described +in SMS Stack Message +Stores.

\ No newline at end of file