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