List Message +Cmgl - Multitech MTCBA-C-IP-N12 Reference Manual

List Message +CMGL

This command allows the application to read stored messages, by indicating the type of the message to
Description:
read. The messages are read from the memory selected by the +CPMS
Values: <index>
<stat>
Text Mode Possible Values
"UREAD"
"READ"
"USENT"
"SENT"
"ALL"
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>
<fo>
<mr>
<dt>
<st>
<lang>
<encod>
<length>
<data>
Command syntax: AT+CMGL=<stat>
Syntax:
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
AT+CMGL="UREAD"
Note: List unread messages in text
mode
AT+CMGL="READ"
Note: List read messages in text
mode
AT+CMGL="SENT"
Note: List stored and sent
messages in text mode
For the RUIM software edition using some SIM cards, the maximum supported message text length is 99
Note:
characters. Longer message texts will be truncated to 99 characters.
The maximum message text length for all other software editions is 160 characters.
Multi-Tech Systems, Inc. CDMA Wireless AT Commands (PN S000294J)
Place of storage in memory.
Possible values, the status of messages in memory, are as follows:
Status of Messages in Memory
received unread messages
received read messages
stored unsent messages
stored sent messages
all messages
Origination/destination address value in string format.
First Octet, coded like SMS-SUBMIT first octet in document [4], default value is 17 for SMS-
SUBMIT
Message Reference
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] )
Status of a SMS-STATUS-REPORT
Language
Encoding
Length of the text message (in bytes).
Message text
Possible Responses
+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)
+CMGL: 2,"REC READ","8585551212",1,2,9<CR><LF>
Keep cool
OK
OK
Note: No message found
Chapter 7 – Short Messages Commands
command.
44