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-CF6ED944-6BC6-51FA-9B05-6F799F06B44B" xml:lang="en"><title>Accepting

    13 a Newly-Available Bearer</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>This tutorial explains how to set the mobility policy handler component

    15 to accept a newly-available bearer. </p>

    16 <section><title>Procedure</title> <ol id="GUID-85E5C308-A6FB-5CFF-BB8A-4C1AEDB56B02">

    17 <li id="GUID-99921C20-C4EC-569D-834A-930DD64FB62B"><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-4D78F3E8-67CF-5B60-A359-2DCEDE038CFB"><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-B4476AE6-43CA-5242-B537-E101F3C94F78"><p>Call the <xref href="GUID-93466135-4C80-30B2-85C4-A045A7D34C6E.dita#GUID-93466135-4C80-30B2-85C4-A045A7D34C6E/GUID-511960C1-F9FC-3A25-9E89-977C43510C58"><apiname>CImMobilityManager::AcceptNewCarrier()</apiname></xref> function

    26 on the instance of <xref href="GUID-93466135-4C80-30B2-85C4-A045A7D34C6E.dita"><apiname>CImMobilityManager</apiname></xref> identified in the <xref href="GUID-4D26288F-A8F8-355E-B49C-B313EEC04584.dita"><apiname>PreferredCarrierAvailable()</apiname></xref> function. </p> </li>

    27 <li id="GUID-8645692F-7BFC-559D-8C60-B10FDF88417D"><p>Set the <xref href="GUID-93466135-4C80-30B2-85C4-A045A7D34C6E.dita#GUID-93466135-4C80-30B2-85C4-A045A7D34C6E/GUID-511960C1-F9FC-3A25-9E89-977C43510C58"><apiname>CImMobilityManager::AcceptNewCarrier()</apiname></xref> function

    28 value to any of the following: </p><ul>

    29 <li id="GUID-4894DA93-17E7-5C7B-8A00-82595DD43874"><p> <xref href="GUID-A3F52E3F-BC7F-3586-8529-290F679C1C59.dita"><apiname>KAcceptCompleteCurrent</apiname></xref> to

    30 specify that any operations in progress should be allowed to continue before

    31 migrating. </p><note><xref href="GUID-A3F52E3F-BC7F-3586-8529-290F679C1C59.dita"><apiname>KAcceptCompleteCurrent</apiname></xref> will not cancel

    32 the server communication that is currently in progress. After the operation

    33 is completed, the server MTM completes the user requested operation, logs

    34 out from the remote server, and closes the session allowing the migration

    35 to occur. </note> </li>

    36 <li id="GUID-CD61D419-8D15-578F-B8DF-546F991B91F8"><p> <xref href="GUID-33265245-E8DA-39CF-B627-75BDF59FD644.dita"><apiname>KAcceptStopCurrent</apiname></xref> to

    37 specify that any operations in progress should be stopped before migrating. </p> <note><xref href="GUID-33265245-E8DA-39CF-B627-75BDF59FD644.dita"><apiname>KAcceptStopCurrent</apiname></xref> will

    38 not cancel server communication that is currently in progress. After the operation

    39 is stopped, the server MTM logs out from the remote server, and closes the

    40 session allowing the migration to occur.</note> </li>

    41 <li id="GUID-7F1EBB9C-EFA7-5341-82EB-7B5D3342D5EE"><p> <xref href="GUID-11E0E18B-5656-349B-8F05-8C3E961B7AAF.dita"><apiname>KAcceptImmediately</apiname></xref> to

    42 specify that the migration should be performed immediately. </p><note><xref href="GUID-11E0E18B-5656-349B-8F05-8C3E961B7AAF.dita"><apiname>KAcceptImmediately</apiname></xref> causes

    43 the outstanding server communications to be cancelled, the session with the

    44 remote server is dropped without logging out, and allows the migration to

    45 occur.</note> </li>

    46 </ul> </li>

    47 </ol> </section>

    48 </conbody><related-links>

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

    50  Overview</linktext></link>

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

    52 Policy Plug-in  Overview</linktext></link>

    53 </related-links></concept>