Specifications
Chapter 7 – Short Messages Commands
Multi-Tech Systems, Inc. CDMA AT Commands Reference Guide (PN S000294K) 43
Read Message +CMGR
Description: This command allows the application to read stored messages. The messages are read from the memory
selected by +CPMS command. A message read with status “REC UNREAD” will be updated in memory with
the status “REC READ”.
Values: <stat> Status of message in memory. <stat> parameter for SMS Status Reports is always “READ”.
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.
<mr>: Message Reference
<scts>: Service Center Time Stamp in string format : “yy/MM/dd,hh :mm :ss±zz”
(Year/Month/Day,Hour:Min:Seconds±TimeZone)
<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 (network specific)
<encod> Encoding (network specific)
<priority> Message priority:
0 Normal
1 Interactive
2 Urgent
3 Emergency
<cbn> Call Back Number
<length> Length of the text message (in bytes).
<data> Message text
Syntax: Command syntax: AT+CMGR=<index>
Response syntax: +CMGR: <stat> [,<oa>], <scts>, <lang>, <encod>, <priority>[,<cbn>], <length>
<CR><LF> <data> (for SMS-DELIVER only)
+CMGR: <stat> [,<da>], <dt>, <lang>, <encod>, <priority>[,<cbn>], <length> <CR><LF> <data> (for SMS-
SUBMIT only)
+CMGR: <stat>,<mr>,<scts>,<dt>,<st> (for SMS-STATUS-REPORT only)
Command Possible Responses
+CMTI: “MT”,1 Note: New message received
AT+CMGR=1
Note: Read the message
+CMGR: “REC UNREAD”,”8585551212”, ”98/10/01,18 :22
:11+00”,1,2,0,”8585550000”,9<CR><LF>
ABCdefGHI
OK
AT+CMGR=1
Note: Read the message again
+CMGR: “REC READ”,”8585551212”, ”98/10/01,18 :22
:11”,1,2,0,”8585550000”,9<CR><LF>
ABCdefGHI
OK Note: Message is read now
AT+CMGR=2
Note: Read at a wrong index
+CMS ERROR: 321
Note: Error : invalid index
AT+CPMS=”SR”;+CNMI=,,,2
Reset to text mode, set read memory to
“SR”, and allow storage of further SMS
Status Report into “SR” memory
+CPMS:0,10,0,10
OK
AT+CMSS=3
Send an SMS previously stored
+CMSS: 160
OK
+CDSI: “SR”,1
New SMS Status Report stored in “SR” memory at index 1
AT+CMGR=1
Read the SMS Status Report
+CMGR: “READ”,160,
“8585551212”,129,”01/05/31,15:15:09”,
“01/05/31,15:15:09”,0
OK
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.