COM+ Application Component Type

A component of this type represents a COM+ application. COM+ applications are treated as a unit. The settings and content are installed as a group.

Browsing for a COM+ Application

When you browse for a COM+ application, the browser provides an alphabetical list of COM+ applications on the target system.

You can select a single COM+ application to be checked in. COM+ applications have no children and cannot be expanded..

Exported/Internal File Format

COM+ applications are exported into a Microsoft Windows Installer (MSI) file using the COM+ Admin SDK.

Component Differences

The COM+ Application is re-exported on the target system as an MSI file and compared against the MSI file used to install the application. The software will only indicate that there were differences, but will not indicate the details of the differences.

Installing a COM+ Application

• If a COM+ application with the same name is already installed on the target system and running as a service, the existing application is stopped along with any running dependent services. The COM+ application will then be deleted from the COM+ catalog.

• The new COM+ application is installed using the COM+ Admin SDK.

• To start the COM+ application the user will have to use the startApp call step to manually start the COM+ application.

Uninstalling a COM+ Application

The COM+ application is uninstalled using the COM+ Admin SDK.

Error Conditions

Table 3–1 COM+ Application Error Conditions

Action	Condition	Result
Install	COM+ Application already exists with the same name and either cannot be stopped or dependent services cannot be stopped.	Installation fails
Uninstall	MSI file used for installation is no longer available	Uninstallion fails
Install or Uninstall	Remote Agent does not have administrator privileges	Installation or Uninstallation fails

Extended Control Procedures

Table 3–2 COM+ Application Extended Control Procedures

Name	Parameters	Description
startApp	appName – Full name of the COM+ application.	Starts the COM+ application if it is run as a service
stopApp	appName – Fill name of the COM+ application to stop.	Stops the COM+ application and all dependent services
stopRouter	N/A	Stops the COM+ Routing services
startRouter	N/A	Starts the COM+ Routing services
installAsUser	rsrcSrcPath – Name of the COM+ application rsrcInstallPath – Path to the *.msi file representing the application userID – User who is going to run the application password – Password of the user	Enables installation of a COM+ application that runs as a particular user