Symbian3/PDK/Source/GUID-05C443D3-C9E5-5A6D-828B-70A50CDB8962.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-05C443D3-C9E5-5A6D-828B-70A50CDB8962" xml:lang="en"><title>Proactive
Command Tutorial</title><shortdesc>The proactive command tutorial describes how to use the different
proactive commands in Symbian platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>


<context id="GUID-A2FFF056-183B-4E7C-BBFA-01BFE3B74A3B"><p>The proactive commands are inherited from <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSatPCmdBase</apiname></xref> object.
A proactive command is executed when one the SAT engines have requested for
a notification. TSY responds with an error message in the terminal response,
without a SAT engine request. Developers can start with a reference TSY framework
which implements the Core telephony API or write a new TSY. Add the other
features like Multimode then create a SAT engine. The member functions of
the RSat API are used to implement the SAT engine. </p><p/> </context>
<steps id="GUID-6B8C2618-4261-5531-A355-571FBF9A713F">
<step id="GUID-20E97E60-17C9-54CA-8B9D-239C804D2178"><cmd/>
<info>Create an instance of <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>RPhone</apiname></xref>  </info>
</step>
<step id="GUID-3E39BE2A-C695-52A2-96ED-A890DABC59E4"><cmd/>
<info>Create an instance of <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>RSat</apiname></xref> client </info>
</step>
<step id="GUID-D83F5CDD-990A-57FE-BE60-CF3A0A5E59C1"><cmd/>
<info>Get the features supported by the phone hardware and the TSY by calling <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>GetMeSideSatProfile()</apiname></xref>. </info>
<info>The features are returned to the SAT engine as a profile. </info>
</step>
<step id="GUID-2BF42143-BE44-504F-AD15-784EC24892D7"><cmd/>
<info>Now modify the features supported by the new SAT engine by setting up
the flags in the profile and send the features to the ICC by calling <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>ClientSatProfileIndication()</apiname></xref>. </info>
</step>
<step id="GUID-4A56F2E0-0707-52CB-B353-9C997205FE13"><cmd/>
<info>Request some <xref href="GUID-8D4B8ABF-8ADD-5142-A966-EBD913958B0E.dita">proactive</xref> command
notification messages. The phone polls the TSY for proactive commands. The
TSY notifies the SAT engine when a proactive command requested by the SAT
engine is received. </info>
<info>Some of proactive commands that you can request are: </info>

<substeps id="GUID-14ABFF7F-ABD7-528B-9D5B-03068524188E">
<substep id="GUID-99AFB3F5-B81B-53EC-8D27-FBAE51E83071"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyDisplayTextPCmd()</apiname></xref> to send a request to display
text to the user. </cmd>

<info>TSY completes the request when it receives a display text proactive
command from the ICC. The proactive command information is sent to the SAT
engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TDisplayTextV6</apiname></xref> object and a terminal
response is sent to the ICC. </info>
</substep>
<substep id="GUID-FB573C3A-F00E-5ACB-9221-10A43AF8EB62"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyGetInkeyPCmd()</apiname></xref> to get a single character input
from the user. </cmd>

<info>The TSY completes the request when it receives a get inkey proactive
command from the ICC. The proactive command information is sent to the SAT
engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TGetInkeyV6</apiname></xref> object and a terminal
response is sent to the ICC. </info>
</substep>
<substep id="GUID-00817959-8B4E-53B7-B732-E1B53744F470"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyGetInputPCmd()</apiname></xref> to get a string as an input from
the user. </cmd>

<info>The TSY completes the request when it receives a get input proactive
command from the ICC. The proactive command information is sent to the SAT
engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TGetInputV6</apiname></xref> object and a terminal
response is sent to the ICC. </info>
</substep>
<substep id="GUID-333FD869-571C-5D94-9111-72A77A36EF82"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyPlayTonePCmd</apiname></xref> to request the TSY to play a tone. </cmd>

<info>The TSY completes the request when it receives the play tone proactive
command from the ICC. The proactive command information is sent to the SAT
engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TPlayToneV6</apiname></xref> and a terminal response
is sent to the ICC. </info>
</substep>
<substep id="GUID-D674722E-A409-56F3-95D7-2AFF0EC35A6B"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySetUpMenuPCmd()</apiname></xref> to request the TSY to set up
a menu item. </cmd>

