<?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 OS. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context><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>