<?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 xml:lang="en" id="GUID-A7F7912B-2E82-5F4F-B4F0-5EE97D884960"><title>Packet Context Tutorial </title><shortdesc>This tutorial describes how to define a context for the packet service sub-session. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <steps id="GUID-337E9E55-3D59-5EB4-A569-2456E97AC60B"> <step id="GUID-E8B21200-E078-53A3-AE5E-994AE8AF2A49"><cmd/><info>To create a context do one of the following: </info> <substeps id="GUID-3D25C15D-1F30-520A-8692-98A5C1BC75F6"><substep id="GUID-1F19E2CE-4FD6-57A2-8DAF-C94B9F8239F6"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::OpenNewContext()</apiname></xref> to open a new context. </info> </substep> <substep id="GUID-914AE066-30AF-5508-8A30-E899274A59B5"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::OpenExistingContext()</apiname></xref> to open an existing context. </info> </substep> </substeps> </step> <step id="GUID-401668B9-E59E-53C1-8869-07CF16F8E65A"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::SetConfig()</apiname></xref> to set the parameters for a context. </info> <info>The context parameters are defined in : </info> <substeps id="GUID-44055DA6-6106-5F88-9E4E-004DDEFE1967"><substep id="GUID-FC4DE6E1-2A35-535F-8830-E4E5B01DDF43"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfigR99_R4</apiname></xref>  </info> </substep> <substep id="GUID-553A34A2-3887-5B3D-960A-54383901314F"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfig_R5 </apiname></xref>  </info> </substep> <substep id="GUID-6A936E02-F9D4-5E2F-989F-CEEC62710024"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfigGPRS </apiname></xref>  </info> </substep> <substep id="GUID-286E3550-D0F6-52C0-9B19-3C133E7999E5"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> TContextConfigCDMA </apiname></xref>  </info> </substep> <substep id="GUID-60B6835D-BDE3-5909-A892-8C08907D7746"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TProtocolType </apiname></xref>  </info> </substep> <substep id="GUID-572D2B80-1865-552C-8FB8-EE0949DC7EC3"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TGSNAddress </apiname></xref>  </info> </substep> <substep id="GUID-3AE25471-96D3-5C05-A909-8528199A6CBB"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TProtocolAddress </apiname></xref>  </info> </substep> <substep id="GUID-6CD12278-2FCE-571D-ADE9-8121A8816B59"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TProtocolConfigBufferV2</apiname></xref>  </info> </substep> <substep id="GUID-B284B3AF-FBC6-5803-8DC1-657EF7998D3B"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TMiscProtocolBuffer</apiname></xref>  </info> </substep> <substep id="GUID-82531441-0548-5A7F-84F6-CD84049A092B"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TDnsInfoV2</apiname></xref>  </info> </substep> <substep id="GUID-975E2C17-BFCA-51A2-94D3-0FC6965DA807"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TAnonymousAccess</apiname></xref>  </info> </substep> <substep id="GUID-4550C342-1824-5E51-B1AC-5B2E11B96B7B"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TPacketFlowIndicator</apiname></xref>  </info> </substep> </substeps> <info>The MBMS parameters are defined in: </info> <substeps id="GUID-4217B963-1A8A-5F3C-974A-2725FD9A71E9"><substep id="GUID-B635B5C2-4743-5F94-A89F-D94D3C2B4FF5"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketMbmsContext::TContextConfigMbmsV1()</apiname></xref> </info> </substep> <substep id="GUID-DF75FF63-039C-5AA1-A4C2-78F6CB02747C"><cmd/><info> <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TMbmsServicePriority</apiname></xref>  </info> </substep> </substeps> </step> <step id="GUID-DAA6F9AF-A76B-5C9A-A39F-9771FDD80486"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetConfig()</apiname></xref> to retrieve the information about a context. </info> </step> <step id="GUID-255ECCFF-C618-505E-B30A-F6BDA8415200"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::NotifyConfigChanged()</apiname></xref> to get the notification of any changes to the current context parameters. </info> </step> <step id="GUID-08E08678-6942-55F2-AFDD-D1889C405DA5"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Activate()</apiname></xref> to activate a context </info> </step> <step id="GUID-81076BC7-A225-58F8-8619-644E75F5D8FA"><cmd/><info>Initialise the context with <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::InitialiseContext()</apiname></xref>. </info> </step> <step id="GUID-679709BC-2ED2-5438-B689-1AB38185DC4E"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Deactivate()</apiname></xref> to deactivate a context. </info> </step> <step id="GUID-87018D99-C775-5088-9139-EA5610DCB001"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Delete()</apiname></xref> to delete a context. </info> </step> <step id="GUID-076FFE9C-3531-5AEA-9F2A-616774947B58"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetStatus()</apiname></xref> to retrieve the status of the current contexts. </info> <info>The context statuses of a context are defined in <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>TContextStatus</apiname></xref> enumeration. </info> </step> <step id="GUID-7B9232BB-A7A1-5437-8EEF-F99DBE1B35BB"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::NotifyStatusChange()</apiname></xref> to get the notification of any changes to the status of a context. </info> </step> <step id="GUID-72B0CB6E-9D32-56D7-8962-02A73A6D688E"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetProfileName()</apiname></xref> to retrieve the quality of service profile used by a context. </info> </step> <step id="GUID-9BFD3D51-C298-57B1-BC86-186CC3DA7F62"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetDataVolumeTransferred()</apiname></xref> to retrieve the information related to the data sent in the packet service using a context. </info> </step> <step id="GUID-71A0943C-653A-5260-BB6F-4425BF699EDD"><cmd/><info>Use<xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname> RPacketContext::NotifyDataTransferred()</apiname></xref> to receive the notification about the change in the amount of data transferred. </info> </step> <step id="GUID-67E14757-4770-52C6-978B-038992904E13"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::NotifyConnectionSpeedChange()</apiname></xref> to retrieve the information about the connection speed of a packet service sub-session. </info> </step> <step id="GUID-CD5CC472-A521-54D5-BA41-35427C43EB78"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::GetLastErrorCause()</apiname></xref> to retrieve the last error that occurred on a packet service sub-session. </info> </step> <step id="GUID-8E4D3AD9-FE00-53FD-93F6-E82EC0559B21"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::ModifyActiveContext()</apiname></xref> to change the active context. </info> </step> <step id="GUID-CD166619-036B-5AAF-A155-77F2EF45A6DE"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RTelSubSessionBase::CancelAsyncRequest()</apiname></xref> to cancel any of the above commands. </info> </step> <step id="GUID-9E8BED78-8CF2-5BAF-89CB-301E01673AE7"><cmd/><info>Use <xref href="GUID-1CD9122E-B077-39FD-8CAE-45A6AF8F345F.dita"><apiname>RPacketContext::Close()</apiname></xref> to close the handle to a context. </info> </step> </steps> </taskbody><related-links><link href="GUID-76D2CDCA-DD7C-56D4-A913-6A959686B8D5.dita"><linktext>MBMS Context Tutorial</linktext> </link> </related-links></task>