<info>The TSY completes the request when it receives a proactive command from
the ICC. The common menu based commands are: </info>
<info><ul>
<li id="GUID-519C2DD2-63C3-5856-BA58-06935537D70C"><p> <i>set up menu </i>  </p> </li>
<li id="GUID-7A2C04D4-0A3B-5FB7-AE04-D02B21BAE6E8"><p> <i>set up a menu item</i>  </p> </li>
<li id="GUID-5F06759A-AB6D-53DF-A775-BDB0B4C54647"><p> <i>add a menu item</i>  </p> </li>
<li id="GUID-A8DDD5C6-B6DB-54AF-B3E0-3994B6399463"><p> <i>select a menu item</i>  </p> </li>
</ul> </info>

<info>The TSY completes these commands when there are some outstanding requests
from a SAT engine. </info>
</substep>
<substep id="GUID-44F51FB7-3854-5EE3-8862-C1BB42A7A555"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySelectItemPCmd()</apiname></xref> to request the TSY to send
a selected menu item to the ICC. </cmd>

<info>When the TSY completes the request the selected menu item is sent to
the ICC in a terminal response. For more options in using the menu based proactive
commands, see <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>RSat</apiname></xref>. </info>
</substep>
<substep id="GUID-38F62EC5-CC96-502F-9AEF-9032EB56B7C2"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySendSmPCmd()</apiname></xref> to request the TSY to send an SMS. </cmd>

<info>The TSY sends an SMS as soon as it receives a send SM proactive command
from the ICC. The proactive command information is sent to the SAT engine
in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSendSmV6</apiname></xref> object and a terminal response
is sent to the ICC. </info>
</substep>
<substep id="GUID-C3C2E089-0C67-58E5-BDA7-E04327BD9E40"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySendSsPCmd()</apiname></xref> to request for a supplementary
service (SS). </cmd>

<info>The TSY completes the request when it receives a send SS proactive command
from the ICC. The proactive command information is sent to the SAT engine
in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSendSsV6</apiname></xref> and a terminal response is
sent to the ICC. </info>
</substep>
<substep id="GUID-83699709-F5E7-5FC9-A119-1EC80C8596B0"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySendussdPCmd()</apiname></xref> to request the TSY for an Unstructured
service data (USSD). </cmd>

<info>The TSY completes the request when it receives a send USSD proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSendUssdV6</apiname></xref> object and a terminal response is sent
to the ICC. </info>
</substep>
<substep id="GUID-C959789A-0D55-5904-AE86-0609F374151D"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySetUpCallPCmd()</apiname></xref> to request the TSY to set up
a call. </cmd>

<info>The TSY completes the request when it receives a set up call proactive
command from the ICC. The proactive command information is sent to the SAT
engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSetUpCallV6</apiname></xref> object and a terminal
response is sent to the ICC. </info>
</substep>
<substep id="GUID-AA6F3E9A-DB73-559B-ADA9-E06970F8961A"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyRefreshPCmd()</apiname></xref> to get the notification of any
changes in the ICC. </cmd>

<info>The TSY first completes an outstanding <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyRefreshRequired()</apiname></xref> command.
The TSY checks if a refresh is allowed by calling <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyRefreshAllowed()</apiname></xref>.
The list of file identifiers are sent to the SAT engine using a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TRefreshFileList</apiname></xref> and
the proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TRefreshV2</apiname></xref> object.
A terminal response is sent to the ICC. </info>
</substep>
<substep id="GUID-45138CB4-EF93-5E2D-9C53-89F93ECEB80A"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySetUpEventListPCmd()</apiname></xref> to request the TSY to notify
the ICC with the list of events occurring in the phone. </cmd>

<info>The TSY completes the request when it receives a setup event list proactive
command. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSetUpEventListV1</apiname></xref> object
and a terminal response is sent to the ICC. </info>
</substep>
<substep id="GUID-38641DCF-3605-5E96-9A66-2829FBCE1B07"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySetUpIdleModePCmd()</apiname></xref> to request the TSY to display
a text or an icon when the phone is idle. </cmd>

<info>The TSY completes the request when it receives a setup idle mode text
proactive command from the ICC. The proactive command information is sent
to the SAT engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSetUpIdleModeTextV6</apiname></xref> object
and a terminal response is sent to the ICC. </info>
</substep>
<substep id="GUID-AE713C92-85B2-5CCB-B696-372B3A459371"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySendDtmfPCmd()</apiname></xref> to request the TSY to send a
DTMF string. </cmd>

<info>The TSY completes the request when it receives a send DTMF proactive
command from the ICC. The proactive command information is sent to the SAT
engine in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSendDtmfV6</apiname></xref> object and a terminal
response is sent to the ICC. </info>
</substep>
<substep id="GUID-A22645A7-ED96-5F37-A457-18EA723E359D"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySendApduPCmd()</apiname></xref> to request the TSY to perform
a card APDU. </cmd>

