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