Siemens TC63 - Manual (Page 404)

TC63 AT Command Set
17.9 AT^SPBG
s
TC63_ATC_V00.490 Page 404 of 501 5/24/05
Confidential / Draft - Do not copy
17.9 AT^SPBG Display phonebook entries in alphabetical order
AT^SPBG
sorts the entries of the current phonebook in alphabetical order by name (the first six characters mat-
ter). The sort order is described in Section 17.1 ,
Sort Order for Phonebooks
.
There are two ways to use
AT^SPBG
:
• If the optional parameter
<RealLocReq>
equals 0 or is omitted the sorted entries will be sequentially num-
bered. As these numbers are not identical with the location numbers stored in the various phonebooks
AT^SPBG
can be used for reading only. For example, it helps you find entries starting with matching charac-
ters. 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>
addi-
tionally 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.
Before using the
AT^SPBG
write command it is recommended to query the number of records currently stored in
the active pohonebook (refer to test command parameter
<used>
). The test command also includes the param-
eters
<nlength>
and
<tlength>
. Note that if SIM storage is selected the length may not be available. If stor-
age does not offer format information, the format list should be empty parenthesises.
Syntax
Parameter Description
First index number in the sorted list where to start reading. The supported range is given in the test command
response.
If <index 1> exceeds the upper bound
<used>
, "+CME ERROR: "invalid index" will be returned.
Last index number in the sorted list where to stop reading. The supported range is given in the test command
response.
If
<index2>
is not given via write command, only the entry located at
<index1>
will be displayed.
If both
<index1>
and
<index2>
are in the range indicated by the test command parameter
<used>
, the list
of entries will be output and terminated with OK.
If
<index2>
exceeds the range indicated by the test command parameter
<used>
, the list of entries will be
output but terminated with a "+CME ERROR: "invalid index".
Test Command
AT^SPBG=?
Response(s)
^SPBG:
(1-
<used>
),
<nlength>
,
<tlength>
OK
ERROR
+CME ERROR
Write Command
AT^SPBG= <index1>
[,
<index2>
][,
<RealLocReq>
]
Response(s)
[^SPBG:
<index1>
,
<number>
,
<type>
,
<text>
[,
<location>
]]
[^SPBG:
<index2>
,
<number>
,
<type>
,
<text>
[,
<location>
]]
OK
ERROR
+CME ERROR
Reference(s) PIN ASC0 ASC1 USB MUX1 MUX2 MUX3 Charge
4
Last
SIEMENS % % % % % % % ! % !
<index1>
(num)
<index2>
(num)