Install Service Action Icon

Install Service Action

Declaration

<AMSERVICEINSTALL EXECUTABLE="text" DISPLAYNAME="text" USERNAME="text" PASSWORD="text" ERROR="text [options]" SERVICETYPE="text [options]" RUNTYPE="text [options]" INTERACTIVE="yes/no">

See Also

Start Service. Stop Service, Pause Service, Resume Service, Remove Service

Description

Installs the specified service into the SCM (Service Control Manager) so that it can be started and stopped. Administrator privileges are usually required to perform this action. Services do not run on Windows 95/98/ME.

Practical Usage

 

Parameters

General Tab

Executable
Text, Required
MARKUP: EXECUTABLE="c:\foldername\servicename.exe"

Specifies the service to resume.

Display Name
Text, Required
MARKUP: DISPLAYNAME="My Service"

Specifies the name of the service as it should appear in the list of services.

Username
Text, Optional - None
MARKUP: EXECUTABLENAME="c:\foldername\servicename.exe"

Specifies the username that service should use to log on. The Service automatically inherits the rights of the user specified in this field.

Password
Text, Optional - None
MARKUP: EXECUTABLENAME="c:\foldername\servicename.exe"

Specifies the password corresponding to the username.

Error Severity
Text [options], Optional
MARKUP: ERROR="critical"

If the service generates an error, specifies how the error should be written to the system event log.

The available options are:

normal: Errors are logged as normal

ignore: Errors are ignored.

critical: Errors are logged as critical.

severe: Errors are logged as severe.

Service Type
Text [options], Optional
MARKUP: SERVICETYPE="shared_process"

If the service generates an error, specifies how the error should be written to the system event log.

The available options are:

own_process: The service runs in it's own process space.

shared_process: The service runs in it a shared process space

kernel_driver: The service is a kernel driver.

file_system: The service is a file_system driver.

Run Type
Text [options], Optional
MARKUP: RUNTYPE="manual"

If the service generates an error, specifies how the error should be written to the system event log.

The available options are:

automatic: The service starts automatically when the system starts.

manual: The service is not automatically started, it must be started manually through the SCM

disabled: The service is disabled.

boot: Driver specific setting.

system: Driver specific setting.

Interactive Service
Text [options], Optional Default - NO
MARKUP: INTERACT="YES"

Specifies that the service should be able to interact with the desktop.

Notes

Standard Error Handling Options
This action also includes the standard "Error Causes" and "On Error" failure handling options/tabs

More on Error Handling Options

Variables and Expressions
All text fields allow the use of expressions by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example

<AMSERVICEINSTALL EXECUTABLE="c:\foldername\myservice" DISPLAYNAME="My Custom Service App" USERNAME="MyUserName" PASSWORD="">