<?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-BA053D6F-5B9C-5F98-B70D-FD2323C58BDF" xml:lang="en"><title>User
to User Signalling Service Tutorial</title><shortdesc>This tutorial descrbes how to use the User to User Signalling (UUS)
service in a call. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>


<context><p>UUS is a supplementary service that allows a subscriber to send
and receive a limited amount of subscriber generated User to User Information
(UUI) to and from another user in association with a call to the user. Three
variants on the UUS service, UUS 1 to 3, may be available. </p> </context>
<steps id="GUID-C8B99561-CA7C-5561-A61C-BF1BAE8D00D4">
<step id="GUID-8E262A82-6702-5E95-AC4C-02B9373FA2EA"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::GetUUSCaps()</apiname></xref> to
get UUS capabilities. </info>
<info>Capabilities are encapsulated in <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::TMobileCallUUSCaps</apiname></xref>. </info>
</step>
<step id="GUID-38BEC34B-E542-5568-BD0E-A4F932022798"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::NotifyUUSCapsChange()</apiname></xref> to
get the notification of any changes in the capabilities. </info>
</step>
<step id="GUID-1D95D4BE-EFDD-5F5A-838D-AC9AEF9CAD22"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::ActivateUUS()</apiname></xref> to
activate a UUS service. </info>
</step>
<step id="GUID-6BC72867-9D4B-5EEF-97F0-8FA0FADB2354"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::SendUUI()</apiname></xref> to
send a UUI message for UUS2 and UUS3 service to the end user. </info>
</step>
<step id="GUID-EA14C543-1D94-54E4-9446-A05A9CC4A483"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::ReceiveUUI()</apiname></xref> to
request the next incoming UUI message from the remote user. </info>
</step>
<step id="GUID-2E562879-961D-5E96-A9F4-129584D66EA6"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::HangupWithUUI()</apiname></xref> to
hang up a call and send a UUS1 data message at the call release. </info>
</step>
<step id="GUID-3795A852-DC44-514B-983A-387F12206ABB"><cmd/>
<info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::AnswerIncomingCallWithUUI()</apiname></xref> to
answer an inbound call and send UUI to the calling party. </info>
</step>
</steps>
<postreq><p>User-To-User Signalling service settings are controlled through
 <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref>.  </p></postreq>
</taskbody><related-links>
<link href="GUID-E2AF923A-D796-5DA9-B678-C6E2ABF7A6CC.dita"><linktext>Call Completion
to Busy Subscriber Tutorial</linktext></link>
</related-links></task>