--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-215528EA-E12E-590A-9C17-394F36F2C268.dita	Tue Jul 20 12:00:49 2010 +0100
@@ -0,0 +1,35 @@
+<?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 xml:lang="en" id="GUID-215528EA-E12E-590A-9C17-394F36F2C268"><title>Data Compatibility</title><prolog><metadata><keywords/></metadata></prolog><conbody><section id="GUID-73C845B7-DB6F-5298-90AF-952639947140"><title>Database File Format</title> <p>The database file format is unchanged from previous versions of the Contacts Model. </p> </section> <section id="GUID-05D5048D-9524-5F6E-8303-14DEBCF6D43C"><title>Database Files Stored on Removable Media</title> <p>Databases stored on removable media using a device with the previous version of the Contacts Model are not accessible by a device using the new version of the Contacts Model. Similarly, databases stored on removable media using devices with the new version of the Contacts Model are not accessible by a device using the previous version. </p> </section> <section id="GUID-216963ED-C45E-58CF-BF96-3AF2DA252F8A"><title>Database Restore</title> <p>Databases restored from a backup made using a device with the previous version of the Contacts Model are not accessible by a device using the new version of the Contacts Model. Similarly, databases restored from a backup using a device with the new version of the Contacts Model are not accessible by a device using the previous version. </p> </section> <section id="GUID-AB126CBE-4399-5F1D-8117-C651BE3943AE"><title>Database File Locations</title> <p>The previous version of the Contacts Model stored database files in the secure DBMS directory: </p> <p> <i>c:\private\100012a5\DBS_100065FF_</i> <i>&lt;dbname&gt;.cdb</i>  </p> <p>This directory is no longer used since the new Contacts Model does not use the secure DBMS directory. The new version of the Contacts Model stores database files in: </p> <p> <i>c:\private\10003a73\&lt;dbname&gt;.cdb</i>  </p> </section> <section id="GUID-EFEB0C77-1256-5FCC-9913-C55715034D24"><title>Backup Registration Files</title> <p>Backup registration files remain in the <i>C:\private\10003a73</i> directory. </p> <p>In the previous version of the Contacts Model there was one pre-created file for backup/restore of the initialisation file and contacts databases: </p> <codeblock id="GUID-C24C1FA1-5058-5BAA-AC5C-14FA2A041EE5" xml:space="preserve">&lt;?xml version="1.0" standalone="yes"?&gt;
+
+&lt;!--
+    Copyright (c) Symbian Software Ltd 2004-2005. All Rights Reserved
+--&gt;
+
+&lt;backup_registration&gt;
+ &lt;passive_backup base_backup_only="yes"&gt;
+  &lt;include_file name = "cntmodel.ini"/&gt;
+ &lt;/passive_backup&gt;
+ &lt;dbms_backup database="contacts.cdb" policy="100065FF"/&gt;
+&lt;/backup_registration&gt;</codeblock> <p>A separate backup registration file was created at run time for each additional contacts database, for example: </p> <codeblock id="GUID-FC6E03FD-0CED-56AA-BA3C-44B8E667BD5F" xml:space="preserve">&lt;backup_registration&gt;
+ &lt;dbms_backup database="anotherdb.cdb" policy="100065FF"/&gt;
+&lt;/backup_registration&gt;</codeblock> <p>In the new Contacts Model there is a separate file automatically generated for each data file (initialisation file and each contacts database, including the default database). </p> <p>For example, the backup registration file (<i>backup_registration_CntModel_ini.xml</i>) for the initialisation file would have the following contents: </p> <codeblock id="GUID-8129FCD8-91A4-5C22-87D6-0F8A7E5AF91F" xml:space="preserve">&lt;?xml version="1.0" standalone="yes"?&gt;
+&lt;backup_registration&gt;
+ &lt;passive_backup base_backup_only="yes"&gt;
+  &lt;include_file name="CntModel.ini"/&gt;
+ &lt;/passive_backup&gt;
+&lt;/backup_registration&gt;</codeblock> <p>The backup registration file (<i>backup_registration_default_cdb.xml</i>) for the default database <i>default.cdb</i> would have the following contents: </p> <codeblock id="GUID-45E0868D-5E42-5077-84B4-C08D28CC436C" xml:space="preserve">&lt;?xml version="1.0" standalone="yes"?&gt;
+&lt;backup_registration&gt;
+    &lt;passive_backup base_backup_only="yes"&gt; 
+  &lt;include_file      name="default.cdb"/&gt; 
+ &lt;/passive_backup&gt;
+&lt;/backup_registration&gt;</codeblock> <p>Note that there is no reference to DBMS in the new file since we do not use the secure DBMS directory in the new Contacts Model. </p> </section> </conbody></concept>
\ No newline at end of file