Siemens TC63 manual Atspbg Display phonebook entries in alphabetical order, Atspbg=?

TC63 AT Command Set

17.9 AT^SPBG

s

17.9AT^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

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)

SIEMENS

PIN ASC0 ASC1 USB MUX1 MUX2 MUX3 Charge 4 Last

% % % % % % % ! % !

Parameter Description

<index1>(num)

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.

<index2>(num)

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".

TC63_ATC_V00.490	Page 404 of 501	5/24/05
Confidential / Draft - Do not copy