<?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-45E0760E-84CB-53DB-9D13-43829500C216" xml:lang="en"><title>Alternative

Line Settings Tutorial</title><shortdesc>This tutorial describes how to get and set the alternative line

settings using <codeph>RMobilePhone</codeph> functions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-59FCCF7F-5E8F-4D7C-9FED-E47AB90A7DFC"><p>The Alternate Line Service (ALS) provides a subscriber with two

voice lines, that is the primary and auxiliary lines. The phones that support

ALS allow clients to get and set ALS settings irrespective of the current

mode or network. ALS is a GSM-specific service available only on DCS 1800

networks. The ALS setting operates when the mobile station is registered to

a DCS 1800 network. At other times, the primary voice line is used. </p> <p>When

ALS is available, the user can have separate supplementary service profiles

for the voice and auxiliary voice services. Incoming calls are received on

either lines irrespective of the line selection. Outgoing calls are made on

the selected line. </p> </context>

<steps-unordered>

<step id="GUID-7BBBA32D-0322-5EB1-A8FC-28567D4DD93B"><cmd>Get the current

setting using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::GetALSLine()</apiname></xref>. </cmd>

<info>ALS settings are described in the <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneALSLine</apiname></xref> enum. </info>

</step>

<step id="GUID-19EF6977-FB4D-5EC9-8C75-664C101C1CDB"><cmd>Set a voice line

as the active line for outgoing voice calls using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::SetALSLine()</apiname></xref>  </cmd>

</step>

<step id="GUID-0B28B20B-2E5A-50D0-8A46-0F372CB02CF8"><cmd>Use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyALSLineChange()</apiname></xref> to

get the notification of any changes in the selected ALS line. </cmd>

</step>

</steps-unordered>

<example><title>Alternative line settings example</title> <p>The following

code gets the current ALS settings, and checks if the ALS is available. </p> <p>The

code assumes <codeph>iMobilePhone</codeph> is an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> object. </p> <codeblock id="GUID-6E39D503-4CC6-5FF2-8930-29F17121F2B7" xml:space="preserve">RMobilePhone::TMobilePhoneALSLine ALSLine;

User::LeaveIfError(iMobilePhone.GetALSLine(ALSLine));

if (ALSLine != RMobilePhone::EAlternateLineNotAvailable)

    {

        //do something

    }

</codeblock> </example>

</taskbody></task>