Chapter 7 – Short Messages Commands
Multi-Tech Systems, Inc. CDMA Wireless AT Commands (PN S000294J)
44
List Message +CMGL
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:
Text Mode 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.
<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
Note:
For the RUIM software edition using some SIM cards, the maximum supported message text length is 99
characters. Longer message texts will be truncated to 99 characters.
The maximum message text length for all other software editions is 160 characters.