Article # 108, added by Geoworks, historical record
| first | previous | index | next | last |

Sending SMS messages to certain applications.



An SMS message can be prefixed by the followed character string, in order
to send that SMS message to a particular application:

	//XXXXnnnnn\r

where XXXX  = TokenChars (always exactly 4)
      nnnnn = TokenID (MANUFACTURER_ID_XXXX, assigned to developer by
                       Geoworks)
and the "//" and "\r" are mandatory.

On the Nokia 9000 Communicator, when the on-board Mailbox receives an
SMS message with such a string prefix, it will notify the recipient
application that it has an SMS message waiting for it.

It is important that the application ID (or, GeodeToken, the combination
of the TokenChars and TokenID) actually reference an application that
resides on the phone.  If it doesn't, then when the code is debugged using
the target PC emulator with Swat, the developer will see a crash with
the following "Death due to":

HOW_CAN_APPLICATION_HAVE_NO_NAME?			enum FatalErrors
; Trying to generate notification to the Indicator application on the
; Nokia 9000 platform, but the name of the application that has a message
; isn't known. Since _NO_UNKNOWN_APPS_ALLOWED is defined for this platform,
; it should not be possible for the name to be unknown but there be a
; message.

And _NO_UNKNOWN_APPS_ALLOWED means this:

; _NO_UNKNOWN_APPS_ALLOWED	Don't allow messages to be registered
;				for applications that can't be found
;				at registration time. This is usually
;				turned on when _CONTROL_PANELS is turned
;				off, as without a control panel,
;				messages for unknown apps cannot be
;				deleted.

So if you're developing an application for the Nokia 9000 Communicator
that sends SMS messages directly to an application, DON'T send an SMS
message to an application that may not be there.