After Market Application Starter Overview

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.

Purpose

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.

The components are launched and monitored (if configured, using System Health Manager) when the DSC list is processed by the System State Manager.

Note: 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.

Required background

To use AMA Starter, familiarity with System State Manager and System State Management Architecture is recommended.

Architecture

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.

Note: Optionally, AMCs can be launched and monitored by the System Health Management component.

The following figure illustrates the interactions between AMA Starter and other Symbian platform components:

Figure 1. Interaction of AMA Starter and Symbian platform components

APIs

API Description

RDscStore

Provides the client interface for managing the DSC database.

CDscItem

Contains application/process information required by the AMA Starter to launch an AMA.

Typical uses

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:

For more information on how to perform these tasks, see the After Market Application Starter Tutorial section.