AT Command Set
MC35_ATC_01_V04.00 Page 202 of 238 02.04.2002
8.29 AT^SPBG Read entry from active telephone book via sorted index
This command sorts the active phonebook records by name, in alphabetica l order. Please note that
the alphabetical order is assigned an index of its own which is not identic al with the location num-
bers used in the various phonebooks.
CAUTION: The AT^SBPG command is intended for reading only. For exam ple, it helps you find en-
tries starting with matching characters. However, do not use the listed index number s to dial out or
modify entries.
Response
^SPBG: (list of used <index>s), <nlength>, <tlength>
OK/ERROR/+CME ERROR
Test command
AT^SPBG=?
Parameter
<index> Total number of entries stored in the active phonebook; displa yed as
a range of serial numbers (1 – n).
<nlength> Max. length of phone number
<tlength> Max. length of the text associated with the phone number
Response
^SPBG: <index1>, <number>, <type>, <text>[<CR><CL>
^SPBG: .....
^SPBG: <index2>, <number>, <type>, <text> ]
OK/ERROR/+CME ERROR
Execute command
AT^SPBG=
<index1>
[, <index2>]
Parameter
<index1> Serial number assigned to the position in the alphabetical l ist where
reading of entries starts
<index2> Serial number assigned to the position in the alphabetical l ist where
reading of entries ends
<number> Phone number
<type> Type of phone number
<text> Text associated with phone number
Reference
Siemens
Note
The AT^SPBG feature is able to sort by the first 6 matching characters onl y. All
the following characters will be ignored.
Example 1. First, run the Test command to find out the range of phonebook entries stored
in the active phonebook:
AT^SPBG=?
TA returns the number of entries in the format: ^SPBG: (1-33),20,17 where 33
is the total number of entries.
2. Now, run the Execute command to display the phoneb ook entries by alpha-
betical order. It is recommended to enter the full range to obtain best resu lts.
AT^SPBG=1,33 TA returns phonebook entries by alphabetical order:
^SPBG: 1,"+999999",145,"Arthur"
^SPBG: 2,"+777777",145,"Bill"
^SPBG: 3,"+888888",145,"Charlie" .........
The numbers at the beginning of each line are not the memory locations in the
phonebook, but only serial numbers assigned to the alphabetical list.