<info>The TSY completes the request when it receives a perform card APDU proactive
command from the ICC. The SAT engine must perform the a card APDU in the card
specified by the ICC. The APDU command and the destination ID of the specific
card is sent to the TSY in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TPerformCardApduV2</apiname></xref> object
and a terminal response is sent to the ICC. </info>
</substep>
<substep id="GUID-638CF4CE-41F0-528A-8059-88E2145F3D14"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyPowerOffCardPCmd()</apiname></xref> to request the TSY to close
a specific session with a card. </cmd>

<info>The TSY completes the request when it receives a power off proactive
command from the ICC. The SAT engine must close the session with a card specified
by the ICC. The destination ID of the specific card is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TPowerOffCardV2</apiname></xref> object and a terminal response is
sent to the ICC. </info>
</substep>
<substep id="GUID-A94B36F2-EFF4-57F9-AF97-16CC1DC322CB"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyPowerOnCardPCmd()</apiname></xref> to request the TSY to open
a session with a new card. </cmd>

<info>The TSY completes the request when it receives a power on card proactive
command from the ICC. The SAT engine must open a session with the card specified
by the ICC. The destination ID of the specific card is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TPowerOnCardV2</apiname></xref> object and a terminal response is sent
to the ICC. If the card is already switched on then a reset is applied. It
is recommended to power the card only for the necessary duration for an efficient
use of the battery. </info>
</substep>
<substep id="GUID-8ECC2919-6369-5137-8A28-6711BDB4F096"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyGetReaderStatusPCmd()</apiname></xref> to request the TSY to
get the status of a card reader. </cmd>

<info>The TSY completes the request when it receives a get card reader proactive
command from the ICC. The SAT engine scans all the cards, if the requested
mode is card reader status it sends the status using a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TGetCardReaderStatusV2</apiname></xref>.
If the requested mode is card reader identifier then the identifier of the
card is returned by the SAT engine. When the request is complete a terminal
response is sent to the ICC. </info>
</substep>
<substep id="GUID-8A1BECB9-0D61-54B4-9C2E-264108101AD6"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyRunAtCommandPCmd()</apiname></xref> to request the TSY to run
an AT command. </cmd>

<info>The TSY completes the request when it receives a run AT proactive command
from the ICC. The AT commands are specified in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TRunAtCommandV6</apiname></xref> object.
SAT engine must pass the AT command to the phone. When completed the result
is returned in a terminal response. </info>
</substep>
<substep id="GUID-2583B732-54B5-5B25-97BE-1F2ADA94A0C6"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyLanguageNotificationPCmd()</apiname></xref> to send the text
language issued by the ICC. </cmd>

<info>The TSY completes the request when it receives a language notification
proactive command from the ICC. The proactive command information is sent
in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TLanguageNotificationV2</apiname></xref> object. The
SAT engine must use the language specified by the ICC. A terminal response
is then sent to the ICC. </info>
</substep>
<substep id="GUID-CA1CE0C0-626D-5776-AC32-DA41B5077AB0"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyLaunchBrowserPCmd()</apiname></xref> to request to launch a browser
and open a specific URL. </cmd>

<info>The TSY completes the request when it receives a launch browser proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TLaunchBrowserV6</apiname></xref> object. The SAT engine must execute
the command and try to connect to the specified URL. The SAT engine get the
confirmation from the user about the session. The user selects to use the
existing session or to terminate the browser. A terminal response is then
sent to the ICC. </info>
</substep>
<substep id="GUID-C679ED78-06F9-5778-8E87-460948F3119E"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyOpenChannelPCmd()</apiname></xref> to request the TSY to open
a specific channel. </cmd>

<info>The TSY completes the request when it receives an open channel proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TOpenChannelBaseV2</apiname></xref> object. The SAT engine can request
the TSY to open a specific type of channel such as GPRS. The SAT engine must
notify the user about the new channel with an alpha identifier or an icon.
A terminal response is sent to the ICC. </info>
<info>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TOpenCsChannelV6</apiname></xref> for packet switching
network, <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TOpenGprsChannelV6</apiname></xref> for GPRS, and <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TOpenLocalLinksChannelV6</apiname></xref> for Bluetooth or IRDA connections. </info>
</substep>
<substep id="GUID-587DE55E-4DBE-512F-AB52-C96E015AFE05"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyCloseChannelPCmd()</apiname></xref> to request the TSY to close
a specific channel. </cmd>

<info>The TSY completes the request when it receives a close channel proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TCloseChannelV6</apiname></xref> object. The SAT engine must terminate
the channel and notify the user. A terminal response is then sent to the ICC. </info>
</substep>
<substep id="GUID-917B9AED-F828-59CE-9105-95D22B1E3877"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyReceiveDataPCmd()</apiname></xref> to request the TSY to get
the data from a channel. </cmd>

