<?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 concept

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

<concept id="GUID-F23BB1F1-CF90-597F-8410-34AB8B567501" xml:lang="en"><title>PIM

Subsystem Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-201D8954-325A-422C-94D3-772274154AF9"><title>Purpose</title> <p>This

document describes storage, organisation and utility functionalities within

Symbian platform Personal Information Management (PIM) technology, as defined

by its subsystems: Application Engines and Application Services. </p> </section>

<section id="GUID-78706FAF-6F53-4DFD-B77B-BA44C5E087B2"><title>Key Concepts</title> <p> <i>Application

Engines</i> - provide PIM data storage and manipulation. </p> <p> <i>Application

Services</i> - provide a collection of utility components.</p> <p> Application

Engines and Application Services enable user applications to acquire, organise,

maintain, and retrieve personal information. </p> <p> <i>Subsystem</i> - a

cohesive group of components within a single technology. </p> <p> <i>Component</i> -

the smallest unit of architectural significance and the finest grained unit

of description. </p> </section>

<section id="GUID-A76EE4BC-565F-4F5E-8943-1F9BE03B4D07"><title>Architectural

Relationships</title> <p>PIM <xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita">Application

Services</xref> technology delivers high-level OS services for storage and

manipulation of user data (such as a collection of Calendar and Contacts items).

PIM subsystem components are part of Application Engines and Application Services.

The Symbian platform Generic Middleware layer contains the following PIM components:

Alarm Server, Time Zone Server and Help Model. </p> <p>All the components

are contained between the OS Services layer and the User Interface layer. </p> <p>Key

clients of these components are licensee applications that use subsystems

such as Telephony, SyncML and Messaging. </p> <fig id="GUID-5335C9B9-5C4E-5673-AB93-59C921C3AC58">

<title>PIM Subsystem components are part of the Application Services and Generic

Middleware layers</title>

<image href="GUID-1742B2A1-6EC1-5368-919B-362516A5D452_d0e347864_href.png" placement="inline"/>

</fig> </section>

<section id="GUID-AEA465F8-77B5-45A6-B5A4-12083A9008F4"><title>Application

Engines</title> <p>Application Engines provide data storage and manipulation

for user data. </p><ul>

<li><p><xref href="GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0.dita#GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0/GUID-85D629ED-30D4-5608-A816-07BD375C6A76">Calendar</xref> enables

management of calendar entries and provides access to calendar stores. The

CalInterimAPI library is the Calendar data store. </p></li>

<li><p>The <xref href="GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0.dita#GUID-A1227CAE-EE08-5EAF-8D15-81465467C0C0/GUID-5F20F757-46F6-5652-AB0F-6B22DBB61111">Contacts

model</xref> provides a unified interface for managing contact information. </p></li>

</ul> </section>

<section id="GUID-D6AC13D1-3C9F-44B2-8691-3F4583E7D805"><title>Application

Services</title> <p>Application Services are used by multiple application

engines or applications running on Symbian OS. </p> <ul>

<li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-8BD6CF61-80B6-5869-AB85-F572C590DB30">Alarm

Server</xref> maintains a queue of system-wide alarms. </p></li>

<li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-32519F1C-429A-59C9-B945-D0B1F81A0AA5">Calendar

Conversion</xref> converts dates between Gregorian and Chinese lunar calendar

dates for applications requiring Chinese date support. </p></li>

<li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-6EB921E1-0048-5388-8983-87172763FAB3">Help

model</xref> manages a collection of files that provide context-sensitive

help information. </p></li>

<li><p>Notepad API is a middleware tool that you can write simple text to

and save for future reference. </p>  </li>

<li><p>The Calendar Interim Utils2 is an Organizer API that provides methods

you can use to keep track of your time, extending APIs from Symbian OS. It

displays the individual days of a given time period. You can add notes and

memos to these dates to organize your schedule.</p>  </li>

<li><p>Phonebook APIs provide methods useful in creating a contacts database

and performing various operations on it. These APIs expand on the Contact

model.</p>  </li>

<li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-4268D6AA-F468-5461-88A2-D6852D4AC69A">Time

zone localization</xref> provides localized versions of time zone and city

names. </p></li>

<li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-D30706E5-7191-5349-A883-C200B73AFED1">Time

zone server</xref> allows clients to obtain accurate conversion between any

time expressed in UTC and local time for a user's time zone. </p></li>

<li><p><xref href="GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48.dita#GUID-F43E458D-6650-5BB0-871D-2E4EB1353C48/GUID-9DFB0954-9CDF-5DAF-BA7A-54A1D64833F7">Versit</xref> is

a set of utility classes that support the import and export of data that is

formatted according to a set of standards initially defined by the Versit

consortium. </p></li>

</ul><p>There are no strong relationships between any of the subsystem components.

They are presented as a subsystem because they enable development of a set

of related applications.</p></section>

</conbody></concept>