At^spbs Step Through The Selected Phonebook Alphabetically - Multi-Tech MultiModem EDGE Reference Manual

15.11 AT^SPBS Step Through the Selected Phonebook
Alphabetically
AT^SPBS can be used to scroll sequentially through the active phonebook records in
Description:
alphabetical order by name. Three entries will be displayed at a time.
Every time the write command is executed, 3 rows of phonebook records are returned. Each
triplet overlaps with the next one. The actual index depends on parameter <value>. This
parameter determines whether the index will be increased or decreased. If the index in one
output line reaches the last index in the alphabetical list, the next output line will display the first
list entry. After the last record of the phonebook has been reached (see parameter AT^SPBG
<used>), the <internal-counter> switches over to the first.
There are two ways to use AT^SPBS:
• If the optional parameter <RealLocReq> is omitted or (0) the sorted entries will be
sequentially numbered. As these numbers are not identical with the location numbers stored
in the various phonebooks AT^SPBS can be used for reading only. For example, it helps you
find entries starting with matching characters. Do not use the serial numbers to dial out or
modify entries.
•
If parameter <RealLocReq>=1 is given by the write command, the response parameter
<location> additionally appended to each entry indicates the actual location number. This
number can be used for editing with AT+CPBW or dialing with ATD><mem><n>. The first
index number of each entry is only the serial number of the sorted list.
Test Command Syntax:
Response:
Write Command Syntax:
Response:
Parameter Description:
<value>
1 To make a step forward in the alphabetically sorted phonebook.
2 To make a step backward in the alphabetically sorted phonebook.
<index-a>
1...maxindex The index in the sorted list of phonebook entries that identifies the first entry displayed.
The value of <index-a> is determined by the value of the <internalcounter> and by <value>.
After a write command has terminated successfully with "OK", the value from <index-a> is saved
and retained as the new <internalcounter> value.
Note:
<index-b>
1...maxindex The index in the sorted list of phonebook entries that identifies the second entry displayed.
<index-b>= (<index-a>+1).
Note:
<index-c>
1...maxindex The index in the sorted list of phonebook entries that identifies the third entry displayed.
<index-c>= (<index-b>+1).
Note:
<number>
String type phone number in format specified by <type>.
The number parameter may be an empty string.
<type>
Type of address octet that defines the type of number (ton) and the numbering plan identification (npi) used.
Please consider that for types other than 129 or 145 dialing from phonebook with ATD><mem><n> is, depending
on the network, not always possible (refer to GSM 04.08 subclause 10.5.4.7 for details). See <type> of
AT+CPBW. Possible values are:
145 Dialing string <number> includes international access code character '+'
161 National number. Network support of this type is optional.
209 Dialing string <number> has been saved as ASCII string and includes non-digit characters other
than "*", "#" or "+". Note that phonebook entries saved with this type cannot be dialed.
255 Dialing string <number> is a command to control a Supplementary Service; i.e., "*", "#" codes are
contained. Network support of this type is optional.
129 Otherwise
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371G)
AT^SPBS=?
^SPBS: (list of supported <value>)
OK
AT^SPBS=<value>[, <RealLocReq>]
^SPBS: <index-a>, <number>, <type>, <text>[, <location>]
^SPBS: <index-b>, <number>, <type>, <text>[, <location>]
^SPBS: <index-c>, <number>, <type>, <text>[, <location>]
OK
+CME ERROR
After the last record in the phonebook, the first entry follows.
After the last record in the phonebook, the first entry follows.
After the last record in the phonebook, the first entry follows.
Chapter 15 – Phonebook Commands
239