<info>The TSY completes the request when it receives a receive data proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TReceivedataV6</apiname></xref> object. The SAT engine must read the
data from the buffer and send it to the ICC. If sufficient amount of data
is not received, the ICC requests for more data from the SAT engine. The SAT
engine must notify the user about the data received with an alpha identifier
or an icon. A terminal response is then sent to the ICC. </info>
</substep>
<substep id="GUID-48A562E4-40D6-5E57-8DDB-7BD93672D337"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifySendDataPCmd()</apiname></xref> to request the TSY to send data
in an open channel. </cmd>

<info>The TSY completes the request when it receives a send data proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSendDataV6</apiname></xref> object. The SAT engine must read the data
from the ICC and store it in the transmission (Tx) buffer or send the data
immediately when ICC issues a <codeph>Send Immediate</codeph> in the send
data command. A terminal response is then sent to the ICC. </info>
</substep>
<substep id="GUID-114423FB-2B69-525B-846C-08368A8A9B37"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyGetChannelStatusPCmd()</apiname></xref> to request the TSY to
get the status of an open channel. </cmd>

<info>The TSY completes the request when it receives a get channel status
proactive command from the ICC. The proactive command information is sent
in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TGetChannelStatusV2</apiname></xref> object and a terminal
response is then sent to the ICC. </info>
</substep>
<substep id="GUID-0B44E7D5-AA7A-583F-9753-7148B0841B5D"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyServiceSearchPCmd()</apiname></xref> to request the TSY to search
for a service. </cmd>

<info>The TSY completes the request when it receives a search service proactive
command from the ICC. The proactive commands information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TSearchServiceV6</apiname></xref> object and a terminal response is
sent to the ICC. </info>
</substep>
<substep id="GUID-4DD808A3-0F7E-588C-AF85-67458E02E8A7"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyGetServiceInfoPCmd()</apiname></xref> to request the TSY to get
information about a service. </cmd>

<info>The TSY completes the request when it receives a get service info proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TGetServiceInfoV6</apiname></xref> object and a terminal response is
sent to the ICC. </info>
</substep>
<substep id="GUID-EEFDB8B3-5361-51E1-AA76-E0944C20A355"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyDeclareServicePCmd()</apiname></xref> to request the TSY to declare
a service. </cmd>

<info>The TSY completes the request when it receives a declare service proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TDeclareServiceV2</apiname></xref> object and a terminal response is
sent to the ICC. </info>
</substep>
<substep id="GUID-25C37156-8470-5E8B-B474-E418490F9582"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyTimerMgmtPCmd()</apiname></xref> to request the TSY to start,
stop or get the values of timers. </cmd>

<info>The TSY completes the request when it receives a timer management proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TTimerMgmtV3</apiname></xref> object and a terminal response is sent
to the ICC. </info>
</substep>
<substep id="GUID-F5CABB1B-A1E0-5B81-B43A-E14675915451"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyLocalInfoPCmd()</apiname></xref> to request the TSY to send the
local information to the ICC. </cmd>

<info>The TSY completes the request when it receives a provide local information
proactive command from the ICC. The proactive command information is sent
in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TLocalInfoV6</apiname></xref> object and a terminal response
is sent to the ICC. </info>
</substep>
<substep id="GUID-9036635C-EA48-523E-B3D5-76D89A7A2580"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyPollingIntervalPCmd()</apiname></xref> to instruct the phone
about the polling frequency required by the ICC. </cmd>

<info>The TSY completes the request when it receives a polling interval proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TPollingIntervalV3</apiname></xref> object and a terminal response
is sent to the ICC. </info>
</substep>
<substep id="GUID-F5C918B0-C9F7-5469-B288-2B36645B6741"><cmd>Use <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>NotifyPollingOffPCmd</apiname></xref> to instruct the phone to stop
polling the ICC. </cmd>

<info>The TSY completes the request when it receives a polling off proactive
command from the ICC. The proactive command information is sent in a <xref href="GUID-10B2C9F7-ABBF-33E8-8B89-6D170E21293C.dita"><apiname>TPollingOffV3</apiname></xref> object and a terminal response is sent
to the ICC. </info>
</substep>
</substeps>
</step>
<step id="GUID-B31053FB-FE51-5146-B5C1-7570EB84D426"><cmd/>
<info>A feedback to each proactive command is sent to the TSY using a terminal
response. The TSY analyses the result and the additional information present
in the response and then sends a terminal response to the ICC. </info>
</step>
</steps>
</taskbody></task>