StatePictureWidth  StdHeight

Chapter 3: Property Descriptions and Usage

Status

Applies to

SMSMessage objects

Description

After the SMSSession Send function is called, the Status property of the SMSMessage object indicates the current status of the message. You can get the value of this property using the GetMessageStatus function.

The Status property takes a value of the SMSMsgStatus enumerated variable. Values are shown in the following table. When the status indicates that there is a temporary failure, the problem causing the error is not expected to persist.

Enumerated value

Description

Message_Status_Unknown!

Message status is unknown.

Message_Status_ForwardedToSME!

Message successfully forwarded to destination.

Message_Status_ReceivedBySME!

Message successfully received by destination.

Message_Status_ReplacedBySC!

Message successfully replaced in the SMSC.

Message_Status_Reserved_Completed!

Message successfully reserved.

Message_Status_SCSpecific_Completed!

Message is specific to an SMSC and has been successfully delivered.

Message_Status_Congestion!

Temporary failure due to network congestion.

Message_Status_QualityUnavail_Temp!

Temporary failure because quality is not available.

Message_Status_SCSpecific_TmpError!

Temporary failure due to an SMSC-specific error. System still trying to deliver.

Message_Status_Reserved_TmpError!

Temporary failure because the message was reserved.

Message_Status_SMEBusy!

Temporary failure because the destination is busy.

Message_Status_SMEError!

Temporary failure due to an error at destination.

Message_Status_SMENotResponding!

Temporary failure because the destination is not responding.

Message_Status_SVCRejected!

Temporary failure because service was rejected.

Message_Status_Congestion_Trying!

Network congestion. System still trying to deliver.

Message_Status_QualityUnavail_Trying!

Quality is not available. System still trying to deliver.

Message_Status_Reserved_Trying!

Reserved. System still trying to deliver.

Message_Status_SCSpecific_Trying!

SMSC specific. System still trying to deliver.

Message_Status_SMEBusy_Trying!

Destination is busy. System still trying to deliver.

Message_Status_SMEError_Trying!

Destination error. System still trying to deliver.

Message_Status_SMENotResponding_Trying!

Destination not responding. System still trying to deliver.

Message_Status_SVCRejected_Trying!

Service rejected. System still trying to deliver.

Message_Status_ConnectionRejected!

Failure because destination rejected the connection.

Message_Status_DeletedByOrigSME!

Failure because the message was deleted by the originator.

Message_Status_DeletedBySC!

Failure because the message was deleted by Short Message Service Center (SMSC).

Message_Status_IncompatibleDest!

Failure because the destination is incompatible.

Message_Status_NoInternetWorking!

Failure because the internet is not available.

Message_Status_NoLongerExists!

Failure because the message no longer exists.

Message_Status_NotObtainable!

Failure because the destination cannot be attained.

Message_Status_QualityUnavail!

Failure because quality is not available.

Message_Status_RemoteProcError!

Failure due to a remote processor error.

Message_Status_Reserved_Error!

Failure due to a reserved error.

Message_Status_SCSpecific_Error!

Failure due to an SMSC-specific error.

Message_Status_VPExpired!

Failure because the validity period of the message expired.

Usage


In scripts

The Status property takes a value of the SMSMsgStatus enumerated variable. This example uses the GetMessageStatus function to obtain the value and write it to a single line edit box:

SMSMsgStatus msgStat
integer li_ret

g_smsSess.Send(g_smsMsg, g_smsAddr)
sleep(5)
li_ret = g_smsSess.GetMessageStatus(g_smsMsg)
msgStat = g_smsMsg.Status
sle_status.text = "Message status: " + String(msgStat)





Copyright © 2004. Sybase Inc. All rights reserved. StdHeight

View this book as PDF