Symbian3/SDK/Source/GUID-0E0D4E95-470F-54BE-8DCB-719976C8B84C.dita
changeset 0 89d6a7a84779
equal deleted inserted replaced
-1:000000000000 0:89d6a7a84779
       
     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-0E0D4E95-470F-54BE-8DCB-719976C8B84C" xml:lang="en"><title>What
       
    13 is Contention Management?</title><shortdesc>This topic describes contention management and the contention management
       
    14 process flow. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    15 <p>When a contention issue arises the Access Point priorities of the incoming
       
    16 connection and the existing connections are compared. If the incoming Access
       
    17 Point has a higher priority than an existing Access Point the existing Access
       
    18 Point connection is stopped and the new Access Point connection is started.
       
    19 If the incoming Access Point priority is lower than or equal to an existing
       
    20 Access Point connection the incoming Access Point is ignored. </p>
       
    21 <section><title>Contention Management Process Flow</title> <p>This section
       
    22 outlines the contention management process flow and the associate components. </p> <p>The
       
    23 following diagram describes the Contention Management Process Flow. </p><p>The following steps describe what happens when a PDP context contention issue
       
    24 occurs in the system: </p> <ol>
       
    25 <li id="GUID-F614DD0D-491E-4E4A-B255-90A50B0CAB8E"><p>The PDP Meta-Connection Provider (MCPR) of the starting connection
       
    26 calls the <codeph>HandleContentionL</codeph> function of the PDP Tier Manager.</p></li>
       
    27 <li id="GUID-E77116E5-E364-47CF-9878-502DD869804A"><p>The PDP Tier Manager has an <codeph>iPDPContentionManagement</codeph> instance
       
    28 of the <codeph>CPDPContentionManagement</codeph> class. The contention request
       
    29 is added to <codeph>iPDPContentionManagement</codeph>. </p></li>
       
    30 <li id="GUID-8DAF207F-3320-4DF4-A69E-9824DA800D12"><p>The ContentionManager starts processing the asynchronous contention
       
    31 request. The priorities assigned to all active connections in the system are
       
    32 extracted from the MCPR Access Points. The ContentionManager delivers the
       
    33 extracted priorities to the Contention Management Activity. </p></li>
       
    34 <li id="GUID-D1DD47FC-F6EA-4F00-A684-FE67DC02AE26"><p>The existing connection priorities are compared with the new connection
       
    35 priority and one of the following occurs:</p></li>
       
    36 <li id="GUID-0254D697-B9B0-4D24-8262-BB94C3294016"><p>If the priority of the new connection is lower than those of the existing
       
    37 connection, the new connection is not permitted.</p></li>
       
    38 <li id="GUID-D1A41F47-9CFA-4755-BA82-DC05E6F100A7"><p>If the priority of the new connection is higher than one of the existing
       
    39 connections, the lowest priority connection is stopped and the new connection
       
    40 is permitted and started.</p></li>
       
    41 <li id="GUID-E4E8C34B-5305-46B3-AB17-F1CEB6BC741F"><p>Each connection relates to a single application on the mobile device.
       
    42 One of the following occurs when the connection and application is terminated: </p></li>
       
    43 <li id="GUID-54B99BA1-16C3-45FC-8400-C37F354B651A"><p>If the application that uses the stopped connection is contention-aware
       
    44 it calls <codeph>RConnection::Start()</codeph> with the <codeph>TConnAutStartPref</codeph> parameter.
       
    45 The application starts when the contention is finished.</p></li>
       
    46 <li id="GUID-BD9CF0F3-D080-42AE-BA18-537E8DA9AD35"><p>If the application that uses the stopped connection is not contention-aware
       
    47 a disconnection notification is sent to the user without an error message
       
    48 stating why the connection stopped. </p></li>
       
    49 </ol></section>
       
    50 </conbody><related-links>
       
    51 <link href="GUID-CD57B3EB-B8FD-53CE-B319-FB6275BE391E.dita"><linktext>What is Contention?</linktext>
       
    52 </link>
       
    53 <link href="GUID-FF81C5C5-09B7-5194-928E-0BA87417B2CD.dita"><linktext>What are
       
    54 Access Point                 Priorities?</linktext></link>
       
    55 </related-links></concept>