List message +cmgl (chapter 8) – Multi-Tech Systems CDMA Wireless Modem User Manual

Page 180

Advertising
background image

Chapter 22 - Verizon® Specific AT Commands

Multi-Tech Systems, Inc. CDMA Wireless AT Commands - PN S000294C

180

List Message +CMGL (Chapter 8)

Description: This command allows the application to read stored messages, by indicating the type of the

message to read. The messages are read from the memory selected by the +CPMS
command.


Values:

<index>: Place of storage in memory.
<stat>: Possible values, the status of messages in memory, are as follows:

Possible Values

Status of Messages in Memory

“UREAD”

received unread messages

“READ”

received read messages

“USENT”

stored unsent messages

“SENT”

stored sent messages

“ALL”

all messages


Note:
For SMS Status Reports, only “ALL” and “READ” values of the <stat> parameter will
list messages; other values will only return OK.

<oa/da> : Origination/destination address value in string format. <od/da> will be displayed
only if the message <privacy> value is 0 (Normal).
<fo>: First Octet, coded like SMS-SUBMIT first octet in document [4], default value is 17 for
SMS-SUBMIT
<mr>: Message Reference
<dt>: Discharge Time in string format: “yy/MM/dd,hh :mm :ss±zz” (Year [00-99], Month [01-
12], Day [01-31], Hour, Minute, Second and Time Zone [quarters of an hour] )
<st>: Status of a SMS-STATUS-REPORT
<lang>: Language
<encod>: Encoding
<length> : Length of the text message (in bytes).
<data>: Message text


Syntax:

Command syntax: AT+CMGL=<stat>
Response syntax: +CMGL : <index>,<stat>,<da/oa>,<lang>,
<encod>,<length><CR><LF><data> (for SMS-DELIVER and SMS-SUBMIT, may be
followed by other <CR><LF>+CMGL:<index>…)

+CMGL: <index>,<stat>,<fo>,<mr>,<scts>,<dt>,<st> (for SMS-STATUS-REPORT only, may
be followed by other <CR><LF>+CMGL:<index>…)

Command

Possible Responses

AT+CMGL=“UREAD”
Note: List unread
messages in text mode

+CMGL: 1,”REC
UNREAD”,”8585551212”,1,2,15
<CR><LF>Unread message!
+CMGL: 3,”REC UNREAD”, “8585551212”, 1,2,5<CR><LF>Hello
OK
Another message unread!
Note: 2 messages are unread, these messages will then have their
status changed to “REC READ” (+CSDH:0)

AT+CMGL=”READ”
Note: List read messages
in text mode

+CMGL: 2,”REC READ”,”8585551212”,1,2,9
<CR><LF>
Keep cool
OK

AT+CMGL=”SENT”
Note: List stored and
sent messages in text
mode

OK
Note: No message found

Advertising