<?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-70202CC9-BC49-539A-8255-4B0B9C24A702"><title> After Market Application Starter Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>AMA (After Market Application) Starter is a Symbian platform component that manages the launch of AMCs (After Market Components), such as applications and services, at phone boot time. </p> <section><title>Purpose</title> <p>The main purpose of AMA Starter is to launch AMCs at phone boot time based on the items in a Dynamic Startup Configuration (DSC). A DSC corresponds to a list of items stored in a DSC database. Each item represents an AMC to be launched when the phone is switched on. A DSC can contain zero or more components. </p> <p>The components are launched and monitored (if configured, using <xref href="GUID-70DA7D35-3EF3-5B9B-9E86-28893021A4A1.dita">System Health Manager</xref>) when the DSC list is processed by the <xref href="GUID-788BD091-186A-5E25-B058-952C7629A8D4.dita">System State Manager</xref>. </p> <p> <b>Note:</b> DSCs enable the phone boot procedure to be extended after the ROM image has been built. A DSC can include applications installed before or after the ROM is built. </p> </section> <section><title>Required background</title> <p>To use AMA Starter, familiarity with <xref href="GUID-788BD091-186A-5E25-B058-952C7629A8D4.dita">System State Manager</xref> and <xref href="GUID-DF3E24A4-8E97-5E26-8C24-5033A0716B5A.dita">System State Management Architecture</xref> is recommended. </p> </section> <section><title>Architecture</title> <p>The AMA Starter component is loaded as a DLL and is run by the System State Manager (SSM) component at phone boot time. The launching of AMCs at phone boot time by the AMA Starter component is triggered by the SSM component. Firstly, the EStart component loads the SSM component. Secondly, the SSM passes the DSC defined in the Static Command Lists (SCLs) or policy plug-ins to the AMA Starter component. Thirdly, AMA Starter loads the DSC that results in the launching of the AMCs at phone boot time. </p> <p> <b>Note:</b> Optionally, AMCs can be launched and monitored by the System Health Management component. </p> <p>The following figure illustrates the interactions between AMA Starter and other Symbian platform components: </p> <fig id="GUID-8C583C79-8457-553E-AAA3-B7F92D1BBEBB"><title>

             Interaction of AMA Starter and Symbian platform components 

          </title> <image href="GUID-45580F91-F1E2-5F6F-9449-5C7B5009EC44_d0e176562_href.png" placement="inline"/></fig> </section> <section><title>APIs</title> <table id="GUID-00024226-5A3C-5AE2-9C9D-2BBEDA9909FD"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry>API</entry> <entry>Description</entry> </row> </thead> <tbody><row><entry><p> <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita"><apiname>RDscStore</apiname></xref>  </p> </entry> <entry><p>Provides the client interface for managing the DSC database. </p> </entry> </row> <row><entry><p> <xref href="GUID-54F2480A-07A1-3FA1-920D-5F1D3469C40B.dita"><apiname>CDscItem</apiname></xref>  </p> </entry> <entry><p>Contains application/process information required by the AMA Starter to launch an AMA. </p> </entry> </row> </tbody> </tgroup> </table> </section> <section><title>Typical uses</title> <p>Device creators can use the AMA Starter APIs to manage items in the DSC database. Once a connection has been established with the DSC database, device creators can perform the following tasks: </p> <ul><li id="GUID-E5FEF5A8-7EF2-54B4-9FB3-EB7EDAA45136"><p>Add an AMC to the start-up list by adding an item to a DSC using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-11BA9684-72EF-329F-B94B-223515E1133A"><apiname>RDscStore::AddItemL()</apiname></xref>. </p> </li> <li id="GUID-16B9C3A4-1432-5C39-8260-1CFE31B1614B"><p>Modify the start-up behavior of an AMC by modifying the associated item in the DSC using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-9BB82550-B622-3777-BC4B-6966D4EC6995"><apiname>RDscStore::UpdateItemL()</apiname></xref>. </p> </li> <li id="GUID-1E2B5B1F-DAF0-512A-9449-717119927440"><p>Remove an AMC from the start-up list by removing the associated item from the DSC using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-F2A782F7-B0C4-308D-A9EF-64FB5BE41FF7"><apiname>RDscStore::DeleteItemL()</apiname></xref>. </p> </li> <li id="GUID-34606C2C-5BFB-5B18-95A2-E03EBF2ACAC4"><p>Add or remove a DSC from the DSC database using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-03E5738C-6D3B-3A59-A627-ED655566E552"><apiname>RDscStore::CreateDscL()</apiname></xref> or <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-88278C76-7BAE-38A0-8FEF-C61E6C901D21"><apiname>RDscStore::DeleteDscL()</apiname></xref>. </p> </li> </ul> <p>For more information on how to perform these tasks, see the <xref href="GUID-C1BEF313-ED22-5904-9648-740D069331ED.dita">After Market Application Starter Tutorial</xref> section. </p> </section> </conbody></concept>