1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-DD276E82-B190-56CD-9A4A-ADE586E5EE92" xml:lang="en"><title>Notifying

    13 the Availability of a Preferred Bearer</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>This tutorial explains how the mobility policy plug-in component can receive

    15 notification about the availability of a preferred bearer. </p>

    16 <section><title>Procedure</title> <ol id="GUID-94A3CD5B-DA13-5A0B-82A8-A12A21BDF6F7">

    17 <li id="GUID-6D62C570-C424-5052-9D4F-7AAC046851CF"><p>Derive a class from

    18 the <xref href="GUID-D3ED20A6-A16E-368E-98AD-820A469613EE.dita"><apiname>CImMobilityPolicyPlugin</apiname></xref> class. </p> </li>

    19 <li id="GUID-FDEFAED0-7092-51ED-915F-3C56F3F7EA6E"><p>Implement the <xref href="GUID-65871401-3D98-3B2B-9AA2-C7DB43F9AF57.dita"><apiname>PreferredCarrierAvailable</apiname></xref> and <xref href="GUID-B145C26A-4765-31DA-8514-C4F0659FA71B.dita"><apiname>MigrationComplete</apiname></xref> functions in the derived <xref href="GUID-D3ED20A6-A16E-368E-98AD-820A469613EE.dita"><apiname>CImMobilityPolicyPlugin</apiname></xref> class

    20 to get the required behaviour when a new bearer is available. </p> <p>When

    21 a new bearer is available, the Network bearer mobility framework calls the <xref href="GUID-9A3979A9-F882-3053-B5B1-E0E125774271.dita#GUID-9A3979A9-F882-3053-B5B1-E0E125774271/GUID-E4D234C3-AEEA-3FE9-8E5D-6914BB60B174"><apiname>MMobilityProtocolResp::PreferredCarrierAvailable</apiname></xref> function

    22 to notify the bearer mobility policy manager. This happens only if the bearer

    23 mobility policy manager is registered with the <xref href="GUID-65871401-3D98-3B2B-9AA2-C7DB43F9AF57.dita"><apiname>PreferredCarrierAvailable</apiname></xref> (Network

    24 bearer mobility framework) for bearer mobility notification. </p> </li>

    25 <li id="GUID-74EB9BE1-3BCC-55C5-981B-44EE2BE9EDCF"><p>In the <xref href="GUID-65871401-3D98-3B2B-9AA2-C7DB43F9AF57.dita"><apiname>PreferredCarrierAvailable</apiname></xref> function,

    26 set the policy decision and call either of the following functions: </p> <ol id="GUID-AB15B27B-F7A0-5F2F-A192-CE797A75818B">

    27 <li id="GUID-4870EE3C-351E-5BF6-9828-B0A95000409E"><p> <xref href="GUID-73ABAC20-D43E-31B3-A6CB-95572D3140D2.dita#GUID-73ABAC20-D43E-31B3-A6CB-95572D3140D2/GUID-DA2BD69C-7780-3C06-9B3D-BA356298D050"><apiname>MImMobilityPolicyHandler::AcceptNewCarrier()</apiname></xref> </p> </li>

    28 <li id="GUID-85ACB6BF-A609-58D6-B062-8750FC7D0223"><p> <xref href="GUID-73ABAC20-D43E-31B3-A6CB-95572D3140D2.dita#GUID-73ABAC20-D43E-31B3-A6CB-95572D3140D2/GUID-74842903-9B5B-33F9-A519-4DD7E16F1D1D"><apiname>MImMobilityPolicyHandler::IgnoreNewCarrier()</apiname></xref> </p> </li>

    29 </ol> </li>

    30 </ol> </section>

    31 </conbody><related-links>

    32 <link href="GUID-24860917-0FE2-5C8F-B436-96928350996E.dita"><linktext>Bearer Mobility

    33 Overview</linktext></link>

    34 <link href="GUID-93221B70-EB36-5E8E-AE23-700988D5DACB.dita"><linktext>Bearer Mobility

    35 Policy Plug-in</linktext></link>

    36 </related-links></concept>