Symbian3/PDK/Source/GUID-05C443D3-C9E5-5A6D-828B-70A50CDB8962.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-05C443D3-C9E5-5A6D-828B-70A50CDB8962.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,329 @@
+<?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>
\ No newline at end of file